概述

        用于获取输入关键字的补完与提示,帮助用户快速输入。本接口为纯HTTP数据接口,需配合前端程序实现Autocomplete(自动完成)的效果。

Head

请求URL

        该请求为GET请求

https://apis.map.qq.com/ws/place/v1/suggestion


请求参数

名称 必填 说明 示例
keyword 用户输入的关键词(希望获取后续提示的关键词) keyword=南方
范围限制条件
region 限制城市范围:
根据城市名称限制地域范围, 如,仅获取“广州市”范围内的提示内容;
缺省时侧进行全国范围搜索;
region=广州
region_fix 0:[默认]当前城市无结果时,自动扩大范围到全国匹配
1:固定在当前城市
region_fix=1
location 定位坐标,传入后,若用户搜索关键词为类别词(如酒店、餐馆时),与此坐标距离近的地点将靠前显示,格式: location=lat,lng location=39.11457,116.55332
get_subpois 是否返回子地点,如大厦停车场、出入口等取值:
0 [默认]不返回
1 返回
get_subpois=1
policy 检索策略,目前支持:
policy=0:默认,常规策略
policy=1:本策略主要用于收货地址、上门服务地址的填写,
提高了小区类、商务楼宇、大学等分类的排序,过滤行政区、
道路等分类(如海淀大街、朝阳区等),排序策略引入真实用户对输入提示的点击热度,
使之更为符合此类应用场景,体验更为舒适
policy=10:出行场景(网约车) – 起点查询
policy=11:出行场景(网约车) – 终点查询
policy=1
filter 筛选条件:
基本语法:columnName<筛选列>=value<列值>;
目前支持按POI分类筛选(例:category=分类词),若指定多个分类用英文逗号分隔,最多支持五个分类,支持的分类词可参考:附录:腾讯地图POI分类关键词
搜索指定分类
filter=category=公交站
搜索多个分类
filter=category=大学,中学
(注意参数值要进行url编码)
address_format 可选值:short
返回“不带行政区划的”短地址
address_format=short
page_index 页码,从1开始,最大页码需通过count进行计算,必须与page_size同时使用 page_index=1
page_size 每页条数,取值范围1-20,必须与page_index 时使用 page_size=10
key 开发密钥(Key) key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77
output 返回格式:支持JSON/JSONP,默认JSON output=json
callback JSONP方式回调函数 callback=function1

响应结果

名称 类型 必填 说明
status number 状态码,0为正常,其它为异常,详细请参阅状态码说明
message string 状态说明
count number 结果总数(注:本服务一个查询条件最多返回100条结果)
data array 提示词数组,每项为一个POI对象
id string POI唯一标识
title string 提示文字
address string 地址
province string
city string
adcode string 行政区划代码
type number POI类型,值说明:0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
_distance number 传入location(定位坐标)参数时,返回定位坐标到各POI的距离
location object 提示所述位置坐标
lat number 纬度
lng number 经度
sub_pois array 子地点列表,仅在输入参数get_subpois=1时返回
parent_id string 主地点ID,对应data中的地点ID
id string 地点唯一标识
title string 地点名称
address string 地址
location object 坐标
lat number 纬度
lng number 经度
adcode number 行政区划代码
city string 地点所在城市名称

调用示例

//GET请求示例,注意参数值要进行URL编码
https://apis.map.qq.com/ws/place/v1/suggestion/?region=北京&keyword=美食&key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77

在线测试

region
keyword
key
反馈

这篇文章对您解决问题是否有帮助?

已解决
未解决