阿里云市场-高德-输入提示

输入提示

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

参数名称	类型	默认值	示例值	必须	描述
city	String		北京	否	查询城市。可选值：城市中文、中文全拼、citycode、adcode
datatype	String		all	否	多种数据类型用“|”分隔，可选值：all-返回所有数据类型、poi-返回POI数据类型、bus-返回公交站点数据类型、busline-返回公交线路数据类型
keywords	String		肯德基	是	查询关键词
location	String		116.481488,39.990464	否	经度,纬度;建议使用location参数，可在此location附近优先返回搜索关键词信息
type	String		050301	否	查询POI类型
...

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1996-1","my_appId","my_appSecret") .addTextPara("city","北京") .addTextPara("datatype","all") .addTextPara("keywords","肯德基") .addTextPara("location","116.481488,39.990464") .addTextPara("type","050301") .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 1：成功；0：失败
count	String	10	返回结果总数目
info	String	OK	返回的状态信息 status为0时，info返回错误原；否则返回“OK”。详情参阅info状态表
infocode	String	10000	详情参阅info状态表
tips	Object[]		建议提示列表
-  0	Object		提示信息
-  id	String	B000A7BM4H	返回数据ID 若数据为POI类型，则返回POI ID;若数据为bus类型，则返回bus id;若数据为busline类型，则返回busline id。
-  name	String	肯德基(花家地店)	tip名称
-  district	String	北京市朝阳区	所属区域 省+市+区（直辖市为“市+区”）
-  adcode	String	110105	区域编码 六位区县编码
-  location	String	116.469271,39.985568	tip中心点坐标 当搜索数据为busline类型时，此字段不返回
-  address	String	花家地小区1号商业楼	详细地址
-  typecode	String	050301	查询POI类型
...

返回示例：{ "showapi_res_error": "", "showapi_res_id": "10aa9ac2efa34e8a8566168c798d7fb5", "showapi_res_code": 0, "showapi_res_body": { "status": "1", "count": "10", "info": "OK", "infocode": "10000", "tips": [ { "id": "B0FFKEPXS2", "name": "肯德基(望京西店)", "district": "北京市朝阳区", "adcode": "110105", "location": "116.474027,39.997731", "address": "望京西园4区410号综合楼1层", "typecode": "050301", "city": [] } ] } }