京东地址解析（4 级）jd-address

调用京东地址智能识别接口，将自然语言地址解析为「省/市/区/镇」四级行政区划，并返回每级对应的京东 ID。比传统三级行政区划接口多一个「镇」级别。

1. 基本信息

接口地址	`https://v1.apizero.cn/api/jd-address`
请求方法	`POST`
分类	geo
提供方	极数本源
计费模式	免费试用
单次消耗	0 积分
起步价	—
QPS 限制	5 req/s
每日免费额度	100 次（已认证用户）
匿名每日额度	0 次（无 API Key）
VIP 免费	否
调用次数

2. 认证

需要登录 API Key（避免被滥用刷京东接口）。

获取 API Key：登录 https://apizero.cn/account/keys

3. 请求参数

参数名	类型	必填	说明	示例
`address`	`string`	是	地址文本（≤200 字符）	`北京市朝阳区三里屯街道工体北路 8 号`

4. 请求头

Header	类型	必填	说明	示例
`Authorization`	`string`	是	—	—
`Content-Type`	`string`	是	—	—

5. 请求示例 (cURL)

curl -X POST "https://v1.apizero.cn/api/jd-address" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "address": "北京市朝阳区三里屯街道工体北路 8 号"
}'

6. 响应字段

字段	类型	说明	示例
`province_id`	`number`	省 ID（京东体系）	—
`province`	`string`	省名	—
`city_id`	`number`	市 ID	—
`city`	`string`	市名	—
`county_id`	`number`	区 ID	—
`county`	`string`	区名	—
`town_id`	`number`	镇 ID	—
`town`	`string`	镇名	—
`detail`	`string`	剩余详细地址	—

7. 响应示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "province_id": 1,
        "province": "北京",
        "city_id": 72,
        "city": "北京市",
        "county_id": 2818,
        "county": "朝阳区",
        "town_id": 53124,
        "town": "三里屯街道",
        "detail": "工体北路 8 号"
    }
}

8. 错误码

code	status	说明
`4000`	`—`	address 为空或超长
`4000`	`—`	地址解析失败（地址过于模糊或不规范）
`5020`	`—`	京东接口失败

9. 变更日志

1.0.0(2026-05-07)
- 首次上线 · 4 级行政区划解析