WeMap Services / 开发指南 / 行政区划查询

概述

该服务提供中国标准行政区划数据，接口分为3个：
1.List接口：查询全国行政区划列表
2.Getchildren接口：查询子级行政区划的相关信息，同时支持返回轮廓数据
3.Search接口：查询单个行政区划的相关信息，同时支持返回轮廓数据

服务地址

请求方式：GET请求

List接口： 域名/IP地址+/ws/place/v1/list
Getchildren接口：域名/IP地址+/ws/district/v1/getchildren
Search接口：域名/IP地址+/ws/district/v1/search

请求参数

参数 必填 说明 示例
list接口参数：
无需任何参数
getchildren接口参数: 获取指定行政区划的子级行政区划
id 否 父级行政区划ID，缺省时则返回最顶级行政区划 id=110000
get_polygon 否 定义：获取轮廓数据
取值：
取值1：返回轮廓面点串数据，仅支持对单个行政区划代码的轮廓面点串查询；
取值0：默认值，不返回轮廓面点串数据。		 get_polygon=1
search接口参数：根据关键词检索行政区划
keyword 是 定义：检索关键词
说明：
1.支持输入一个文本关键词
2.支持多个行政区划代码，英文逗号分隔		 keyword=北京
keyword=130681, 419001
get_polygon 否 定义：获取轮廓数据，支持三级行政区划的轮廓数据返回，最小到区县。
取值：
取值1：返回轮廓面点串数据，仅支持对单个行政区划代码的轮廓面点串查询；
取值0：默认值，不返回轮廓面点串数据。		 get_polygon=1
通用参数：
output 否 返回格式：支持JSON/JSONP，默认JSON output=json
callback 否 JSONP方式回调函数 callback=function1

响应结果

名称 类型 必填 说明
status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明
message string 是 状态说明
data_version number 是 行政区划数据版本，便于您判断更新
result array 是 结果数组，第0项，代表一级行政区划，第1项代表二级行政区划，以此类推；使用getchildren接口时，仅为指定父级行政区划的子级
id number 是 行政区划唯一标识（adcode）
level number 是 几级行政区划
name string 是 简称，如“内蒙古”
fullname string 是 全称，如“内蒙古自治区”
location string 是 经纬度
lat number 是 纬度
lng number 是 经度
pinyin array 否 行政区划拼音，每一下标为一个字的全拼，如：
[“nei”,“meng”,“gu”]
cidx array 否 子级行政区划在下级数组中的下标位置
polygon array 否 轮廓面点串数据

行政区划代码（adcode）规则说明

代码共6位，前两位代表省（一级）、中间两位为市/地区（二级），最后两位为区县（三级）
 1）省级：前两位有值，后4位置0，如，河北省：130000
 2）市/地区：前4四位有值，包含省代码与市代码，最后两位置0，如河北省保定市：130600
 3）区县：6位全有值，包含前4位省市代码及区县代码，河北省保定市涿州市：130681
 4）直辖市、香港、澳门：
      同省级，在行政区划接口（ws/district/v1/list）中，其下直接为区级（没有二级结构填充）
      例：北京,东城区 （而非：“北京,北京,东城区”）
 5）直辖县：第3、4位为90的，为省直辖县
 6）中国范围内，省市区行政区划以外的区域值为999999（如中国东海）

如何获取城市编码（city_code）：
1）编码前4位不为0，第5、6位为0的，为常规城市，可直接取用
2）北京、上海、重庆、天津、香港、澳门，编码和省一致，需要单独提出
3）第3、4位为90的为省直辖县，一般当做城市来应用，也需要单独提出

调用示例

域名/IP地址+/ws/district/v1/list
域名/IP地址+/ws/district/v1/getchildren?id=110000
域名/IP地址+/ws/district/v1/search?&keyword=香格里拉

响应示例

{
    "status": 0,
    "message": "query ok",
    "data_version":"20171212",
    "result": [
        [
            {
                "id": "110101",
                "fullname": "东城区",
                "location": {
                    "lat": "39.928353",
                    "lng": "116.416357"
                }
            },
            {
                "id": "110102",
                "fullname": "西城区",
                "location": {
                    "lat": "39.912289",
                    "lng": "116.365868"
                }
            },
            {
                "id": "110105",
                "fullname": "朝阳区",
                "location": {
                    "lat": "39.921470",
                    "lng": "116.443108"
                }
            },
           //以下省略
        ]
    ]

行政区划编码表下载

点击下载行政区划编码表（更新于2022年1月18日）