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

浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
地点输入提示
下载开发文档
接口说明

地点输入提示服务(又名place suggestion api)是一类web api接口服务。

匹配用户输入内容,提供输入提示功能。常与地点检索服务搭配使用。也可作为轻量级地点检索服务单独使用(不支持复杂检索场景)。

用户可通过该服务,匹配用户输入关键词的地点推荐列表。

使用说明

在应用方面,可将地点推荐列表展示给用户,用户可通过点击等交互方式,结合地点检索服务,检索用户点击的poi信息,实现地点详情检索功能。

通过关键词和检索城市限制,可满足轻量级地点检索需求,获取地点基础数据。

api服务地址

https://api.map.baidu.com/place/v2/suggestion?query=天安门®ion=北京&city_limit=true&output=json&ak=你的ak
//get请求

请求参数
参数名称默认值格式备注必选
q(query)上地、天安、中关、shanghai输入建议关键字(支持拼音)
region北京市、上海市等

支持城市及对应百度编码()。(指定的区域的返回结果加权,可能返回其他城市高权重结果。若要对返回结果区域严格限制,请使用city_limit参数)

city_limitfalse'false'or'true'取值为"true",仅返回region中指定城市检索结果
location40.047857537164,116.31353434477传入location参数后,返回结果将以距离进行排序
coord_type3

坐标类型:
1(wgs84ll即gps经纬度)
2(gcj02ll即国测局经纬度坐标)
3(bd09ll即百度经纬度坐标)
4(bd09mc即百度米制坐标)

可选参数,用于标注请求中「location」参数使用的坐标类型
ret_coordtype

gcj02ll

可选参数,添加后poi返回国测局经纬度坐标
若不传该参数,返回结果默认bd09ll(百度经纬度)

outputxmljson、xml返回数据格式,可选json、xml两种
ake4805d16**********707cdc962045开发者访问密钥,必选。
sn

sn校验说明

用户的权限签名
timestamp设置sn后该值必选
返回参数
返回参数类型备注
statusint本次api访问状态,如果成功返回0,如果失败返回其他数字。(见服务状态码
messagestring对api访问状态值的英文说明,如果成功返回ok,并返回结果字段,如果失败返回错误说明。
result返回的结果
namestringpoi名称,单次请求最多返回10条结果
locationobjectpoi经纬度坐标
latfloat纬度值
lngfloat经度值
uidstringpoi的唯一标识,id
provincestring所属省份
citystring所属城市
cityidint百度城市编码 详情见资源下载citycode编码
districtstring区县
adcodeint行政区划代码
businessstring商圈
tagstringpoi分类
addressstringpoi地址
childrenpoi子点
uidstringpoi子点id,可用于poi详情检索
show_namestringpoi子点简称
namestringpoi子点名称
如您需要获取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/suggestion';
// 构造请求参数
$param['query']='天安门';
$param['region']='北京';
$param['city_limit']='true';
$param['output']='json';
$param['ak']= $ak;
$res =request_get($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res ."\n");
?>
{
"status":0,
"message":"ok",
"result":[
{
"name":"天安门广场",
"location":{
"lat":39.909652,
"lng":116.404177
},
"uid":"c9b5fb91d49345bc5d0d0262",
"province":"北京市",
"city":"北京市",
"district":"东城区",
"business":"",
"cityid":"131",
"tag":"旅游景点",
"address":"北京市-东城区-东长安街",
"children":[
{
"uid":"797c4f6023068d0ceedfcaf9",
"name":"天安门广场-出入口 北京市东城区",
"show_name":"出入口"
},
{
"uid":"ad764cbdedc637ec6d3e1b91",
"name":"天安门广场-出口 北京市东城区",
"show_name":"出口"
}
],
"adcode":"110101"
},
{
"name":"天安门",
"location":{
"lat":39.915119,
"lng":116.403963
},
"uid":"65e1ee886c885190f60e77ff",
"province":"北京市",
"city":"北京市",
"district":"东城区",
"business":"",
"cityid":"131",
"tag":"古建筑",
"address":"北京市-东城区-长安街",
"children":[
],
"adcode":"110101"
},
{
"name":"天安门东-地铁站",
"location":{
"lat":39.914082,
"lng":116.407913
},
"uid":"940aeb3c98d5a0218a2fb5de",
"province":"北京市",
"city":"北京市",
"district":"东城区",
"business":"",
"cityid":"131",
"tag":"地铁站",
"address":"",
"children":[
],
"adcode":"110101"
},
{
"name":"天安门广场-国旗",
"location":{
"lat":39.91328,
"lng":116.403931
},
"uid":"4ae2adcf574bcd2b38221c66",
"province":"北京市",
"city":"北京市",
"district":"东城区",
"business":"",
"cityid":"131",
"tag":"旅游景点",
"address":"北京市-东城区-天安门广场内",
"children":[
],
"adcode":"110101"
},
{
"name":"天安门西-地铁站",
"location":{
"lat":39.913776,
"lng":116.398036
},
"uid":"002975204d3b1e9b9968b4de",
"province":"北京市",
"city":"北京市",
"district":"西城区",
"business":"",
"cityid":"131",
"tag":"地铁站",
"address":"",
"children":[
],
"adcode":"110102"
},
{
"name":"天安门东地铁站-b口",
"uid":"448961a899f372b7077ce838",
"province":"",
"city":"",
"district":"",
"business":"",
"cityid":"131",
"tag":"",
"address":"北京市-东城区",
"children":[
]
},
{
"name":"天安门-入口",
"location":{
"lat":39.914939,
"lng":116.404137
},
"uid":"fd975efc10193656734b879a",
"province":"北京市",
"city":"北京市",
"district":"东城区",
"business":"",
"cityid":"131",
"tag":"出入口",
"address":"北京市-东城区-天安门内",
"children":[
],
"adcode":"110101"
},
{
"name":"天安门广场东-公交车站",
"location":{
"lat":39.908018,
"lng":116.405975
},
"uid":"bc3118720ad264138a36ee6f",
"province":"北京市",
"city":"北京市",
"district":"东城区",
"business":"",
"cityid":"131",
"tag":"公交站",
"address":"",
"children":[
],
"adcode":"110101"
},
{
"name":"天安门-城楼检票处(入口)",
"location":{
"lat":39.915739,
"lng":116.403663
},
"uid":"f7a0d122f3307a767dc876f1",
"province":"北京市",
"city":"北京市",
"district":"东城区",
"business":"",
"cityid":"131",
"tag":"出入口",
"address":"北京市-东城区-天安门内",
"children":[
],
"adcode":"110101"
},
{
"name":"天安门东-公交车站",
"location":{
"lat":39.914198,
"lng":116.408332
},
"uid":"947c13ba353f9123dbd891fb",
"province":"北京市",
"city":"北京市",
"district":"东城区",
"business":"",
"cityid":"131",
"tag":"公交站",
"address":"",
"children":[
],
"adcode":"110101"
}
]
}
在线运行
参数备注必选
query
输入建议关键字(支持拼音)
region
支持城市及对应百度编码()。(指定的区域的返回结果加权,可能返回其他城市高权重结果。若要对返回结果区域严格限制,请使用city_limit参数)
city_limit
取值为'true',仅返回region中指定城市检索结果
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当前并发量已经超过约定并发配额,限制访问并发控制超限,请控制并发量或

上一篇

地点详情检索

下一篇

获取poi图片

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

网站地图