阿里云市场-高德- 行政区域查询

行政区域查询

接口地址：http://route.showapi.com/1994-1 （注意：接口支持https，更安全，但稍慢一些，你懂的。请根据自己的情况进行选择。）

支持格式：json

请求方法：HTTP协议，支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时，enctype=application/x-www-form-urlencoded。 
文件上传的POST时，enctype=multipart/form-data。 

1、系统级参数（所有接入点都需要的参数）： 

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp	String	20141114142239	否	客户端时间。  格式yyyyMMddHHmmss,如20141114142239  为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起 

参数名称	类型	默认值	示例值	必须	描述
callback	String			否	callback值是用户定义的函数名称，此参数只在output=JSON时有效
extensions	String	base		否	此项控制行政区信息中返回行政区边界坐标点； 可选值：base、all; base:不返回行政区边界坐标点； all:只返回当前查询district的边界值，不返回子节点的边界值；
filter	String			否	按照指定行政区划进行过滤，填入后则只返回该省/直辖市信息 需填入adcode，为了保证数据的正确，强烈建议填入此参数
offset	String	20		否	最外层返回数据个数
output	String	JSON		否	可选值：JSON，XML
page	String	1		否	最外层的districts最多会返回20个数据，若超过限制，请用page请求下一页数据。 例如page=2；page=3。默认page=1
showbiz	String	true		否	可选为true/false，为了能够精准的定位到街道，特别是在快递、物流、送餐等场景下，强烈建议将此设置为false。
subdistrict	String	1		否	规则：设置显示下级行政区级数（行政区级别包括：国家、省/直辖市、市、区/县、商圈、街道多级数据），其中街道数据仅在keywords为区/县、商圈的时候显示 可选值：0、1、2、3等数字，并以此类推 0：不返回下级行政区； 1：返回下一级行政区； 2：返回下两级行政区； 3：返回下三级行政区；
...

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1994-1","my_appId","my_appSecret") .addTextPara("callback","") .addTextPara("extensions","") .addTextPara("filter","") .addTextPara("offset","") .addTextPara("output","") .addTextPara("page","") .addTextPara("showbiz","") .addTextPara("subdistrict","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数（所有接入点都会返回的参数）： 展开收起 

名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。
showapi_res_code	int	0	易源返回标志,0为成功，其他为失败。 0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -1000，系统维护 -1002，showapi_appid字段必传 -1003，showapi_sign字段必传 -1004，签名sign验证有误 -1005，showapi_timestamp无效 -1006，app无权限调用接口  -1007，没有订购套餐 -1008，服务商关闭对您的调用权限 -1009，调用频率受限 -1010，找不到您的应用 -1011，子授权app_child_id无效 -1012，子授权已过期或失效 -1013，子授权ip受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起 

名称	类型	示例值	描述
status	String	1	返回结果状态值 值为0或1，0表示失败；1表示成功
info	String	OK	返回状态说明 返回状态说明，status为0时，info返回错误原因，否则返回“OK”。
infocode	String	10000	状态码 返回状态说明，10000代表正确，详情参阅info状态表
count	String	1
suggestion	Object		建议结果列表
-  keywords	String[]	[]	建议关键字列表
-  cities	String[]	[]	建议城市列表
districts	Object[]		行政区列表
-  0	Object		行政区信息
-  citycode	String	010	城市编码
-  adcode	String	110000	区域编码 街道没有独有的adcode，均继承父类（区县）的adcode
-  name	String	北京市	行政区名称
-  center	String	116.407394,39.904211	城市中心点 必须说明 在区县级别，有28个区县不能返回中心点 在乡镇/街道界别，有9262个乡镇/街道不能返回中心点
-  level	String	province	行政区划级别 country:国家 province:省份（直辖市会在province和city显示） city:市（直辖市会在province和city显示） district:区县 street:街道
-  districts	String[]	[]	下级行政区列表，包含district元素
...

返回示例：{ "status" :"1", "info" :"OK", "infocode" :"10000", "count" :"1", "suggestion" : { "keywords" :[ ], "cities" :[ ] }, "districts" :[ { "citycode" :"010", "adcode" :"110000", "name" :"北京市", "center" :"116.407394,39.904211", "level" :"province", "districts" :[ ] } ] }