阿里云市场-高德-逆地理编码

逆地理编码

接口地址：http://route.showapi.com/1995-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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起 

参数名称	类型	默认值	示例值	必须	描述
batch	String	false		否	批量查询控制.batch 参数设置为 true 时进行批量查询操作，最多支持 20 个经纬度点进行批量地址查询操作。 batch 参数设置为 false 时进行单点查询，此时即使传入多个经纬度也只返回第一个经纬度的地址解析查询结果。
callback	String			否	回调函数。callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。
extensions	String	base		否	返回结果控制。extensions 参数默认取值是 base，也就是返回基本地址信息； extensions 参数取值为 all 时会返回基本地址信息、附近 POI 内容、道路信息以及道路交叉口信息。
homeorcorp	String			否	是否优化POI返回顺序。以下内容需要 extensions 参数为 all 时才生效。 homeorcorp 参数的设置可以影响召回 POI 内容的排序策略，目前提供三个可选参数： 0：不对召回的排序策略进行干扰。 1：综合大数据分析将居家相关的 POI 内容优先返回，即优化返回结果中 pois 字段的poi顺序。 2：综合大数据分析将公司相关的 POI 内容优先返回，即优化返回结果中 pois 字段的poi顺序。
location	String		116.434446,39.90816	是	传入内容规则：经度在前，纬度在后，经纬度间以“,”分割，经纬度小数点后不要超过 6 位。如果需要解析多个经纬度的话，请用"|"进行间隔，并且将 batch 参数设置为 true，最多支持传入 20 对坐标点。每对点坐标之间用"|"分割
output	String			否	返回数据格式类型。可选输入内容包括：JSON，XML。设置 JSON 返回结果数据将会以JSON结构构成；如果设置 XML 返回结果数据将以 XML 结构构成。
radius	String	1000		否	搜索半径。radius取值范围在0~3000，默认是1000。单位：米
roadlevel	String			否	道路等级。以下内容需要 extensions 参数为 all 时才生效。 可选值：0，1 当roadlevel=0时，显示所有道路 当roadlevel=1时，过滤非主干道路，仅输出主干道路数据
...

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1995-1","my_appId","my_appSecret") .addTextPara("batch","") .addTextPara("callback","") .addTextPara("extensions","") .addTextPara("homeorcorp","") .addTextPara("location","116.434446,39.90816") .addTextPara("output","") .addTextPara("radius","") .addTextPara("roadlevel","") .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”。详情可以参考 info状态表
infocode	String	10000	详情可以参考 info状态表
regeocode	Object		batch 字段设置为 true 时为批量请求，此时 regeocodes 标签返回，标签下为 regeocode 对象列表；batch 为false 时为单个请求，会返回 regeocode 对象；regeocode 对象包含的数据如下：
-  formatted_address	String	北京市朝阳区望京街道方恒国际中心B座方恒国际中心	结构化地址信息 结构化地址信息包括：省份＋城市＋区县＋城镇＋乡村＋街道＋门牌号码 如果坐标点处于海域范围内，则结构化地址信息为：省份＋城市＋区县＋海域信息
-  addressComponent	Object		地址元素列表
-  country	String	中国
-  province	String	北京市	坐标点所在省名称 例如：北京市
-  city	String[]	[]	请注意：当城市是省直辖县时返回为空，以及城市为北京、上海、天津、重庆四个直辖市时，该字段返回为空；参见帮助文档中 : 省直辖县列表
-  citycode	String	010	城市编码 例如：010
-  district	String	朝阳区	坐标点所在区 例如：海淀区
-  adcode	String	110105	行政区编码 例如：110108
-  township	String	望京街道	坐标点所在乡镇/街道（此街道为社区街道，不是道路信息） 例如：燕园街道
-  towncode	String	110105026000	乡镇街道编码 例如：110101001000
-  neighborhood	Object		社区信息列表
-  name	String	方恒国际中心	社区名称 例如：北京大学
-  type	String	商务住宅;楼宇;商住两用楼宇	POI类型 例如：科教文化服务;学校;高等院校
-  building	Object		楼信息列表
-  name	String	方恒国际中心B座	建筑名称 例如：万达广场
-  type	String	商务住宅;楼宇;商务写字楼	类型 例如：科教文化服务;学校;高等院校
-  streetNumber	Object		门牌信息列表
-  street	String	阜通东大街	街道名称 例如：中关村北二条
-  number	String	6-2号楼	门牌号 例如：3号
-  location	String	116.48129,39.9902869	坐标点 经纬度坐标点：经度，纬度
-  direction	String	西南	方向 坐标点所处街道方位
-  distance	String	25.9205	门牌地址到请求坐标的距离 单位：米
-  businessAreas	Object[]		经纬度所属商圈列表
-  0	Object
-  location	String	116.47089234140496,39.9976009239991	商圈中心点经纬度
-  name	String	望京	商圈名称 例如：颐和园
-  id	String	110105	商圈所在区域的adcode 例如：朝阳区/海淀区
...

返回示例：{ "showapi_res_error": "", "showapi_res_id": "49bbf8a2be9741438ff4a3cb99d1c3e7", "showapi_res_code": 0, "showapi_res_body": { "status": "1", "regeocode": { "addressComponent": { "city": [], "province": "北京市", "adcode": "110101", "district": "东城区", "towncode": "110101008000", "streetNumber": { "number": "2号", "location": "116.434389,39.9076711", "direction": "南", "distance": "54.5831", "street": "大羊毛胡同" }, "country": "中国", "township": "建国门街道", "businessAreas": [ { "location": "116.430989,39.9164", "name": "朝阳门", "id": "110101" }, { "location": "116.456129,39.908878", "name": "建外大街", "id": "110105" }, { "location": "116.44374,39.909981", "name": "建国门", "id": "110105" } ], "building": { "name": [], "type": [] }, "neighborhood": { "name": [], "type": [] }, "citycode": "010" }, "formatted_address": "北京市东城区建国门街道建国门地铁站C西南口" }, "info": "OK", "infocode": "10000" } }