地圖除了「看」,更重要的是「找」。百度地圖把各類檢索服務抽象成 Service 物件,其中 LocalSearch 是最常用的一個,除了基本的關鍵字檢索,還提供周邊搜索與矩形範圍搜索兩種變體。本文把這幾種用法與設定方式整理清楚。
所謂地圖服務,指的是提供資料資訊的接口:
· LocalSearch:本地搜索,在特定區域內搜尋地點,例如「北京市的公園」。
· TransitRoute:公交導航,提供公交出行方案。
· DrivingRoute:駕車導航。
· WalkingRoute:步行導航。
· Geocoder:地址解析,把地址文字轉為座標。
· LocalCity:本地城市,自動判斷目前所在城市。
· TrafficControl:實時路況控件。
重點:所有搜索類服務都必須指定一個搜索範圍,否則接口無法工作。
BMap.LocalSearch 的檢索區域可以是 BMap.Map 物件、BMap.Point 物件,或省市名稱字串。建構時的第二個參數可選,用來指定結果的呈現方式;BMap.RenderOptions 提供 map(結果標注畫在哪張地圖)與 panel(結果列表放進哪個容器)兩個關鍵屬性。
var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11);
var local = new BMap.LocalSearch(map, {
renderOptions: { map: map }
});
local.search("天安門");
LocalSearch 提供若干設定方法,可自訂每頁結果數、是否自動調整視野、是否顯示資訊視窗等:
var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);
var local = new BMap.LocalSearch("北京市", {
renderOptions: { map: map, autoViewport: true }, // 依結果自動調整視野
pageCapacity: 8 // 每頁顯示 8 筆
});
local.search("中關村");
設定 renderOptions.panel 屬性後,搜索結果會自動生成列表塞進該容器:
var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11);
var local = new BMap.LocalSearch(map, {
renderOptions: { map: map, panel: "results" }
});
local.search("中關村");
若不希望自動呈現,而是自行控制標注與資訊視窗,可用回呼函數取得資料。onSearchComplete 會傳入 BMap.LocalResult 實例,呼叫 getStatus() 則可確認本次搜索是否成功:
var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11);
var options = {
onSearchComplete: function(results){
if (local.getStatus() == BMAP_STATUS_SUCCESS) {
var s = [];
for (var i = 0; i < results.getCurrentNumPois(); i++) {
s.push(results.getPoi(i).title + ", " + results.getPoi(i).address);
}
document.getElementById("log").innerHTML = s.join("<br>");
}
}
};
var local = new BMap.LocalSearch(map, options);
local.search("公園");
實務上有個小陷阱:onSearchComplete 在查無結果或出錯時也會觸發,所以一定要先判斷 getStatus(),否則 results.getCurrentNumPois() 會拿到 0 甚至拋錯。
searchNearby 可在某個地點周圍搜尋,第二個參數可以是地名或 Point:
var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11);
var local = new BMap.LocalSearch(map, {
renderOptions: { map: map, autoViewport: true }
});
local.searchNearby("小吃", "前門");
searchInBounds 依視野或自訂矩形範圍檢索。範圍過大時可能查不到結果:
var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);
var local = new BMap.LocalSearch(map, {
renderOptions: { map: map }
});
// 在当前地圖視野範圍內搜索
local.searchInBounds("銀行", map.getBounds());
用 BMap.Bounds 指定對角兩點,並順手畫出一個多邊形把範圍視覺化:
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
<style type="text/css">
body, html { width:100%; height:100%; margin:0; font-family:"微軟雅黑"; }
#allmap{ width:100%; height:500px; }
p{ margin-left:5px; font-size:14px; }
</style>
<script type="text/javascript" src="https://api.map.baidu.com/api?v=2.0&ak=您的密鑰"></script>
<title>搜索區域內關鍵詞</title>
</head>
<body>
<div id="allmap"></div>
<p>返回北京市矩形框區域範圍內的「銀行」關鍵字的檢索結果,並展示在地圖上</p>
</body>
</html>
<script type="text/javascript">
var map = new BMap.Map("allmap");
map.centerAndZoom(new BMap.Point(116.274625, 39.961627), 11);
map.enableScrollWheelZoom(); // 啟用滾輪縮放
var local = new BMap.LocalSearch(map, { renderOptions: { map: map } });
// 對角兩點定義矩形
var pStart = new BMap.Point(116.274625, 39.961627);
var pEnd = new BMap.Point(116.367474, 39.988609);
var bs = new BMap.Bounds(pStart, pEnd);
local.searchInBounds("銀行", bs);
// 把範圍畫出來,方便確認查的是哪一塊
var polygon = new BMap.Polygon([
new BMap.Point(pStart.lng, pStart.lat),
new BMap.Point(pEnd.lng, pStart.lat),
new BMap.Point(pEnd.lng, pEnd.lat),
new BMap.Point(pStart.lng, pEnd.lat)
], { strokeColor: "blue", strokeWeight: 6, strokeOpacity: 0.5 });
map.addOverlay(polygon);
</script>

1. 關鍵字 + 城市:最簡單,適合「查某個地標在哪」。
2. searchNearby:適合「我附近」「這家店周邊」的情境,行動端搭配定位格外好用。
3. searchInBounds:適合地圖拖動後查「目前畫面內」的結果,是房產、外送平台常見的做法。
4. 记得处理分頁。LocalSearch 預設有每頁筆數限制,需要更多結果時要串接 gotoPage 並在 onSearchComplete 中判斷是否有下一頁。
5. ak 請勿硬編碼在前端可見的位置以外的用途。雖然 JS API 的 ak 註定會暴露在原始碼中,仍應在百度控制台設定 referer 白名單,避免被盜用消耗配額。