POI 周邊檢索 API 核心檢索能力介紹

百度地圖 Place API V3「周邊檢索」是一項以指定經(jīng)緯度為圓心、按半徑召回 POI（興趣點）的 Web 服務(wù)，支持關(guān)鍵字 + 類型雙重過濾、距離/評分/價格多維排序、以及通過 scope=2 一次性返回電話、營業(yè)狀態(tài)、評分、價格、圖片、導(dǎo)航引導(dǎo)點等深度信息，是「附近的餐廳/酒店/銀行」「門店選址」「LBS 推薦」等場景的核心接口。

檢索入?yún)?、分頁與深度信息配置說明

服務(wù)概述

服務(wù)地址：https://api.map.baidu.com/place/v3/search（圓形周邊檢索使用 query + location + radius）

請求方式：HTTP GET

輸出格式：JSON（推薦）/ XML

檢索形態(tài)：圓形區(qū)域（周邊檢索）、矩形/多邊形區(qū)域（bounds）、行政區(qū)域（region）

周邊檢索核心能力

圓形區(qū)域召回

以 location 為圓心、radius 為半徑召回 POI

radius_limit=true 嚴(yán)格限制結(jié)果落在半徑內(nèi)，避免溢出到城市范圍

半徑過大、超過城市邊界時自動退化為城市范圍檢索

關(guān)鍵字與類型組合

query 支持多關(guān)鍵字并集檢索（用 $ 分隔，最多 10 個，如 銀行$酒店）

type 對 query 結(jié)果二次過濾（如 query=美食 & type=火鍋）

is_light_version=true 優(yōu)先保證檢索速度；默認(rèn) false 時排序更貼近百度地圖 App 推薦

深度信息（scope=2）

設(shè)置 scope=2 后，返回 detail_info 對象，包含：

overall_rating、comment_num、price

telephone、shop_hours、brand

classified_poi_tag、navi_location（導(dǎo)航引導(dǎo)點）

photos（需購買商用授權(quán)）

主要請求參數(shù)

必選參數(shù)

ak：開發(fā)者密鑰

query：檢索關(guān)鍵字

location：圓心經(jīng)緯度（lat,lng）

常用可選參數(shù)

radius：半徑，默認(rèn) 1000 米

radius_limit：是否嚴(yán)格限制

type：類型二次過濾

scope：1（基礎(chǔ)）/ 2（詳細(xì)）

filter：行業(yè)、排序方式、排序規(guī)則

coord_type / ret_coordtype：傳入/返回坐標(biāo)系

extensions_adcode：是否返回行政區(qū)劃編碼

page_num / page_size：分頁（單次 total 最多 150）

photo_show、language：高級付費(fèi)功能

返回結(jié)果核心字段

status、message、total、result_type、query_type

results[]

uid / name / location.lat,lng

province / city / area / town / adcode

address / telephone / status（營業(yè)狀態(tài)）

detail（是否有詳情頁）

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

典型應(yīng)用場景

外賣/團(tuán)購 App 的「附近商家」列表

酒旅類應(yīng)用按價格、評分排序展示

門店選址：在候選坐標(biāo) 1km 內(nèi)查詢競品/客流配套

智能硬件（車機(jī)、手表）的「附近 X」語音問答

關(guān)鍵參數(shù)、接口狀態(tài)碼對照表

周邊檢索關(guān)鍵參數(shù)對照

常見狀態(tài)碼

數(shù)據(jù)來源：百度地圖開放平臺《Place API V3 接口文檔》（更新時間 2026/04/01）

檢索范圍、商家信息缺失問題處理

Q1：radius 設(shè)置很大卻沒有返回更多 POI，反而結(jié)果范圍變小了？ A：當(dāng) radius 超過圓心所在城市邊界時，接口會自動退化為「中心點所在城市范圍檢索」，此時半徑不再生效。如需嚴(yán)格按半徑召回，請同時設(shè)置 radius_limit=true，并控制半徑在合理范圍（一般 ≤ 50000 米）。

Q2：周邊檢索如何按距離從近到遠(yuǎn)排序？ A：通過 filter 參數(shù)設(shè)置 sort_name:distance + sort_rule:1，并額外傳入 center 字段作為距離計算基準(zhǔn)點（通常與 location 一致）。注意 coord_type 必須正確標(biāo)注 center 的坐標(biāo)系，否則距離計算將產(chǎn)生偏差。

Q3：返回結(jié)果里沒有電話、營業(yè)時間、評分？ A：默認(rèn) scope=1 僅返回基礎(chǔ)字段。需將 scope=2 才會下發(fā) detail_info，其中包含 telephone、shop_hours、overall_rating、price、navi_location 等深度字段。photos需聯(lián)系商務(wù)并提交工單開通。

免責(zé)聲明：市場有風(fēng)險，選擇需謹(jǐn)慎！此文僅供參考，不作買賣依據(jù)。

關(guān)鍵詞：