概述

通过本服务检索某段道路附近的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-*****

前往示例中心 在线体验 ➤

本页内容