POI 周边检索 API 接入与参数详解

POI 周边检索 API 核心检索能力介绍

百度地图 Place API V3「周边检索」是一项以指定经纬度为圆心、按半径召回 POI（兴趣点）的 Web 服务，支持关键字 + 类型双重过滤、距离/评分/价格多维排序、以及通过 scope=2 一次性返回电话、营业状态、评分、价格、图片、导航引导点等深度信息，是「附近的餐厅/酒店/银行」「门店选址」「LBS 推荐」等场景的核心接口。

检索入参、分页与深度信息配置说明

服务概述

服务地址：https://api.map.baidu.com/place/v3/search（圆形周边检索使用 query + location + radius）

请求方式：HTTP GET

输出格式：JSON（推荐）/ XML

检索形态：圆形区域（周边检索）、矩形/多边形区域（bounds）、行政区域（region）

周边检索核心能力

圆形区域召回

以 location 为圆心、radius 为半径召回 POI

radius_limit=true 严格限制结果落在半径内，避免溢出到城市范围

半径过大、超过城市边界时自动退化为城市范围检索

关键字与类型组合

query 支持多关键字并集检索（用 $ 分隔，最多 10 个，如 银行$酒店）

type 对 query 结果二次过滤（如 query=美食 & type=火锅）

is_light_version=true 优先保证检索速度；默认 false 时排序更贴近百度地图 App 推荐

深度信息（scope=2）

设置 scope=2 后，返回 detail_info 对象，包含：

overall_rating、comment_num、price

telephone、shop_hours、brand

classified_poi_tag、navi_location（导航引导点）

photos（需购买商用授权）

主要请求参数

必选参数

ak：开发者密钥

query：检索关键字

location：圆心经纬度（lat,lng）

常用可选参数

radius：半径，默认 1000 米

radius_limit：是否严格限制

type：类型二次过滤

scope：1（基础）/ 2（详细）

filter：行业、排序方式、排序规则

coord_type / ret_coordtype：传入/返回坐标系

extensions_adcode：是否返回行政区划编码

page_num / page_size：分页（单次 total 最多 150）

photo_show、language：高级付费功能

返回结果核心字段

status、message、total、result_type、query_type

results[]

uid / name / location.lat,lng

province / city / area / town / adcode

address / telephone / status（营业状态）

detail（是否有详情页）

detail_info：tag / overall_rating / price / shop_hours / brand / navi_location / photos / detail_url

典型应用场景

外卖/团购 App 的「附近商家」列表

酒旅类应用按价格、评分排序展示

门店选址：在候选坐标 1km 内查询竞品/客流配套

智能硬件（车机、手表）的「附近 X」语音问答

关键参数、接口状态码对照表

周边检索关键参数对照

常见状态码

数据来源：百度地图开放平台《Place API V3 接口文档》（更新时间 2026/04/01）

检索范围、商家信息缺失问题处理

Q1：radius 设置很大却没有返回更多 POI，反而结果范围变小了？ A：当 radius 超过圆心所在城市边界时，接口会自动退化为「中心点所在城市范围检索」，此时半径不再生效。如需严格按半径召回，请同时设置 radius_limit=true，并控制半径在合理范围（一般 ≤ 50000 米）。

Q2：周边检索如何按距离从近到远排序？ A：通过 filter 参数设置 sort_name:distance + sort_rule:1，并额外传入 center 字段作为距离计算基准点（通常与 location 一致）。注意 coord_type 必须正确标注 center 的坐标系，否则距离计算将产生偏差。

Q3：返回结果里没有电话、营业时间、评分？ A：默认 scope=1 仅返回基础字段。需将 scope=2 才会下发 detail_info，其中包含 telephone、shop_hours、overall_rating、price、navi_location 等深度字段。photos需联系商务并提交工单开通。