行政区划服务
简介
天地图行政区划API是一类简单的HTTP/HTTPS接口,提供由行政区划地名、行政区划编码查询中心点、轮廓、所属上级行政区划的功能
天地图省市县行政区划名称及编码对照表(点击下载
天地图省市县行政区划可视化数据(点击下载
使用行政区划服务前您需要申请Key
行政区划码请求示例
请求: http://api.tianditu.gov.cn/v2/administrative?keyword=156110000&childLevel=0&extensions=true&tk=您的密钥
返回:
请求参数说明:
参数名 必选 类型 说明 默认值
keyword string 规则:只支持单个关键词语搜索
关键词支持:行政区划名称、行政区划编码
例如,keyword='北京' 或 keyword='156110000'
说明:仅行政区划名称支持模糊查询
注:keyword只有一个字符时,将只返回suggestion字段值,不返回district字段值
无默认值
childLevel string 规则:设置显示下级行政区级数(行政区级别包括:国家、省/直辖市、市、区/县多级数据
可选值:0、1、2、3
0:不返回下级行政区
1:返回下一级行政区
2:返回下两级行政区
3:返回下三级行政区
需要在此特殊说明,目前部分城市和省直辖县因为没有区县的概念,故在省级下方直接显示区县。
例如:河南-济源
0
extensions boolean 是否需要轮廓数据
可选值:true、false
true:返回轮廓数据
false:不返回轮廓数据
false
返回参数说明:
参数名 类型 说明
message string 返回描述
status number 200 正常,其他异常请看描述
data json 行政区划信息
data中参数信息:
参数名 类型 说明
suggestion array 建议搜索词
说明:模糊匹配结果列表,如果只匹配到一条,该字段值为空
district array 行政区划信息
district中参数信息:
参数名 类型 说明
name string 行政区划名称
gb string 行政区划编码
boundary string 轮廓数据
center json 中心点坐标
level number 行政区划级别:
国家级:5
省级:4
市级:3
区县级:2
children array 下级行政区划信息
children中参数信息:
参数名 类型 说明
name string 行政区划名称
gb string 行政区划编码
center json 中心点坐标
level number 行政区划级别:
国家级:5
省级:4
市级:3
区县级:2
children array 下级行政区划信息
center中参数信息:
参数名 类型 说明
lng double 经度
lat double 纬度