WebService API / 开发指南 / 搜索服务 / 行政区划

概述

本服务提供中国标准行政区划数据查询功能，支持：
1 . 全国省、市、区/县、乡镇/街道 四级行政区划数据；
2 . 支持三级区划（省/市 - 区/县）轮廓数据；
3 . 支持区划查询、省市区列表、查询子级区划等功能。
4. 支持获取乡镇/街道级（4级区划）轮廓边界（高级）


获取省市区列表

本接口用于获取全部省市区三级行政区划列表。
注：获取四级乡镇/街道数据，需要通过获取子级区划接口，传入指定三级区划，获取相应四级数据。

请求地址：

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

请求参数：

参数 必填 说明 示例
key 是 开发密钥（Key） key=OB4BZ-D4W3U-*
struct_type 否 区划列表新结构，取值:
1 新结构，是以省市区实际归属进行嵌套的结构返回，具体可参考如下新版响应结果		 struct_type=1
output 否 返回格式：支持JSON/JSONP，默认JSON output=json
callback 否 JSONP方式回调函数 callback=function1

响应结果： 见下文


获取下级行政区划

获取指定行政区划的子级行政区划
本接口支持获取 指定区县（三级）其下乡镇/街道（四级）列表

请求地址：

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

请求参数：

参数 必填 说明 示例
key 是 开发密钥（Key） key=OB4BZ-D4W3U-*
id 否 父级行政区划ID（adcode），
缺省时返回一级行政区划，也就是省级		 id=110000
get_polygon 否 返回行政区划轮廓点串（经纬度点串），取值：
0 默认，不返回轮廓
1 固定3公里抽稀粒度的区划轮廓
2 支持多种抽稀粒度的区划轮廓，可通过max_offset设置返回轮廓的抽稀级别
3 获取乡镇/街道（四级）轮廓边界（高级功能请提 工单 联系开通）		 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

响应结果： 见下文



行政区划搜索

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

请求地址：

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

请求参数：

参数 必填 说明 示例
key 是 开发密钥（Key） key=OB4BZ-D4W3U-*
keyword 是 搜索关键词：
1.支持输入一个文本关键词
2.支持多个行政区划代码(adcode)，英文逗号分隔		 keyword=北京
keyword=130681
get_polygon 否 返回行政区划轮廓点串（经纬度点串），取值：
0 默认，不返回轮廓
1 固定3公里抽稀粒度的区划轮廓
2 支持多种抽稀粒度的区划轮廓，可通过max_offset设置返回轮廓的抽稀级别
注：本参数仅在keyword为adcode，且仅检索一个行政区划时生效；		 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

响应结果

名称 类型 必有 说明
status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明
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”]
level number 否 行政区划级别，仅行政区划搜索接口返回此字段
cidx array 否 子级行政区划在下级数组中的下标位置
polygon array 否 该行政区划的轮廓经纬度点串（当使用get_polygon=1或2时返回），数组每一项为一个多边形，一个行政区划可以由多块多边形组成
注意：部分城市存在飞地，当两个polygon重叠时，重叠区域隶属其他城市，不重叠时代表此城市的飞地
其下数组项 array 否 每个数组为一个轮廓多边形点串（经纬度），格式为：
[坐标1经度,坐标1纬度,坐标2经度,坐标2纬度…]
address string 否 完整区划信息，仅行政区划搜索接口返回此字段

新版区划列表响应结果

名称 类型 必有
status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明
message string 是 状态说明
request_id string 是 请求唯一标识
data_version number 是 行政区划数据版本，便于您判断更新
result array of object 是 区划列表结果，结构是以区划归属进行嵌套
id string 是 行政区划唯一标识（adcode）
name string 是 简称，如“内蒙古”
level number 否 行政区划级别
fullname string 是 全称，如“内蒙古自治区”
pinyin array 否 行政区划拼音，每一下标为一个字的全拼，如：
[“nei”,“meng”,“gu”]
location object 是 经纬度
lat number 是 纬度
lng number 是 经度
districts 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（如中国东海）
 7）东莞市、中山市、儋州市、嘉峪关市 因其下无区县级，因此增加了末位为99代码的同名子级，用于补齐到三级区划的结构

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

调用示例

// GET请求，注意参数值要进行URL编码
// list接口：获取全部行政区划数据
https://apis.map.qq.com/ws/district/v1/list?key=[你的key]

// getchildren接口：获取北京市的子级行政区划
https://apis.map.qq.com/ws/district/v1/getchildren?id=110000&key=[你的key]

// search接口：搜索关键词为香格里拉的行政区划
https://apis.map.qq.com/ws/district/v1/search?&keyword=香格里拉&key=[你的key]

前往示例中心 在线体验 ➤

行政区划编码表下载

当前区划信息

点击下载行政区划编码表（更新于2024年8月21日）

历史更新信息

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

已解决
未解决