概述

        本接口提供中国标准行政区划数据,可用于生成城市列表控件等功能时使用。

获取省市区列表

本接口用于获取全部省市区三级行政区划

请求地址:

http://apis.map.qq.com/ws/district/v1/list // get请求

请求参数:

参数 必填 说明 示例
output 返回格式:支持JSON/JSONP,默认JSON output=json
callback JSONP方式回调函数 callback=function1
key 开发密钥(Key) key=OB4BZ-D4W3U-*

响应结果: 见下文


获取下级行政区划

获取指定行政区划的子级行政区划

请求地址:

http://apis.map.qq.com/ws/district/v1/getchildren // get请求

请求参数:

参数 必填 说明 示例
id 父级行政区划ID(adcode),
缺省时返回一级行政区划,也就是省级
id=110000
get_polygon 返回行政区划轮廓点串(经纬度点串),
0 默认,不返回轮廓
1 包含海域,3公里抽稀粒度
2 纯陆地行政区划,可通过max_offset设置返回轮廓的抽稀级别
get_polygon=2
max_offset 轮廓点串的抽稀精度(仅对get_polygon=2时支持),
单位米,可选值:
100 :100米(当缺省id返回省级区划时,将按500米返回,其它级别正常生效)
500 :500米
1000:1000米
3000:3000米
max_offset=1000
output 返回格式:支持JSON/JSONP,默认JSON output=json
callback JSONP方式回调函数 callback=function1
key 开发密钥(Key) key=OB4BZ-D4W3U-*

响应结果: 见下文

行政区划搜索

根据关键词或行政区划代码搜索

请求地址:

http://apis.map.qq.com/ws/district/v1/search // get请求

请求参数:

参数 必填 说明 示例
keyword 搜索关键词:
1.支持输入一个文本关键词
2.支持多个行政区划代码(adcode),英文逗号分隔
keyword=北京
keyword=130681
get_polygon 返回行政区划轮廓点串(经纬度点串),
注:本参数仅在keyword为adcode时生效
0 默认,不返回轮廓
1 包含海域,3公里抽稀粒度
2 纯陆地行政区划,可通过max_offset设置返回轮廓的抽稀级别
get_polygon=2
max_offset 轮廓点串的抽稀精度(仅对get_polygon=2时支持),
单位米,可选值:
100 :100米
500 :500米
1000:1000米
3000:3000米
max_offset=1000
output 返回格式:支持JSON/JSONP,默认JSON output=json
callback JSONP方式回调函数 callback=function1
key 开发密钥(Key) key=OB4BZ-D4W3U-*

响应结果

名称 类型 必填 说明
status number 状态码,0为正常,其它为异常(可关注message信息)
message string 状态说明
data_version number 行政区划数据版本,便于您判断更新
result[] array 结果数组
其下数组项 array 第0项,代表一级行政区划,第1项代表二级行政区划,以此类推;使用getChildren接口时,仅为指定父级行政区划的子级区划
id string 行政区划唯一标识(adcode)
name string 简称,如“内蒙古”
fullname string 全称,如“内蒙古自治区”
location object 经纬度
lat number 纬度
lng number 经度
pinyin array 行政区划拼音,每一下标为一个字的全拼,如:
[“nei”,“meng”,“gu”]
cidx array 子级行政区划在下级数组中的下标位置
polygon array 该行政区划的轮廓经纬度点串(当使用get_polygon=1或2时返回),数组每一项为一个多边形,一个行政区划可以由多块多边形组成
其下数组项 array 每个数组为一个轮廓多边形点串(经纬度),格式为:
[坐标1经度,坐标1纬度,坐标2经度,坐标2纬度…]

行政区划代码(adcode)规则说明

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


调用示例

// GET请求,注意参数值要进行URL编码
// list接口:获取全部行政区划数据
https://apis.map.qq.com/ws/district/v1/list?key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77

// getchildren接口:获取北京市的子级行政区划
https://apis.map.qq.com/ws/district/v1/getchildren?id=110000&key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77

// search接口:搜索关键词为香格里拉的行政区划
https://apis.map.qq.com/ws/district/v1/search?&keyword=香格里拉&key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77

{
    "status": 0,
    "message": "query ok",
    "data_version":"20200301",
    "result": [
        [
            {
                "id": "110101",
                "fullname": "东城区",
                "location": {
                    "lat": "39.928353",
                    "lng": "116.416357"
                },
               "polygon": [ //行政区划轮廓点串,search及getchildren接口加get_polygon=1/2时返回
                   [116.809403,39.61482,116.790175,39.610555,116.780286,39.593196....],
                   //其它项省略(若有)...
                ]
            },
            {
                "id": "110102",
                "fullname": "西城区",
                "location": {
                    "lat": "39.912289",
                    "lng": "116.365868"
                },
               "polygon": [ //行政区划轮廓点串,search及getchildren接口加get_polygon=1/2时返回
                   [116.478298,39.550134,116.476457,39.539085,116.442606,39.529289,....],
                   //其它项省略(若有)...
                ]
            },
            {
                "id": "110105",
                "fullname": "朝阳区",
                "location": {
                    "lat": "39.921470",
                    "lng": "116.443108"
                },
               "polygon": [ //行政区划轮廓点串,search及getchildren接口加get_polygon=1/2时返回
                   [116.221662,39.577632,116.206491,39.57579,116.201021,39.586952,....],
                   //其它项省略(若有)...
                ]
            }, 
           //其它项省略...
        ]
   ]
}

这篇文章对您解决问题是否有帮助?

已解决
未解决