文档首页/ISDP/API参考/API接口/基础数据管理/按层级(下一层)查询位置信息（API名称：findPagedAddress）
更新时间：2025-02-11 GMT+08:00
查看PDF
分享

按层级(下一层)查询位置信息（API名称：findPagedAddress）

功能介绍

按层级(下一层)查询位置信息。

相关接口

接口名称

调用说明

获取Token

调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/address/findPagedAddress

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

是

无

Authorization

bearer ${access_token}

是

bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数

类型

是否必填

描述

parentId

Long

否

父节点ID。第一层级数据的parentId为-1。

address

String

否

行政区域名称。

addressCode

String

否

行政区域编码。

addressIds

List<Long>

否

位置ID集合（精确查询，集合数量最多200）

addressCodes

List<String>

否

位置编码集合（精确查询，集合数量最多200）

page.start

int

是

起始点，从0开始。

page.count

int

是

每页查询数量，最多支持200条。

响应参数

参数

类型

描述

status

String

处理结果。

msg

String

错误信息。

data

Object

返回结果。

data参数说明

参数

类型

描述

pos

Integer

当前页数据起始下标

totalCount

Integer

总记录数

data

Object

当前页数据集合，具体字段说明见下

data.data参数

参数

类型

描述

addressId

Long

位置ID

addressCode

String

位置编码

address

String

位置名称

detailedAddress

String

位置详细地址

parentId

Long

父级位置ID

addressPath

String

位置层级路径（父层）

addressLevel

Integer

当前位置层级

description

String

描述

coordinateType

String

定位系统类型

longitude

String

经度

latitude

String

纬度

coordinate

String

坐标位置

udfExtend1

String

扩展属性1

udfExtend2

String

扩展属性2

udfExtend3

String

扩展属性3

udfExtend4

String

扩展属性4

udfExtend5

Date

扩展属性5

udfExtend6

Date

扩展属性6

udfExtend7

String

扩展属性7

udfExtend8

String

扩展属性8

udfExtend9

String

扩展属性9

udfExtend10

String

扩展属性10

hasSubNode

boolean

是否有子层级

请求示例

{
    "parentId": null,
    "address": null,
    "addressCode": null,
    "addressIds": [],
    "addressCodes": [
        "hzjTest1"
    ],
    "page": {
        "start": 0,
        "count": 20
    }
}

响应示例

{
    "status": "success",
    "msg": null,
    "data": {
        "data": [
            {
                "appName": "pub-server",
                "entityName": "Address",
                "lastUpdateDate": "2024-09-20T14:24:04.000+08:00",
                "lastUpdatedBy": 5005466,
                "creationDate": "2024-09-20T10:24:24.000+08:00",
                "createdBy": 5005466,
                "deleteFlag": 0,
                "tenantId": 5000034,
                "description": "描述一下",
                "parentId": 5026528,
                "addressPath": "5026256.5026275.5026528",
                "addressLevel": 4,
                "address": "hzjTest1",
                "addressCode": "hzjTest1",
                "addressId": 5913544,
                "longitude": "114.114449",
                "latitude": "22.604495",
                "coordinate": "",
                "coordinateType": "GPS",
                "detailedAddress": "深圳东站 ? 广东省深圳市龙岗区布吉街道吉华路94号",
                "udfExtend2": "udf2",
                "udfExtend3": "udf3",
                "udfExtend4": "udf4",
                "udfExtend5": "2024-09-20T00:00:00.000+08:00",
                "udfExtend6": "2024-09-21T00:00:00.000+08:00",
                "udfExtend1": "udf1",
                "udfExtend7": "udf7",
                "udfExtend8": "udf8",
                "udfExtend9": "udf9",
                "udfExtend10": "udf10",
                "geoHash": "ws10sep8",
                "hasSubNode": false
            }
        ],
        "pos": 0,
        "total_count": 1,
        "entityName": null,
        "totalCount": 1
    },
    "success": true,
    "failed": false
}
父主题：基础数据管理

相关文档