服務
地圖服務概述
地圖服務是指那些提供資料資訊的接口，例如本地搜尋、路線規劃等等。百度地圖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());公車導航
# #BMap.TransitRoute類別提供公車導航搜尋服務。和本地搜尋類似，在搜尋之前需要指定搜尋區域，注意公車導航的區域範圍只能是市，而不能是省。如果搜尋區域為BMap.Map對象，路線結果會自動加入地圖上。如果您提供了結果容器，相應的路線描述也會顯示在頁面上。
var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);
var transit = new BMap.TransitRoute(map, {
renderOptions: {map: map}
});
transit.search("王府井", "西单");var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);
var transit = new BMap.TransitRoute(map, {
renderOptions: {map: map, panel: "results"}
});
transit.search("王府井", "西单");######資料介面
您可透過資料介面取得詳細的公車方案資訊。公車導航搜尋結果以BMap.TransitRouteResult來表示，其中包含了若干公車旅遊計畫（BMap.TransitRoutePlan）。每條出行方案由步行路線和公車路線組成。在起點到上車點之間、下車點到終點之間以及每個轉乘站之間都會存在步行線路，如果上述的某兩點位置重合，那麼其間的步行路線長度為0。
在下面範例中，透過資料介面將第一條方案的路線加入地圖上，並將所有方案的描述資訊輸出到頁面上
var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 12);
var transit = new BMap.TransitRoute("北京市");
transit.setSearchCompleteCallback(function(results){
if (transit.getStatus() == BMAP_STATUS_SUCCESS){
var firstPlan = results.getPlan(0);
// 绘制步行线路
for (var i = 0; i < firstPlan.getNumRoutes(); i ++){
var walk = firstPlan.getRoute(i);
if (walk.getDistance(false) > 0){
// 步行线路有可能为0
map.addOverlay(new BMap.Polyline(walk.getPoints(), {lineColor: "green"}));
}
}
// 绘制公交线路
for (i = 0; i < firstPlan.getNumLines(); i ++){
var line = firstPlan.getLine(i);
map.addOverlay(new BMap.Polyline(line.getPoints()));
}
// 输出方案信息
var s = [];
for (i = 0; i < results.getNumPlans(); i ++){
s.push((i + 1) + ". " + results.getPlan(i).getDescription());
}
document.getElementById("log").innerHTML = s.join("<br>");
}
})
transit.search("中关村", "国贸桥");開車導航
BMap.DrivingRoute提供駕駛導航服務。與公車導航不同的是，駕車導航的搜尋範圍可以設定為省。
下面範例展示如何使用駕車導航介面：
var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);
var driving = new BMap.DrivingRoute(map, {
renderOptions: {
map: map,
autoViewport: true
}
});
driving.search("中关村", "天安门");結果面板
下面在範例中，我們提供了結果面板參數，方案描述會自動顯示到頁面上。
var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);
var driving = new BMap.DrivingRoute(map, {
renderOptions: {
map : map,
panel : "results",
autoViewport: true
}
});
driving.search("中关村", "天安门");資料接口
#駕駛導航服務也提供了豐富的資料接口，透過onSearchComplete回呼函數可以得到BMap.DrivingRouteResult對象，它包含了駕駛導航結果資料資訊。結果會包含若干駕車方案（目前僅提供一條方案），每條方案中包含了若干駕車線路（如果導航方案只包含一個目的地，那麼駕車線路的個數就為1，如果方案包含若干個目的地，則駕車線路的個數會大於1。目前API尚不支援多個目的地的駕車導航）。每條駕車線路又會包含一系列的關鍵步驟（BMap.Step），關鍵步驟描述了具體駕車行駛方案，可透過BMap.Step.getDescription()方法取得。
var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);
var options = {
onSearchComplete: function(results){
if (driving.getStatus() == BMAP_STATUS_SUCCESS){
// 获取第一条方案
var plan = results.getPlan(0);
// 获取方案的驾车线路
var route = plan.getRoute(0);
// 获取每个关键步骤，并输出到页面
var s = [];
for (var i = 0; i < route.getNumSteps(); i ++){
var step = route.getStep(i);
s.push((i + 1) + ". " + step.getDescription());
}
document.getElementById("log").innerHTML = s.join("<br>");
}
}
};
var driving = new BMap.DrivingRoute(map, options);
driving.search("中关村", "天安门");步行導航介面在使用上與駕車導航一致，請參考API文件
地理編碼
##地理編碼能夠將地址資訊轉換為地理座標點資訊。根據位址描述獲得座標
百度地圖API提供Geocoder類別進行位址解析，您可以透過Geocoder.getPoint()方法將一段位址描述轉換為一個座標。在下面的範例中，我們將獲得地址「北京市海淀區上地10街10號」的地理座標位置，並在這個位置上加上一個標註。注意在呼叫Geocoder.getPoint()方法時您需要提供地址解析所在的城市（本例為「北京市」）。var map = new BMap.Map("l-map");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11);
// 创建地址解析器实例
var myGeo = new BMap.Geocoder();
// 将地址解析结果显示在地图上，并调整地图视野
myGeo.getPoint("北京市海淀区上地10街10号", function(point){
if (point) {
map.centerAndZoom(point, 16);
map.addOverlay(new BMap.Marker(point));
}
}, "北京市");反向地理編碼
反向地理編碼的過程正好相反，它根據一個座標點得到一個地址的描述。您可以透過Geocoder.getLocation()方法取得地址描述。當解析工作完成後，您提供的回呼函數將會被觸發。如果解析成功，則回呼函數的參數為GeocoderResult對象，否則為null。var map = new BMap.Map("l-map");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11);
// 创建地理编码实例
var myGeo = new BMap.Geocoder();
// 根据坐标得到地址描述
myGeo.getLocation(new BMap.Point(116.364, 39.993), function(result){
if (result){
alert(result.address);
}
});
