地点检索 | 百度地图api sdk-凯发k8官方旗舰厅

浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
地点详情检索服务
下载开发文档
接口说明

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

开发者可以通过三种区域检索(或其他服务)功能,获取poi id。

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

api服务地址

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

请求参数
参数默认值格式举例含义必选
uid‘8ee4560cf91d160e6cc02cd7’poi的uid
uids

‘8ee4560cf91d160e6cc02cd7’,
‘5ffb1816cf771a226f476058’

uid的集合,最多可以传入10个uid,多个uid之间用英文逗号分隔。
extensions_adcodefalsetrue、false是否召回国标行政区划编码,true(召回)、false(不召回)
outputxmljson或xml请求返回格式
ret_coordtypebd09llgcj02ll

可选参数,添加后poi返回国测局经纬度坐标

scope11、2检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索poi详细信息
ak您的ak开发者的访问密钥,必填项。v2之前该属性为key。
sn

sn生成方法

开发者的权限签名。
timestamp设置sn后该值必填。
photo_showtrue、false是否输出图片信息:true(输出) 、false(不输出)
返回参数
返回参数类型备注
statusint本次api访问状态,如果成功返回0,如果失败返回其他数字。(见服务状态码
messagestring对api访问状态值的英文说明,如果成功返回ok,并返回结果字段,如果失败返回错误说明。
result返回的结果
namestringpoi名称
result_typestring当返回结果为城市列表时,result_type=city_type
当返回结果为普通poi时,result_type=poi_type
当返回结果为行政区划数据时,result_type=region_type
当返回结果为门址数据时,result_type=address_type
locationobjectpoi经纬度坐标
latfloat纬度值
lngfloat经度值
addressstringpoi地址信息
provincestring所属省份
citystring所属城市
areastring所属区县
adcodeint行政区划代码
telephonestringpoi电话信息
uidstringpoi的唯一标识,可用于详情检索
statusstringpoi的状态:
空(代表正常营业)
推算位置(代表开放/营业/办公状态可能有变化)
暂停营业
可能已关闭
已关闭
注意:该功能为高级付费功能,您可提交咨询
street_idstring街景图id
detailstring是否有详情页:1有,0没有
detail_infoobjectpoi的扩展信息,仅当scope=2时,显示该字段,不同的poi类型,显示的detail_info字段不同。
distanceint32距离中心点的距离,圆形区域检索时返回
typestring所属分类,如hotel、cater。
tagstring标签
navi_locationobjectpoi对应的导航引导点坐标。大型面状poi的导航引导点,一般为各类出入口,方便结合导航、路线规划等服务使用
lngfloat导航引导点经度
latfloat导航引导点纬度
aliasstringpoi别名
detail_urlstringpoi的详情页
childrenpoi子点数据,若某poi无子点,该字段为空
uidstringpoi子点的唯一标示,可用于详情检索
namestringpoi子点名称
show_namestringpoi子点简要名称
tagstringpoi子点类别
locationobjectpoi子点坐标 {"lat":39.911318,"lng":116.402284}, // lat poi子点纬度 , lng poi子点经度
addressstringpoi子点地址
pricestringpoi商户的价格
shop_hoursstring营业时间
overall_ratingstring总体评分
taste_ratingstring口味评分
service_ratingstring服务评分
environment_ratingstring环境评分
facility_ratingstring星级(设备)评分
hygiene_ratingstring卫生评分
technology_ratingstring技术评分
image_numstring图片数
groupon_numint团购数
discount_numint优惠数
comment_numstring评论数
favorite_numstring收藏数
checkin_numstring签到数
brandstringpoi对应的品牌(如加油站中的『中石油』、『中石化』)
content_tagstringpoi标签信息
photosarraypoi图片的下载链接。注意:该功能为高级付费功能,您可提交咨询。
如您需要获取poi图片及poi营业状态,请点击获取poi图片获取poi营业状态
示例代码
填写您的ak

输入ak可生成包含ip/sn校验方式的代码

<?php
// 此处填写你在控制台-应用管理-创建应用后获取的ak
$ak ='您的ak';
// 发起一个http get请求,并返回请求的结果
// $url字段为请求的地址
// $param字段为请求的参数
functionrequest_get($url ='', $param =array()){
if(empty($url)||empty($param)){
returnfalse;
}
$geturl = $url ."?".http_build_query($param);
$curl =curl_init();// 初始化curl
curl_setopt($curl,curlopt_ssl_verifypeer,false);// 跳过证书检查
curl_setopt($curl,curlopt_ssl_verifyhost,2);// 从证书中检查ssl加密算法是否存在
curl_setopt($curl,curlopt_url, $geturl);// 抓取指定网页
curl_setopt($curl,curlopt_timeout,1000);// 设置超时时间1秒
curl_setopt($curl,curlopt_returntransfer,1);// curl不直接输出到屏幕
curl_setopt($curl,curlopt_header,0);// 设置header
$data =curl_exec($curl);// 运行curl
if(!$data){
print("an error occured in function request_get(): ".curl_error($curl)."\n");
}
curl_close($curl);
return $data;
}
// 请求地址
$url ='https://api.map.baidu.com/place/v2/detail';
// 构造请求参数
$param['uid']='435d7aea036e54355abbbcc8';
$param['output']='json';
$param['scope']='2';
$param['ak']= $ak;
$res =request_get($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res ."\n");
?>
{
"status":0,
"message":"ok",
"result":{
"uid":"435d7aea036e54355abbbcc8",
"street_id":"435d7aea036e54355abbbcc8",
"name":"百度大厦",
"location":{
"lng":116.30773937593,
"lat":40.056944251512
},
"address":"北京市海淀区上地十街10号",
"province":"北京市",
"city":"北京市",
"area":"海淀区",
"detail_info":{
"tag":"房地产;写字楼",
"navi_location":{
"lng":116.30707498917,
"lat":40.057189035977
},
"new_catalog":"100200",
"shop_hours":"",
"alias":[
""
],
"detail_url":"http://api.map.baidu.com/place/detail?uid=435d7aea036e54355abbbcc8&output=html&source=placeapi_v2",
"type":"house",
"overall_rating":"4.8",
"image_num":"102",
"comment_num":"166",
"content_tag":"位置优越;毗邻地铁;花园景观",
"mapsearch_son_display":{
"sontags":{
"2daf65a3a361f5faf8f0cb39":"(禁机动车)",
"25af43d34dc60565ac0457a8":"(仅限内部)"
},
"disable":"0",
"transfer":1
}
},
"detail":1
}
}
在线运行
参数备注必选
uid
poi的唯一标识,可用于详情检索
scope
检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索poi详细信息
output
输出格式为json或者xml
服务状态码
返回码英文描述定义常见原因
0ok正常服务请求正常召回
1服务器内部错误该服务响应超时或系统内部错误,请留下凯发k8官方旗舰厅的联系方式
2parameter invalid请求参数非法必要参数拼写错误或漏传(如query和tag请求中均未传入)
3verify failure权限校验失败
4quota failure配额校验失败服务当日调用次数已超限,请前往提升(请优先进行)
5ak failureak不存在或者非法未传入ak参数;ak已被删除(可前往恢复);
8parse proto failure数据解析失败一般是query输入有误导致,如query输入特殊字符,全角符号。
9permission denied高级权限校验失败
101ak参数不存在请求消息没有携带ak参数
200app不存在,ak有误请检查再重试根据请求的ak,找不到对应的app
201app被用户自己禁用,请在控制台解禁
202app被管理员删除恶意app被管理员删除
203app类型错误当前api控制台支持server(类型1), mobile(类型2, 新版控制台区分为mobile_android(类型21)及mobile_iphone(类型22))及browser(类型3),除此之外其他类型认为是app类型错误
210app ip校验失败在申请server类型应用的时候选择ip校验,需要填写ip白名单,如果当前请求的ip地址不在ip白名单或者不是0.0.0.0/0就认为ip校验失败
211app sn校验失败server类型app有两种校验方式ip校验和sn校验,当用户请求的sn和服务端计算出来的sn不相等的时候提示sn校验失败
240app 服务被禁用用户在api控制台中创建或设置某app的时候禁用了某项服务,若需开通权限,可进入为ak勾选对应服务
250用户不存在根据请求的user_id, 数据库中找不到该用户的信息,请携带正确的user_id
251用户被自己删除该用户处于未激活状态
252用户被管理员删除恶意用户被加入黑名单
260服务不存在服务器解析不到用户请求的服务名称
261服务被禁用该服务已下线
302天配额超限,限制访问配额超限,如果想增加配额请
401当前并发量已经超过约定并发配额,限制访问并发控制超限,请控制并发量或

上一篇

圆形区域检索

下一篇

地点输入提示

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

网站地图