百度地圖API之本地搜尋與範圍搜尋
地圖服務是指可以提供資料資訊的介面，比如說本地搜尋/路線規劃等，下面小編給大家整理下百度地圖API之本地搜尋和範圍搜尋，具體請看下文。
地圖服務概述
地圖服務是指那些提供資料資訊的介面，比如本地搜尋、路線規劃等等。百度地圖API提供的服務有：
LocalSearch：本地搜尋，提供某一特定地區的位置搜尋服務，比如在北京市搜尋“公園”。
TransitRoute：公交導航，提供某一特定地區的公交出行方案的搜尋服務。
DrivingRoute：駕車導航，提供駕車出行方案的搜尋服務。
WalkingRoute：步行導航，提供步行出行方案的搜尋服務。
Geocoder：地址解析，提供將地址資訊轉換為座標點資訊的服務。
LocalCity
TrafficControl：實時路況控制元件，提供實時和歷史路況資訊服務。
搜尋類的服務介面需要指定一個搜尋範圍，否則介面將不能工作。
本地搜尋
BMap.LocalSearch提供本地搜尋服務，在使用本地搜尋時需要為其設定一個檢索區域，檢索區域可以是BMap.Map物件、 BMap.Point物件或者是省市名稱（比如："北京市"）的字串。BMap.LocalSearch建構函式的第二個引數是可選的，您可以在其中指 定結果的呈現。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("天安門");
另外，BMap.LocalSearch還提包含searchNearby和searchInBounds方法，為您提供周邊搜尋和範圍搜尋服務。
配置搜尋
BMap.LocalSearch提供了若干配置方法，通過它們可以自定義搜尋服務的行為以滿足您的需求。 在下面的示例中，我們調整每頁顯示8個結果，並且根據結果點位置自動調整地圖視野，不顯示第一條結果的資訊視窗：
複製程式碼程式碼如下: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});
local.search("中關村");
結果面板
通過設定BMap.LocalSearchOptions.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("中關村");
資料介面
除了搜尋結果會自動新增到地圖和列表外，您還可以通過資料介面獲得詳細的資料資訊，結合地圖API您可以自行向地圖新增標註和資訊視窗。 BMap.LocalSearch和BMap.LocalSearchOptions類提供了若干設定回撥函式的介面，通過它們可得到搜尋結果的資料信 息。 例如，通過onSearchComplete回撥函式引數可以獲得BMap.LocalResult物件例項，它包含了每一次搜尋結果的資料資訊。 當回撥函式被執行時，您可以使用BMap.LocalSearch.getStatus()方法來確認搜尋是否成功或者得到錯誤的詳細資訊。
在下面這個示例中，通過onSearchComplete回撥函式得到第一頁每條結果的標題和地址資訊，並輸出到頁面上：
複製程式碼程式碼如下: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("公園");
周邊搜尋
通過周邊搜尋服務，您可以在某個地點附近進行搜尋，也可以在某一個特定結果點周圍進行搜尋。
下面示例展示如何在前門附近搜尋小吃：
複製程式碼程式碼如下: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("小吃", "前門");
矩形範圍搜尋
矩形範圍搜尋將根據您提供的視野範圍提供搜尋結果。注意：當搜尋範圍過大時可能會出現無結果的情況。
下面示例展示在當前地圖視野範圍內搜尋銀行：
複製程式碼程式碼如下: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());
矩形區域搜尋例子
<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="http://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">
// 百度地圖API功能
var map = new BMap.Map("allmap"); // 建立Map例項
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>