地理信息的输入提示

输入提示

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

参数名称	类型	默认值	示例值	必须	描述
keyWords	String		肯德基	是	查询关键词
type	String		050301	否	POI分类 服务可支持传入多个分类，多个类型剑用“|”分隔 可选值：POI分类名称、分类代码 此处强烈建议使用分类代码，否则可能会得到不符合预期的结果
location	String			否	坐标 格式：“X,Y”（经度,纬度），不可以包含空格 建议使用location参数，可在此location附近优先返回搜索关键词信息
city	String			否	搜索城市 可选值：citycode、adcode 如：010/110000
citylimit	String			否	仅返回指定城市数据 可选值：true/false
datatype	String			否	返回的数据类型 多种数据类型用“|”分隔，可选值：all-返回所有数据类型、poi-返回POI数据类型、bus-返回公交站点数据类型、busline-返回公交线路数据类型
...

请求示例：String res=new ShowApiRequest("http://route.showapi.com/1663-1","my_appId","my_appSecret") .addTextPara("keyWords","肯德基") .addTextPara("type","050301") .addTextPara("location","") .addTextPara("city","") .addTextPara("citylimit","") .addTextPara("datatype","") .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数据结构）： 展开收起 

名称	类型	示例值	描述
ret_code	String		0：扣费 表示成功。 -1：不扣费 未查询到信息
remark	String		返回说明
tips	Object[]		建议提示列表
-  id	String		返回数据ID 若数据为POI类型，则返回POI ID;若数据为bus类型，则返回bus id;若数据为busline类型，则返回busline id。
-  name	String		tip名称
-  district	String		所属区域 省+市+区（直辖市为“市+区”）
-  adcode	String		区域编码 六位区县编码
-  location	String		tip中心点坐标 当搜索数据为busline类型时，此字段不返回
-  address	String		详细地址
...

返回示例：{ "ret_code":0, "remark":"查询成功！", "tips":[ { "id":"B0FFHDAFNQ", "typecode":"080603", "address":"乌镇互联网国际会展中心内", "location":"120.483608,30.754622", "name":"网剧场", "adcode":"330483", "district":"浙江省嘉兴市桐乡市" }, { "id":"B0FFI2V7HG", "typecode":"080603", "address":"人民东路128号", "location":"119.903475,29.449938", "name":"195网剧小镇", "adcode":"330726", "district":"浙江省金华市浦江县" }, { "id":"B001C8O8N7", "typecode":"080308", "address":"清淳家园中国小镇A区155号附39号", "location":"103.982066,30.707604", "name":"网居网吧", "adcode":"510106", "district":"四川省成都市金牛区" }, { "id":"B0FFIAWLHB", "typecode":"080308", "address":"红山东路23号附近", "location":"109.746949,38.307795", "name":"网聚", "adcode":"610802", "district":"陕西省榆林市榆阳区" }, { "id":"B00190YZR5", "typecode":"080308", "address":"金盛路198号", "location":"118.821682,31.968556", "name":"网聚动漫网咖", "adcode":"320115", "district":"江苏省南京市江宁区" }, { "id":"B000A4A59C", "typecode":"080308", "address":"东四北大街449号", "location":"116.417238,39.926825", "name":"网聚网吧(东四北大街)", "adcode":"110101", "district":"北京市东城区" }, { "id":"B0FFGC7AUL", "typecode":"060000", "address":"浮宫镇新圩路153号", "location":"117.909473,24.362061", "name":"网具店", "adcode":"350681", "district":"福建省漳州市龙海市" }, { "id":"B02180JXWS", "typecode":"060306", "address":"立新街与昌安大道(原西关路)交叉路口南20米路东", "location":"119.750602,36.378033", "name":"网聚科技", "adcode":"370785", "district":"山东省潍坊市高密市" }, { "id":"B0FFFXYATP", "typecode":"060306", "address":"尧城路69号-40", "location":"117.021118,30.098662", "name":"网聚电脑", "adcode":"341721", "district":"安徽省池州市东至县" }, { "id":"B0FFJ9A2BU", "typecode":"080308", "address":"燕郊经济技术开发区新宾路华大街格莱美KTV一层", "location":"116.832619,39.944458", "name":"网聚网咖", "adcode":"131082", "district":"河北省廊坊市三河市" } ] }