# 获取地址行政编码

# 接口说明

通过该接口可获取地址行政编码信息,最多获取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-街道