# 按层级(下一层)查询位置信息（API名称：findPagedAddress）
#### 功能介绍
按层级(下一层)查询位置信息。
#### 相关接口
| 接口名称                                                                 | 调用说明                                                         |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的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
}
```