概述

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


请求URL

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

注:韩国、俄罗斯不支持海外输入提示。

请求参数

参数 必填 说明 示例
key 开发密钥(Key) key=OB4BZ-D4W3U-B7VVO-4PJW
keyword 搜索关键词 White Hou
oversea 是否调用海外(使用默认值 0 只调用国内服务) oversea=1
location 搜索范围中心点:
1. 传入后会在半径 10km 内搜索
2. 缺省时优先返回国内结果
38.900109,-77.0319397
radius 搜索半径(单位:米),默认10000,最大支持30000 radius=10000
language 返回结果的语言:
cn [默认]中文
local 当地语言
language=en
output 返回格式:支持JSON/JSONP,默认JSON output=json
callback JSONP方式回调函数 callback=function1

响应结果

名称 类型 必有 说明
status number 状态码,0为正常
message string 状态说明
count number 本次搜索结果总数
data array 搜索结果POI数组
id string POI唯一标识
title string poi名称
address string 地址
category string POI(地点)分类
location object 坐标
lat number 纬度
lng number 经度
_distance number 距离,单位:米

调用示例

//GET请求示例,注意参数值要进行URL编码
https://apis.map.qq.com/ws/place/v1/suggestion?key=API_KEY&keyword=WhiteHou&oversea=1

本页内容