腾讯位置商业授权行政区划开发指南-海口c网

腾讯位置商业授权行政区划开发指南

article/2025/7/29 14:27:50

概述

本服务提供中国标准行政区划数据查询功能，支持：
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]

前往示例中心在线体验 ➤