自动补全
2020年02月05日

接口描述

请求路径:https://mapapi-places.apigw-gz.didiyunapi.com/api/v1/place/autocomplete

请求方法:GET

输入参数

参数名称 必填 默认值 说明
keywords 搜索关键词,keywords与categories必填其一。
categories 搜索POI类型编码或名称,最多5个,类型之间“|”分隔,详见滴滴POI类型列表。也支持品牌和风味编码。输入时POI分类编码请添加大写字母 C 前缀;品牌分类编码请添加大写字母 B 前缀;风味分类编码请添加大写字母 F 前缀。keywords与categories必填其一。
city 优先返回city指定城市的结果。支持省、市中文、全拼、adcode格式输入;若不输入city,则进行全国范围搜索。暂不支持全拼输入
city_limit false 为true时,仅返回city指定城市内的结果
location 用户坐标经纬度:lng,lat。经纬度小数点后不超过6位。1)如果city和location都没有,全国搜索;2)只有city的时候,优先返回该city结果;3)只有location的时候,优先返回location所在城市的结果;4)同传的话,city优先;5)关键字转周边搜索时,返回location附近的结果。

输出参数

参数名称 类型 描述
status int 状态码
info string 状态说明
result Result 请求返回数据

Result:

参数名称 类型 描述
suggestions array<Suggestion>

Suggestion:

参数名称 类型 描述
id string 滴滴poi id
name string 名称
category string poi类型
address string 地址
location string 经纬度
provincename string poi所在省名称
cityname string poi所在城市名称
adcode string poi所在区县编码
adname string poi所在区县名称

错误码

错误码:

示例

请求:

curl -X GET \
  'https://mapapi-places.apigw-gz.didiyunapi.com/api/v1/place/autocomplete?keywords=%E5%87%AF%E6%99%A8'

输出:

{
    "status": 0,
    "info": "OK",
    "result": {
        "suggestions": [
            {
                "name": "凯晨世贸中心",
                "location": "116.364881,39.906314",
                "id": "2000000000000028666",
                "category": "美食",
                "adname": "西城区",
                "provincename": "北京",
                "cityname": "北京",
                "adcode": "110102",
                "address": "北京市西城区复兴门内大街28号"
            }
        ]
    }
}

项搜索结果

    空空如也
    没有找到您要搜索的内容,请直接拨打服务热线400-0590-666