地理信息的输入提示

第三方服务商
价格:会员免费  
服务商: 万维易源
  • 产品介绍
  • 接口文档
  • 服务商
  • 官方客服

输入提示是一类简单的HTTP接口,提供根据用户输入的关键词查询返回建议列表。

输入提示


接口地址: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_appidString100易源应用id
showapi_signString698d51a19d8a121ce581499d7b701668为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 
showapi_timestampString20141114142239客户端时间。 
格式yyyyMMddHHmmss,如20141114142239 
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。 
showapi_res_gzipString1或0返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...

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

参数名称类型默认值示例值必须描述
keyWordsString 肯德基查询关键词
typeString 050301POI分类 服务可支持传入多个分类,多个类型剑用“|”分隔 可选值:POI分类名称、分类代码 此处强烈建议使用分类代码,否则可能会得到不符合预期的结果
locationString  坐标 格式:“X,Y”(经度,纬度),不可以包含空格 建议使用location参数,可在此location附近优先返回搜索关键词信息
cityString  搜索城市 可选值:citycode、adcode 如:010/110000
citylimitString  仅返回指定城市数据 可选值:true/false
datatypeString  返回的数据类型 多种数据类型用“|”分隔,可选值: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_bodyString{"city":"昆明","prov":"云南"}消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_codeint0易源返回标志,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_errorString用户输入有误!错误信息的展示
showapi_res_idStringce135f6739294c63be0c021b76b6fbff本次请求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":"河北省廊坊市三河市" } ] }

服务商介绍:易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。

易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。

让开发者可以像搭积木一样通过各种API操纵资源。

截至2017年12月,平台已经拥有API接口230个,日调用量2000万,覆盖全网10万+真实消费者,为超过3000+的企业用户提供全域数据服务。

 

联系方式:

电话: 4009988033

 

微博: http://www.weibo.com/showapi

 

邮箱: services@showapi.com

 

QQ: 3007663665

 

微信: show_api

进制数据介绍:

企业和程序员可以通过进制数据封装的API或SDK极速接入其他数据资源,同时进制数据提供数据交易等服务。通过进制数据,不仅开发成本极大降低,而且可以获得其他丰富的数据服务:数据交易,数据分析,区块链Token管理等服务。

 

 

联系我们:

电话:173-6457-5198

QQ① 群:792473404

客服 QQ:1643296538

微信客服:binstds

                                      扫描二维码添加客服微信

 

 

工作时间

 周一至周五 9:00 - 21:00(其中周三为 9:00 - 18:00) 

周六 9:00 - 12:00(节假日除外) 

 

 

进制数据团队

 

 

2020.01.01

 

 

 

 

 


其他服务商
热门API推荐
相关API推荐