地点详情检索 - 百度地图 API

status服务状态码

返回码	英文描述	定义	常见原因
0	ok	正常	服务请求正常召回
2	Parameter Invalid	请求参数非法	必要参数拼写错误或漏传（如query和tag请求中均未传入）
3	Verify Failure	权限校验失败
4	Quota Failure	配额校验失败	服务当日调用次数已超限，请前往API控制台提升（请优先进行开发者认证）
5	AK Failure	ak不存在或者非法	未传入ak参数；ak已被删除（可前往回收站恢复）；
8	Parse Proto Failure	数据解析失败	一般是query输入有误导致，如query输入特殊字符，全角符号。
9	Permission Denied	高级权限校验失败

{ "message": "string", "total": 0, "name": "string", "status": 0, "location": { "lat": 0, "lng": 0 }, "address": "string", "province": "string", "city": "string", "area": "string", "adcode": 0, "telephone": "string", "uid": "string", "street_id": "string", "detail": "string", "detail_info": { "distance": 0, "type": "string", "tag": "string", "navi_location": { "lng": 0, "lat": 0, "alias": "string", "detail_url": "string" }, "price": "string", "shop_hours": "string", "overall_rating": "string", "taste_rating": "string", "service_rating": "string", "environment_rating": "string", "facility_rating": "string", "hygiene_rating": "string", "technology_rating": "string", "image_num": "string", "groupon_num": 0, "discount_num": 0, "comment_num": "string", "favorite_num": "string", "checkin_num": "string", "brand": "string", "content_tag": "string", "photos": [ "string" ] } }

请求参数

Query 参数

uid

string

poi的uid

必需

示例值:

435d7aea036e54355abbbcc8

uids

string

可选

uid的集合，最多可以传入10个uid，多个uid之间用英文逗号分隔。

extensions_adcode

string

可选

是否召回国标行政区划编码， true（召回）、false（不召回）

output

string

请求返回格式

可选

示例值:

json

ret_coordtype

string

可选

可选参数，添加后POI返回国测局经纬度坐标坐标详细说明

scope

string

必需

检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息

示例值:

timestamp

string

可选

设置sn后该值必填。

photo_show

string

可选

是否输出图片信息：true(输出) 、false(不输出)

string

必需

开发者的访问密钥，必填项。v2之前该属性为key。申请秘钥

默认值:

string

可选

可选，若开发者所用AK的校验方式为SN校验时该参数必须。

默认值:

返回响应

🟢200成功

application/json

Body

message

string

必需

对API访问状态值的英文说明，如果成功返回"ok"，并返回结果字段，如果失败返回错误说明。

total

integer

必需

POI检索总数，开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的，单次请求total最多为400。

name

string

poi名称

必需

status

integer

必需

本次API访问状态，如果成功返回0，如果失败返回其他数字。（见服务状态码）

location

object

poi经纬度坐标

必需

lat

integer

纬度值

必需

lng

integer

经度值

必需

address

string

poi地址信息

必需

province

string

所属省份

必需

city

string

所属城市

必需

area

string

所属区县

必需

adcode

integer

行政区划代码

必需

telephone

string

poi电话信息

必需

uid

string

poi的唯一标示

必需

street_id

string

街景图id

必需

detail

string

必需

是否有详情页：1有，0没有

detail_info

object

必需

poi的扩展信息，仅当scope=2时，显示该字段，不同的poi类型，显示的detail_info字段不同。

distance

integer

必需

距离中心点的距离，圆形区域检索时返回

type

string

必需

所属分类，如’hotel’、’cater’。

tag

string

标签

必需

navi_location

object

必需

POI对应的导航引导点坐标。大型面状POI的导航引导点，一般为各类出入口，方便结合导航、路线规划等服务使用

price

string

poi商户的价格

必需

shop_hours

string

营业时间

必需

overall_rating

string

总体评分

必需

taste_rating

string

口味评分

必需

service_rating

string

服务评分

必需

environment_rating

string

环境评分

必需

facility_rating

string

星级（设备）评分

必需

hygiene_rating

string

卫生评分

必需

technology_rating

string

技术评分

必需

image_num

string

图片数

必需

groupon_num

integer

团购数

必需

discount_num

integer

优惠数

必需

comment_num

string

评论数

必需

favorite_num

string

收藏数

必需

checkin_num

string

签到数

必需

brand

string

必需

poi对应的品牌（如加油站中的『中石油』、『中石化』）

content_tag

string

poi标签信息

必需

photos

array[string]

必需

poi图片的下载链接。注意：该功能为高级付费功能，您可提交工单咨询。