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