开始使用 | 百度地图API SDK

所有文档

地点检索2.0

服务概览

快速开始

使用准备开始使用

接口文档

服务功能

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

进阶能力

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

相关资料

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

更新时间: 2026/04/01 19:58

开始使用

行政区划区域检索

前往示例中心在线体验

本示例为请求检索北京市内的银行ATM机

API服务地址

https://api.map.baidu.com/place/v2/search?query=ATM机&tag=银行&region=北京&output=json&ak=您的ak
//GET请求

圆形区域检索

前往示例中心在线体验

设置圆心和半径，检索圆形区域内的地点信息（常用于周边检索场景）。

API服务地址

https://api.map.baidu.com/place/v2/search?query=银行&location=39.915,116.404&radius=2000&output=json&ak=您的密钥
//GET请求

多边形区域检索

前往示例中心在线体验

开发者可使用多边形区域检索传入多个坐标对，首尾坐标对需相同，坐标对用”,”分割；多边形为矩形时，可传入左上右下两顶点坐标对。即可获取地点（POI）基础或详细地理信息。

API服务地址

http://api.map.baidu.com/place/v2/search?query=银行&bounds=39.915,116.404,39.975,116.414&output=json&ak=您的密钥
//GET请求

地点详情检索

前往示例中心在线体验

不同于其他三种检索功能。地点详情检索针对指定POI，检索其相关的详情信息。开发者可以通过三种区域检索（或其他服务）功能，获取POI uid。使用“地点详情检索”功能，传入uid，即可检索POI详情信息，如评分、营业时间等（不同类型POI对应不同类别详情数据）。

API服务地址

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

地点输入提示

前往示例中心在线体验

接口说明

用户可通过该服务，匹配用户输入关键词的地点推荐列表。在应用方面，可将地点推荐列表展示给用户，用户可通过点击等交互方式，结合地点检索服务，检索用户点击的POI信息，实现地点详情检索功能。

API服务地址

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

服务状态码

返回码	英文描述	定义	常见原因
返回码	英文描述	定义	常见原因
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		当前并发量已经超过约定并发配额，限制访问	并发控制超限，请控制并发量或联系我们

使用准备

行政区划区域检索

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