接口描述
请求路径: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 | 网站 |
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": []
}
]
}
}