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需聯系商務并提交工單開通。

免責聲明：市場有風險，選擇需謹慎！此文僅供參考，不作買賣依據。

關鍵詞：