# 获取地址行政编码
# 接口说明
通过该接口可获取地址行政编码信息,最多获取4级地址的行政编码。
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/basics/addresscode/get?access_token=xxxxxxxxx
# 请求参数说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
addr_code | number | 否 | 地址行政编码,不填或者填0时,获取全国的省级行政编码 |
# 请求参数示例
{
"addr_code":0
}
# 返回参数说明
参数 | 类型 | 描述 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
addrs_msg | Object<AddrMsg> | 本行政编码地址信息,结构体详情请参考AddrMsg |
next_level_addrs | Array<AddrMsg> | 下一级所有地址信息 |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok",
"addrs_msg": {
"name": "中华人民共和国",
"code": 0,
"level": 0
},
"next_level_addrs": [
{
"name": "澳门特别行政区",
"code": 820000000,
"level": 1
},
{
"name": "香港特别行政区",
"code": 810000000,
"level": 1
},
{
"name": "宁夏回族自治区",
"code": 640000000,
"level": 1
},
{
"name": "青海省",
"code": 630000000,
"level": 1
},
{
"name": "甘肃省",
"code": 620000000,
"level": 1
},
{
"name": "贵州省",
"code": 520000000,
"level": 1
},
{
"name": "西藏自治区",
"code": 540000000,
"level": 1
},
{
"name": "四川省",
"code": 510000000,
"level": 1
},
{
"name": "江苏省",
"code": 320000000,
"level": 1
},
{
"name": "河南省",
"code": 410000000,
"level": 1
},
{
"name": "台湾省",
"code": 710000000,
"level": 1
},
{
"name": "辽宁省",
"code": 210000000,
"level": 1
},
{
"name": "上海市",
"code": 310000000,
"level": 1
},
{
"name": "福建省",
"code": 350000000,
"level": 1
},
{
"name": "黑龙江省",
"code": 230000000,
"level": 1
},
{
"name": "湖北省",
"code": 420000000,
"level": 1
},
{
"name": "新疆维吾尔自治区",
"code": 650000000,
"level": 1
},
{
"name": "陕西省",
"code": 610000000,
"level": 1
},
{
"name": "吉林省",
"code": 220000000,
"level": 1
},
{
"name": "河北省",
"code": 130000000,
"level": 1
},
{
"name": "天津市",
"code": 120000000,
"level": 1
},
{
"name": "北京市",
"code": 110000000,
"level": 1
},
{
"name": "浙江省",
"code": 330000000,
"level": 1
},
{
"name": "重庆市",
"code": 500000000,
"level": 1
},
{
"name": "江西省",
"code": 360000000,
"level": 1
},
{
"name": "安徽省",
"code": 340000000,
"level": 1
},
{
"name": "山东省",
"code": 370000000,
"level": 1
},
{
"name": "湖南省",
"code": 430000000,
"level": 1
},
{
"name": "云南省",
"code": 530000000,
"level": 1
},
{
"name": "内蒙古自治区",
"code": 150000000,
"level": 1
},
{
"name": "山西省",
"code": 140000000,
"level": 1
},
{
"name": "广东省",
"code": 440000000,
"level": 1
},
{
"name": "广西壮族自治区",
"code": 450000000,
"level": 1
},
{
"name": "海南省",
"code": 460000000,
"level": 1
}
]
}
# 错误码
错误码 | 错误描述 |
---|---|
公共错误码 | - |
10021402 | 无效的地址编码 |
# 结构体
# AddrMsg
本行政编码地址信息
参数 | 类型 | 描述 |
---|---|---|
name | string | 地址名称 |
code | number | 地址行政编码 |
level | number | 地址级别 1-省级 2-市级 3-区县级 4-街道 |