四级地址解析
# 四级地址解析
最后更新时间: 2022 年 04 月 08 日
# 功能介绍
根据输入的地址文本，解析行政区划四级+详细地址。
# 调用方式
内容数据以 HTTPS 的传输方式（支持 post 或 get 方式），返回值为标准化的 json，并且请求的 URL 和返回值都是以 UTF-8 编码。
# 请求地址
| 请求方式 | URL 地址 |
|---|---|
| HTTPS | https://mapapi.jd.com/addressTrans/getJDDistrict |
# 请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appKey | String | Y | 请联系商务 (400-056-5605) |
| provinceName | String | N | 省名称 |
| cityName | String | N | 市名称 |
| districtName | String | N | 全地址信息 |
| appKey | String | Y | 区/县名称 |
| townName | String | N | 乡镇名称 |
| detailAddress | String | N | 详细地址 |
| fullAddress | String | Y | 全地址，注：如果 fullAddress 中带有省市区县信息，上面的区县可不填 |
| parsingType | Num | Y | 2：解析国标四级 |
| Lat | Double | N | 纬度（优先经纬度结果），注：如需经纬度解析，该项必填，地址信息可不填 |
| lng | Double | N | 经度（优先经纬度结果），注：如需经纬度解析，该项必填，地址信息可不填 |
请求示例
[
“appkey”,
{
“fulladdress”:”江苏省宿迁市宿迁中学”,
“parsingType”:2
}
]
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| status | Num | 状态码 |
| message | String | 状态码说明 |
| requestId | String | 请求流水号 |
| result | Object | 响应结果 |
| provinceName | String | 省名称 |
| provinceCode | Num | 省行政编码 |
| cityName | String | 市名称 |
| cityCode | Num | 市行政编码 |
| districtName | String | 区县名称 |
| districtCode | Num | 区县行政编码 |
| townName | String | 乡镇街道名称 |
| townCode | Num | 乡镇街道行政编码 |
响应示例：
{
“message”:”国标围栏成功”
“requestId”:”a00590e3d7b84308b2f1a77b73addf0a”,
“result”:{
“cityCode”:32130,
“cityName”:”宿迁市”,
“conflictLevel”:-1,
“districtCode”:321302,
“districtName”:”宿城区”,
“provinceCode”:320000,
“provinceName”:”江苏省”,
“townCode”:321302100,
“townName”:“双庄镇”
},
“status”:200
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
返回状态码：
| 状态码 | 状态 |
|---|---|
| 200 | 成功 |
| 400 | 失败 |
| 450 | 输入参数有问题 |
| 404 | 解析失败 |
| 500 | 服务端异常 |
| 504 | 省市区有一级不一致 |