可通过关键词查询在某个地区的POI信息。比如在北京查询“银行”,接口将会输出所有银行的地理信息列表。
接口地址:http://route.showapi.com/52-29 (注意:接口支持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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 q String 银行 是 关键词 location String 39.915,116.404 是 中心经纬度。格式 纬度,经度 radius String 1000 1000 否 半径,单位米。最高2000米 ...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/52-29","my_appId","my_appSecret") .addTextPara("q","银行") .addTextPara("location","39.915,116.404") .addTextPara("radius","1000") .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数据结构): 展开收起
名称 类型 示例值 描述 街景图id String 街景图id uid String poi的唯一标示 detail String 是否有详情页:1有,0没有 lng String 经度值 lat String 纬度值 address String poi地址信息 name String poi名称 ...
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"message": "ok",
"ret_code": 0,
"results": [
{
"street_id": "08db2caeab1dc6dcfb2213da",
"uid": "08db2caeab1dc6dcfb2213da",
"detail": 1,
"location": {
"lng": 116.402285,
"lat": 39.914709
},
"address": "故宫内",
"name": "北京银行ATM(广场西路)"
},
{
"uid": "7af671e39c0b6c1158f6be9f",
"detail": 1,
"location": {
"lng": 116.403148,
"lat": 39.917438
},
"address": "北京市东城区东长安街天安门内",
"name": "交通银行ATM(木棉花酒店西南)"
}
],
"status": 0
}
}
接口地址:http://route.showapi.com/52-28 (注意:接口支持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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表):
参数名称 类型 默认值 示例值 必须 描述 uids String 8ee4560cf91d160e6cc02cd7,5ffb1816cf771a226f476058是 uid的集合,最多可以传入10个uid,多个uid之间用英文逗号分隔。scope String 2 2是 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息
请求示例:String res=new ShowApiRequest("http://route.showapi.com/52-28","my_appId","my_appSecret") .addTextPara("uids","8ee4560cf91d160e6cc02cd7,5ffb1816cf771a226f476058") .addTextPara("scope","2") .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 message String result Object[] - name String poi名称- location Object[] poi经纬度坐标- lat Number 纬度值- lng Number 经度值- address String poi地址信息- telephone String poi电话信息- uid String poi的唯一标示- detail_info Object[] poi的扩展信息,仅当scope=2时,显示该字段,不同的poi类型,显示的detail_info字段不同。- distance String 距离中心点的距离- type String 所属分类,如’hotel’、’cater’。- tag String 标签- detail_url String poi的详情页- price String poi商户的价格- shop_hours String 营业时间- overall_rating String 总体评分- taste_rating String 口味评分- service_rating String 服务评分- environment_rating String 环境评分- facility_rating String 星级(设备)评分- hygiene_rating String 卫生评分- technology_rating String 技术评分- image_num String 图片数- groupon_num String 团购数- discount_num String 优惠数- comment_num String 请填写参数描述- favorite_num String 收藏数- checkin_num String 签到数...
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"message": "ok",
"result": [
{
"uid": "8ee4560cf91d160e6cc02cd7",
"street_id": "b388f9fd9446bb58b25c6a97",
"detail": 1,
"location": {
"lng": 116.412243,
"lat": 40.005622
},
"address": "朝阳区慧忠北路慧忠里123号楼(飘亮广场往西100米路北)",
"name": "巫山烤全鱼(亚运村店)",
"detail_info": {
"detail_url": "http://api.map.baidu.com/place/detail?uid=8ee4560cf91d160e6cc02cd7&output=html&source=placeapi_v2",
"taste_rating": "4.0",
"alias": "江边城外·巫山烤全鱼亚运村店$江边城外烤全鱼(亚运村店)$江边城外烤全鱼亚运村店$江边城外巫山烤全鱼(亚运村店)$巫山烤全鱼(亚运村)$巫山烤全鱼家常菜$巫山烤鱼$巫山烤鱼(亚运村店)",
"tag": "美食;其他",
"recommendation": "豆豉烤鱼,皮蛋豆腐,川北凉粉,大拌菜,香辣烤鱼,香辣清江鱼,跳水木耳,鱼香烤鱼,豆豉清江鱼,青椒皮蛋,怪味清江鱼,麻辣烤鱼,豆豉烤鱼(草鱼),怪味烤鱼,四川泡菜,水果沙拉,香辣鲶鱼,咸鲜清江鱼,精品豆干,凉拌苦菊,芽菜烤鱼,麻辣清江鱼,烤鱼,怪味鲶鱼,酸菜清江鱼,咸蛋黄焗南瓜,清炒菠菜,鱼丸,土豆,海带,鸡蛋汤,重庆小面,小葱拌豆腐,宽粉,巫山烤鱼,小葱豆腐,渝乡大拌菜,木耳,豆芽,麻辣香锅,娃娃菜,川味大拌菜,香辣烤翅,尤其是金针菇,凉菜,家常泡饼,鱼香清江鱼,伤心凉粉",
"atmosphere": "休闲小憩,随便吃吃,商务宴请,情侣约会,朋友聚餐,家庭聚会",
"type": "cater",
"environment_rating": "4.0",
"shop_hours": "11:00-23:00",
"di_review_keyword": [
{
"keyword_category_name": "服务",
"keyword_type": 1,
"keyword_num": 5,
"keyword": "服务态度还行",
"keyword_desc": "还行",
"keyword_category_seq": 2,
"keyword_comment_ids": [
"22241daa43c40dcc0bee6aabcdbf9c10",
"c26133412f5ad43759407126a314ac21",
"8e38250c95d85a51dad2af4357b0e7fd",
"9457a583a88c11c3384567e5da8b73c0",
"d2d09f6f5ef1b10d3f86f558e28a65c8"
],
"keyword_tag": "服务态度"
},
{
"keyword_category_name": "服务",
"keyword_type": 1,
"keyword_num": 1,
"keyword": "上菜速度快",
"keyword_desc": "快",
"keyword_category_seq": 2,
"keyword_comment_ids": [
"e41e155d76b4488cb5f850dfa6d0ad20"
],
"keyword_tag": "上菜速度"
},
{
"keyword_category_name": "服务",
"keyword_type": 0,
"keyword_num": 2,
"keyword": "预约需要",
"keyword_desc": "需要",
"keyword_category_seq": 2,
"keyword_comment_ids": [
"850fd2aff0d0a6063c79b54370ec00c5",
"ebecff026072afa399478738622674d0"
],
"keyword_tag": "预约"
},
{
"keyword_category_name": "服务",
"keyword_type": 0,
"keyword_num": 1,
"keyword": "排队需要",
"keyword_desc": "需要",
"keyword_category_seq": 2,
"keyword_comment_ids": [
"8acf9d557827c6eb6f1a57c02559d3c9"
],
"keyword_tag": "排队"
},
{
"keyword_category_name": "环境",
"keyword_type": 1,
"keyword_num": 7,
"keyword": "环境还行",
"keyword_desc": "还行",
"keyword_category_seq": 1,
"keyword_comment_ids": [
"8e38250c95d85a51dad2af4357b0e7fd",
"3a151039ab022c792c1b3935f1594879",
"d2d09f6f5ef1b10d3f86f558e28a65c8",
"0ea1fa0493d550e6ed8959310c692b85",
"d2d09f6f5ef1b10d3f86f558e28a65c8",
"5cb011c2c1d7a6a973cdeeccf1f134f7",
"990c3f22becf264e211028d969a6013b"
],
"keyword_tag": "环境"
}
],
"image_num": "323",
"price": "70.0",
"featured_service": "免费停车,无线上网,提供在线菜单,有无烟区",
"description": "配菜的价格有点贵了,但是味道这些的还是可以的,而且那个剁椒的味道的烤鱼才叫一个好吃哟,我和我去的朋友都很满意。。。",
"service_rating": "4.0",
"comment_num": "524",
"overall_rating": "4.0"
}
}
],
"ret_code": 0,
"status": 0
}
}
接口地址:http://route.showapi.com/52-26 (注意:接口支持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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 q String 银行是 检索关键字,周边检索和矩形区域内检索支持多个关键字并集检索,不同关键字间以$符号分隔,最多支持10个关键字检索。如:”银行$酒店”。region String 北京是 检索区域(市级以上行政区域),如果取值为“全国”或某省份,则返回指定区域的POI及数量。scope String 1 1否 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息page_size String 10 1否 范围记录数量,默认为10条记录,最大返回20条。多关键字检索时,返回的记录数为关键字个数*page_size。page_num String 0 1否 分页页码,默认为0,0代表第一页,1代表第二页,以此类推。...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/52-26","my_appId","my_appSecret") .addTextPara("q","银行") .addTextPara("region","北京") .addTextPara("scope","1") .addTextPara("page_size","1") .addTextPara("page_num","1") .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 本次API访问状态,如果成功返回0,如果失败返回其他数字。message String 对API访问状态值的英文说明,如果成功返回total String 检索总数,用户请求中设置了page_num字段才会出现total字段。当检索总数值大于760时,多次刷新同一请求得到total的值可能稍有不同,属于正常情况。results Object[] 返回结果- name String poi名称- location Object[] poi经纬度坐标- lat Number 纬度值- lng Number 经度值- address String poi地址信息- telephone String poi电话信息- uid String poi的唯一标示- detail_info Object[] poi的扩展信息,仅当scope=2时,显示该字段,不同的poi类型,显示的detail_info字段不同。- distance String 距离中心点的距离- type String 所属分类,如’hotel’、’cater’。- tag String 标签- detail_url String poi的详情页- price String poi商户的价格- shop_hours String 营业时间- overall_rating String 总体评分- taste_rating String 口味评分- service_rating String 服务评分- environment_rating String 环境评分- facility_rating String 星级(设备)评分- hygiene_rating String 卫生评分- technology_rating String 技术评分- image_num String 图片数- groupon_num String 团购数- discount_num String 优惠数- comment_num String 请填写参数描述- favorite_num String 收藏数- checkin_num String 签到数...
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"message": "ok",
"total": 400,
"ret_code": 0,
"results": [
{
"street_id": "50f7d1461e9309c472210b6c",
"uid": "50f7d1461e9309c472210b6c",
"detail": 1,
"location": {
"lng": 116.312202,
"lat": 40.05239
},
"address": "北京市海淀区上地七街信息路2号",
"name": "中国工商银行(中关村支行)",
"telephone": "010-82896282"
}
],
"status": 0
}
}
易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。
让开发者可以像搭积木一样通过各种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