百度POI检索 官方自营 免费使用

 

可通过关键词查询在某个地区的POI信息。比如在北京查询“银行”,接口将会输出所有银行的地理信息列表。

浏览量: 58879

调用量: 488032

使用人数: 8914

¥ 0.00 元起

接入点说明:
相关文档:
接口地址: 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 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_sign_method String md5 签名生成方式,其值可选为"md5"或"hmac"。如果不传入则默认"md5"。
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代表第二页,以此类推。
...

返回参数/ 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,服务不存在或未上线
-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受限
showapi_res_error String 用户输入有误! 错误信息的展示
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
status String
本次API访问状态,如果成功返回0,如果失败返回其他数字。
message String
对API访问状态值的英文说明,如果成功返回
total String
检索总数,用户请求中设置了page_num字段才会出现total字段。当检索总数值大于760时,多次刷新同一请求得到total的值可能稍有不同,属于正常情况。
results PlaceItem[]
返回结果
- name String
poi名称
- location Location
poi经纬度坐标
-- lat Number
纬度值
-- lng Number
经度值
- address String
poi地址信息
- telephone String
poi电话信息
- uid String
poi的唯一标示
- detail_info DetailInfo
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
签到数
...

返回示例/ Return example

{
	"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
	}
}