腾讯位置商业授权沿途搜索服务开发指南
概述
通过本服务检索某段道路附近的POI信息,可配合路线规划,为用户提供沿途服务区、加油站等搜索功能。
注:
1、本服务属于高级付费服务,如需试用请提交商务合作开通服务试用。
2、本接口有大小限制,接口长度不能超过8kb。
请求URL
该请求为GET请求
https://apis.map.qq.com/ws/place/v1/alongby
Method:GET
请求参数
参数 | 必填 | 说明 | 示例 |
---|---|---|---|
key | 是 | 开发密钥(Key) | key=OB4BZ-D4W3U-***** |
keyword | 是 | 搜索关键词 支持分类:充电站、厕所、停车场、购物、加油站、银行ATM、加气站、便利店、服务区、汽车维修、中石油、中石化 | keyword=加油站 |
polyline | 是 | 路线坐标串,沿途搜将在路线两侧500米范围进行搜索 格式:lat<纬度>,lng经度,lat<纬度>,lng经度… 注意:经纬度建议保留6位小数。坐标个数受HTTP/GET方法长度限制,一般可支持350个左右,如果过多需要做抽稀处理 | polyline= 39.884354953696814, 116.46138998314004, 39.88697994710748,116.46141998687052 |
output | 否 | 返回格式:支持JSON/JSONP,默认JSON | output=json |
callback | 否 | JSONP方式回调函数 | callback=function1 |
响应结果
名称 | 类型 | 必填 | 说明 | ||
---|---|---|---|---|---|
status | number | 是 | 状态码,0为正常,其它为异常,详细请参阅状态码说明 | ||
request_id | string | 是 | 本次请求唯一ID,可用于问题排查 | ||
count | nubmer | 是 | POI数量 | ||
result | object | 是 | 检索结果 | ||
id | string | 是 | POI(地点)唯一标识 | ||
title | string | 是 | POI(地点)名称 | ||
address | string | 是 | 地址 | ||
tel | string | 是 | 电话 | ||
category | string | 是 | POI(地点)分类 | ||
type | number | 是 | POI类型 | ||
location | object | 是 | 坐标 | ||
lat | number | 是 | 纬度 | ||
lng | number | 是 | 经度 | ||
ad_info | object | 是 | 定位行政区划信息 | ||
adcode | number | 是 | 行政区划代码 | ||
province | string | 是 | 省 | ||
city | string | 否 | 市 | ||
district | string | 否 | 区 |
调用示例
// GET请求,注意参数值要进行URL编码
https://apis.map.qq.com/ws/place/v1/alongby?keyword=便利店&polyline=39.884354953696814,116.46138998314004,39.88697994710748,116.46141998687052,39.88697994710748,116.46141998687052&key=OB4BZ-D4W3U-*****