接口描述

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

请求方法：GET

输入参数

参数名称	必填	默认值	说明
poiid	是	无	滴滴poi id

输出参数

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

Result：

参数名称	类型	描述
suggestion	Suggestion	泛搜索的时候，将显示城市列表
pois	array<Poi>	poi列表
is_current_city	int
target_city	string
target_city_name	string
count	int	结果poi总数量,最多1000个

Suggestion：

参数名称	类型	描述
cities	array<City>	城市列表

City：

参数名称	类型	描述
name	string	城市名
num	int	该城市包含搜索关键词的个数
adcode	string	该城市的adcode

Poi：

参数名称	类型	描述
id	string	滴滴poi id
parent	int
name	string	名称
category	string	poi类型
category_code	string	poi类型编码
address	string	地址
location	string	经纬度
distance	string	周边检索时离中心点距离
provincecode	string	poi所在省编码
provincename	string	poi所在省名称
citycode	string	poi所在城市编码
cityname	string	poi所在城市名称
adcode	string	poi所在区县编码
adname	string	poi所在区县名称
tel	string	电话
postcode	string	邮编
website	string	网站
email	string	邮箱
entr_location	string	入口经纬度
exit_location	string	出口经纬度
navi_location	string	poi对应的导航引导点坐标
alias	string	别名
brand	string	品牌
brand_code	string	品牌编码
food_type	string	风味类型
food_type_code	string	风味类型编码
business_area	string	所在商圈
parking_type	string	停车场类型：地下，地面，路边等
indoor_map	Indoor	室内地图相关数据
deep_info	DeepInfo
photos	array<Photo>	照片相关信息
subpois	array<SubPoi>

Indoor：

参数名称	类型	描述
cpid	string	父poi id
floor	string	楼层索引，一般数字表示，例如8
truefloor	string	所在楼层，例如F8

DeepInfo：

参数名称	类型	描述
rating	string	评价
cost	string	人均消费，景点门票等
price	string	景点门票，酒店起步价
price_highest	string	酒店最高价
star	string	星级标准
service	string	服务评分
wifi	string	是否有wifi
opentime	string	营业时间
is_24h	int	是否24小时
is_open	int	现在是否在营业
intro	string	介绍

Pohto：

参数名称	类型	描述
title	string	图片介绍
url	string	具体链接
height	int	图片高度
width	int	图片宽度

SubPoi：

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

错误码

错误码：

示例

请求：

curl -X GET \
  'https://mapapi-places.apigw-gz.didiyunapi.com/api/v1/place/details?poiid=2000000000000941038'\
  --header 'Authorization: AppCode XXX'

输出：

{
    "status": 0,
    "info": "OK",
    "result": {
        "suggestion": {
            "cities": null
        },
        "is_current_city": 1,
        "target_city": "",
        "target_city_name": "",
        "count": 1,
        "pois": [
            {
                "id": "2000000000000941038",
                "parent": "",
                "name": "鲜品寿司外卖店(上地华联店)",
                "category": "美食:日韩菜:日本料理",
                "category_code": "102210",
                "address": "北京市海淀区农大南路1号院1号楼华联商厦B1楼11号铺(近上地南口)",
                "location": "116.31118,40.02872",
                "distance": "",
                "provincecode": "110000",
                "provincename": "北京市",
                "citycode": "110000",
                "cityname": "北京市",
                "adcode": "110108",
                "adname": "海淀区",
                "tel": "",
                "postcode": "",
                "website": "",
                "email": "",
                "entr_location": "",
                "exit_location": "",
                "navi_location": "116.31118,40.02872",
                "alias": "",
                "brand": "鲜品寿司外卖店",
                "brand_code": "15031",
                "food_type": "",
                "food_type_code": "",
                "business_area": "",
                "parking_type": "",
                "indoor_map": {
                    "cpid": "",
                    "floor": "",
                    "truefloor": ""
                },
                "deep_info": {
                    "rating": "",
                    "cost": "",
                    "price": "",
                    "price_highest": "",
                    "star": "0",
                    "service": "",
                    "wifi": "",
                    "opentime": "",
                    "is_24h": 0,
                    "is_open": 0,
                    "intro": ""
                },
                "photos": [],
                "subpois": []
            }
        ]
    }
}