产品介绍
行政区域查询是一类简单的HTTP接口,根据用户输入的搜索条件可以帮助用户快速的查找特定的行政区域信息。
使用API前您需先申请Key,若无高德地图API账号需要先申请账号。
例如:中国>山东省>济南市>历下区>舜华路街道(国>省>市>区>街道)。
在使用前,需要特别说明两点:目前部分城市和省直辖县因为没有区县的概念,故在市级下方直接显示街道。例如:广东-东莞、海南-文昌市。
街道级别是不能返回边界数据polyline的,乡镇街道级别返回的adcode是所属区县的adcode。
暂时不支持台湾省的详细区划查询。
适用场景
用户希望通过得到行政区域信息,进行开发工作。
使用限制
服务调用量的限制请点击这里查阅。
使用说明
第一步,申请”Web服务API”密钥(Key);
第二步,拼接HTTP请求URL,第一步申请的Key需作为必填参数一同发送;
第三步,接收HTTP请求返回的数据(JSON或XML格式),解析数据。
如无特殊声明,接口的输入参数和输出数据编码全部统一为UTF-8。
行政区域查询
行政区域查询API服务地址:
URL/v3/config/district?parameters
请求方式GET
parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。请求参数
参数名含义规则说明是否必须缺省值
key请求服务权限标识必填无
keywords查询关键字规则:只支持单个关键词语搜索关键词支持:行政区名称、citycode、adcode
例如,在subdistrict=2,搜索省份(例如山东),能够显示市(例如济南),区(例如历下区)
adcode信息可参考城市编码表获取可选无
subdistrict子级行政区规则:设置显示下级行政区级数(行政区级别包括:国家、省/直辖市、市、区/县、乡镇/街道多级数据)
可选值:0、1、2、3等数字,并以此类推
0:不返回下级行政区;
1:返回下一级行政区;
2:返回下两级行政区;
3:返回下三级行政区;
需要在此特殊说明,目前部分城市和省直辖县因为没有区县的概念,故在市级下方直接显示街道。
例如:广东-东莞、海南-文昌市可选1
page需要第几页数据最外层的districts最多会返回20个数据,若超过限制,请用page请求下一页数据。
例如page=2;page=3。默认page=1可选1
offset最外层返回数据个数可选20
extensions返回结果控制此项控制行政区信息中返回行政区边界坐标点; 可选值:base、all;
base:不返回行政区边界坐标点;
all:只返回当前查询district的边界值,不返回子节点的边界值;
目前不能返回乡镇/街道级别的边界值可选base
filter根据区划过滤按照指定行政区划进行过滤,填入后则只返回该省/直辖市信息
需填入adcode,为了保证数据的正确,强烈建议填入此参数可选
callback回调函数callback值是用户定义的函数名称,此参数只在output=JSON时有效可选
output返回数据格式类型可选值:JSON,XML可选JSON返回结果参数说明
行政区域查询的响应结果的格式由请求参数output指定。
名称含义规则说明
status返回结果状态值值为0或1,0表示失败;1表示成功
info返回状态说明返回状态说明,status为0时,info返回错误原因,否则返回“OK”。
infocode状态码返回状态说明,10000代表正确,详情参阅info状态表
suggestion建议结果列表
keywords建议关键字列表
cites建议城市列表
districts行政区列表
district行政区信息
citycode城市编码
adcode区域编码街道没有独有的adcode,均继承父类(区县)的adcode
name行政区名称
polyline行政区边界坐标点当一个行政区范围,由完全分隔两块或者多块的地块组
成,每块地的 polyline 坐标串以 | 分隔 。
如北京 的 朝阳区
center区域中心点
level行政区划级别country:国家
province:省份(直辖市会在province和city显示)
city:市(直辖市会在province和city显示)
district:区县
street:街道
districts下级行政区列表,包含district元素服务示例
/v3/config/district?keywords=北京&subdistrict=2&key=
参数值备注必选
keywords规则:只支持单个关键词语搜索关键词支持:行政区名称、citycode、adcode
例如,在subdistrict=2,搜索省份(例如山东),能够显示市(例如济南),区(例如历下区)否
subdistrict规则:设置显示下级行政区级数(行政区级别包括:国家、省/直辖市、市、区/县4个级别)
可选值:0、1、2、3
0:不返回下级行政区;
1:返回下一级行政区;
2:返回下两级行政区;
3:返回下三级行政区;否
extensions此项控制行政区信息中返回行政区边界坐标点; 可选值:base、all;
base:不返回行政区边界坐标点;
all:只返回当前查询district的边界值,不返回子节点的边界值;否