概述

用于获取输入关键字的补完与提示,帮助用户快速输入。本接口为纯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

本页内容