地点检索

所有文档

服务概览

快速开始

使用准备开始使用

接口文档

服务功能

行政区划区域检索多边形区域检索圆形区域检索地点详情检索地点输入提示

进阶能力

获取POI图片获取POI营业状态

相关资料

更新日志常见问题资源下载使用指南

地点详情检索

下载开发文档

前往示例中心在线体验

接口说明

不同于其他三种检索功能。地点详情检索针对指定POI，检索其相关的详情信息。

开发者可以通过三种区域检索（或其他服务）功能，获取POI id。

使用“地点详情检索”功能，传入id，即可检索POI详情信息，如评分、营业时间等（不同类型POI对应不同类别详情数据）。

注意：请通过检索接口实时获取POI数据UID进行详情检索。

API服务地址

https://api.map.baidu.com/place/v2/detail?uid=435d7aea036e54355abbbcc8&output=json&scope=2&ak=您的密钥
//GET请求

请求参数

参数名称	参数含义	示例	默认值	字段类型	必选
uid	poi的uid	‘8ee4560cf91d160e6cc02cd7’	无	string	是
scope	检索结果详细程度。取值为1 或空，则返回基本信息；取值为2，返回检索POI详细信息	1、2	1	string(50)	否
ak	开发者的访问密钥，必填项。v2之前该属性为key。	您的ak	无	string(50)	是
uids	uid的集合，最多可以传入10个uid，多个uid之间用英文逗号分隔。	‘8ee4560cf91d160e6cc02cd7’, ‘5ffb1816cf771a226f476058’	无	string	否
extensions_adcode	是否召回国标行政区划编码，true（召回）、false（不召回）	true、false	false	string(50)	否
output	请求返回格式	json或xml	xml	string(50)	否
ret_coordtype	返回的坐标类型，可选参数，添加后POI返回国测局经纬度坐标坐标详细说明	gcj02ll	bd09ll	string(50)	否
sn	开发者的权限签名。	sn生成方法	无	string(50)	否
timestamp	设置sn后该值必填。		无	string(50)	否
photo_show	是否输出图片信息：true(输出) 、false(不输出)	true、false	无	bool	否
language	en	指定输入参数和召回参数的语言类型，可支持的语言类型为英文注意：该功能为高级付费功能，您可提交工单咨询		string(50)	否

返回参数

返回参数				类型	备注
status				Int	本次API访问状态，如果成功返回0，如果失败返回其他数字。（见服务状态码）
message				string	对API访问状态值的英文说明，如果成功返回ok，并返回结果字段，如果失败返回错误说明。
result					返回的结果
	name			string	poi名称
	result_type			string	当返回结果为城市列表时，result_type=city_type 当返回结果为普通poi时，result_type=poi_type 当返回结果为行政区划数据时，result_type=region_type 当返回结果为门址数据时，result_type=address_type
	location			object	poi经纬度坐标
		lat		float	纬度值
		lng		float	经度值
	address			string	poi地址信息
	province			string	所属省份
	city			string	所属城市
	area			string	所属区县
	adcode			int	行政区划代码
	telephone			string	poi电话信息
	uid			string	poi的唯一标识，可用于详情检索
	status			string	POI的状态：空（代表正常营业）推算位置（代表开放/营业/办公状态可能有变化）暂停营业可能已关闭已关闭注意：该功能为高级付费功能，您可提交工单咨询
	street_id			string	街景图id
	detail			string	是否有详情页：1有，0没有
	detail_info			object	poi的扩展信息，仅当scope=2时，显示该字段，不同的poi类型，显示的detail_info字段不同。
		distance		int32	距离中心点的距离，圆形区域检索时返回
		type		string	所属分类，如hotel、cater。
		tag		string	标签
		classified_poi_tag		string	POI展示分类（细致分类）
		navi_location		object	POI对应的导航引导点坐标。大型面状POI的导航引导点，一般为各类出入口，方便结合导航、路线规划等服务使用
			lng	float	导航引导点经度
			lat	float	导航引导点纬度
		alias		string	poi别名
		detail_url		string	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		int	团购数
		discount_num		int	优惠数
		comment_num		string	评论数
		favorite_num		string	收藏数
		checkin_num		string	签到数
		brand		string	poi对应的品牌（如加油站中的『中石油』、『中石化』）
		content_tag		string	poi标签信息
		photos		array	poi图片的下载链接。注意：该功能为高级付费功能，您可提交工单咨询。

如您需要获取POI图片及POI营业状态，请点击获取POI图片，获取POI营业状态

服务状态码

返回码	英文描述	定义	常见原因


0	ok	正常	服务请求正常召回
1		服务器内部错误	该服务响应超时或系统内部错误，请留下联系方式
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	高级权限校验失败
101		AK参数不存在	请求消息没有携带AK参数
200		APP不存在，AK有误请检查再重试	根据请求的ak，找不到对应的APP
201		APP被用户自己禁用，请在控制台解禁
202		APP被管理员删除	恶意APP被管理员删除
203		APP类型错误	当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone（类型22））及Browser（类型3），除此之外其他类型认为是APP类型错误
210		APP IP校验失败	在申请SERVER类型应用的时候选择IP校验，需要填写IP白名单，如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败
211		APP SN校验失败	SERVER类型APP有两种校验方式IP校验和SN校验，当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败
240		APP 服务被禁用	用户在API控制台中创建或设置某APP的时候禁用了某项服务，若需开通权限，可进入API控制台为AK勾选对应服务
250		用户不存在	根据请求的user_id, 数据库中找不到该用户的信息，请携带正确的user_id
251		用户被自己删除	该用户处于未激活状态
252		用户被管理员删除	恶意用户被加入黑名单
260		服务不存在	服务器解析不到用户请求的服务名称
261		服务被禁用	该服务已下线
302		天配额超限，限制访问	配额超限，如果想增加配额请联系我们
401		当前并发量已经超过约定并发配额，限制访问	并发控制超限，请控制并发量或联系我们

圆形区域检索

地点输入提示

本篇文章对您是否有帮助？