服務(wù)
地圖服務(wù)概述
地圖服務(wù)是指那些提供數(shù)據(jù)信息的接口，比如本地搜索、路線規(guī)劃等等。百度地圖API提供的服務(wù)有：
LocalSearch：本地搜索，提供某一特定地區(qū)的位置搜索服務(wù)，比如在北京市搜索“公園”。
TransitRoute：公交導(dǎo)航，提供某一特定地區(qū)的公交出行方案的搜索服務(wù)。
DrivingRoute：駕車導(dǎo)航，提供駕車出行方案的搜索服務(wù)。
WalkingRoute：步行導(dǎo)航，提供步行出行方案的搜索服務(wù)。
Geocoder：地址解析，提供將地址信息轉(zhuǎn)換為坐標(biāo)點信息的服務(wù)。
LocalCity：本地城市，提供自動判斷您所在城市的服務(wù)。
TrafficControl：實時路況控件，提供實時和歷史路況信息服務(wù)。
搜索類的服務(wù)接口需要指定一個搜索范圍，否則接口將不能工作。
本地搜索
BMap.LocalSearch提供本地搜索服務(wù)，在使用本地搜索時需要為其設(shè)置一個檢索區(qū)域，檢索區(qū)域可以是BMap.Map對象、BMap.Point對象或者是省市名稱（比如："北京市"）的字符串。BMap.LocalSearch構(gòu)造函數(shù)的第二個參數(shù)是可選的，您可以在其中指定結(jié)果的呈現(xiàn)。BMap.RenderOptions類提供了若干控制呈現(xiàn)的屬性，其中map指定了結(jié)果所展現(xiàn)的地圖實例，panel指定了結(jié)果列表的容器元素。
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方法，為您提供周邊搜索和范圍搜索服務(wù)。
配置搜索
BMap.LocalSearch提供了若干配置方法，通過它們可以自定義搜索服務(wù)的行為以滿足您的需求。 在下面的示例中，我們調(diào)整每頁顯示8個結(jié)果，并且根據(jù)結(jié)果點位置自動調(diào)整地圖視野，不顯示第一條結(jié)果的信息窗口：
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("中關(guān)村");結(jié)果面板
通過設(shè)置BMap.LocalSearchOptions.renderOptions.panel屬性，可以為本地搜索對象提供一個結(jié)果列表容器，搜索結(jié)果會自動添加到容器元素中。請看下面示例：
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("中關(guān)村");數(shù)據(jù)接口
除了搜索結(jié)果會自動添加到地圖和列表外，您還可以通過數(shù)據(jù)接口獲得詳細(xì)的數(shù)據(jù)信息，結(jié)合地圖API您可以自行向地圖添加標(biāo)注和信息窗口。BMap.LocalSearch和BMap.LocalSearchOptions類提供了若干設(shè)置回調(diào)函數(shù)的接口，通過它們可得到搜索結(jié)果的數(shù)據(jù)信息。 例如，通過onSearchComplete回調(diào)函數(shù)參數(shù)可以獲得BMap.LocalResult對象實例，它包含了每一次搜索結(jié)果的數(shù)據(jù)信息。 當(dāng)回調(diào)函數(shù)被執(zhí)行時，您可以使用BMap.LocalSearch.getStatus()方法來確認(rèn)搜索是否成功或者得到錯誤的詳細(xì)信息。
在下面這個示例中，通過onSearchComplete回調(diào)函數(shù)得到第一頁每條結(jié)果的標(biāo)題和地址信息，并輸出到頁面上：
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){
// 判斷狀態(tài)是否正確
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("公園");周邊搜索
通過周邊搜索服務(wù)，您可以在某個地點附近進(jìn)行搜索，也可以在某一個特定結(jié)果點周圍進(jìn)行搜索。
下面示例展示如何在前門附近搜索小吃：
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("小吃", "前門");矩形范圍搜索
矩形范圍搜索將根據(jù)您提供的視野范圍提供搜索結(jié)果。注意：當(dāng)搜索范圍過大時可能會出現(xiàn)無結(jié)果的情況。
下面示例展示在當(dāng)前地圖視野范圍內(nèi)搜索銀行：
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());公交導(dǎo)航
BMap.TransitRoute類提供公交導(dǎo)航搜索服務(wù)。和本地搜索類似，在搜索之前需要指定搜索區(qū)域，注意公交導(dǎo)航的區(qū)域范圍只能是市，而不能是省。如果搜索區(qū)域為BMap.Map對象，路線結(jié)果會自動添加到地圖上。如果您提供了結(jié)果容器，相應(yīng)的路線描述也會展示在頁面上。
下面示例展示了如何使用公交導(dǎo)航服務(wù)：
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("王府井", "西單");結(jié)果面板 您可以提供用于展示文字結(jié)果的容器元素，方案結(jié)果會自動在頁面中展現(xiàn)：
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("王府井", "西單");數(shù)據(jù)接口
您可通過數(shù)據(jù)接口獲取詳細(xì)的公交方案信息。公交導(dǎo)航搜索結(jié)果用BMap.TransitRouteResult來表示，其中包含了若干公交出行方案（BMap.TransitRoutePlan）。每條出行方案由步行線路和公交線路組成。 在起點到上車點之間、下車點到終點之間以及每個換乘站之間都會存在步行線路，如果上述的某兩點位置重合，那么其間的步行路線長度為0。
在下面示例中，通過數(shù)據(jù)接口將第一條方案的路線添加到地圖上，并將所有方案的描述信息輸出到頁面上
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("中關(guān)村", "國貿(mào)橋");駕車導(dǎo)航
BMap.DrivingRoute提供駕車導(dǎo)航服務(wù)。與公交導(dǎo)航不同的是，駕車導(dǎo)航的搜索范圍可以設(shè)置為省。
下面示例展示了如何使用駕車導(dǎo)航接口：
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("中關(guān)村", "天安門");結(jié)果面板
下面示例中，我們提供了結(jié)果面板參數(shù)，方案描述會自動展示到頁面上。
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("中關(guān)村", "天安門");數(shù)據(jù)接口
駕車導(dǎo)航服務(wù)也提供了豐富的數(shù)據(jù)接口，通過onSearchComplete回調(diào)函數(shù)可以得到BMap.DrivingRouteResult對象，它包含了駕車導(dǎo)航結(jié)果數(shù)據(jù)信息。 結(jié)果會包含若干駕車方案（目前僅提供一條方案），每條方案中包含了若干駕車線路（如果導(dǎo)航方案只包含一個目的地，那么駕車線路的個數(shù)就為1，如果方案包含若干個目的地，則駕車線路的個數(shù)會大于1。目前API尚不支持多個目的地的駕車導(dǎo)航）。 每條駕車線路又會包含一系列的關(guān)鍵步驟（BMap.Step），關(guān)鍵步驟描述了具體駕車行駛方案，可通過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);
// 獲取每個關(guān)鍵步驟，并輸出到頁面
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("中關(guān)村", "天安門");步行導(dǎo)航接口在使用上與駕車導(dǎo)航一致，具體請參考API文檔
地理編碼
地理編碼能夠?qū)⒌刂沸畔⑥D(zhuǎn)換為地理坐標(biāo)點信息。
根據(jù)地址描述獲得坐標(biāo)
百度地圖API提供Geocoder類進(jìn)行地址解析，您可以通過Geocoder.getPoint()方法來將一段地址描述轉(zhuǎn)換為一個坐標(biāo)。在下面的示例中，我們將獲得地址“北京市海淀區(qū)上地10街10號”的地理坐標(biāo)位置，并在這個位置上添加一個標(biāo)注。注意在調(diào)用Geocoder.getPoint()方法時您需要提供地址解析所在的城市（本例為“北京市”）。
var map = new BMap.Map("l-map");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11);
// 創(chuàng)建地址解析器實例
var myGeo = new BMap.Geocoder();
// 將地址解析結(jié)果顯示在地圖上，并調(diào)整地圖視野
myGeo.getPoint("北京市海淀區(qū)上地10街10號", function(point){
if (point) {
map.centerAndZoom(point, 16);
map.addOverlay(new BMap.Marker(point));
}
}, "北京市");反向地理編碼
反向地理編碼的過程正好相反，它根據(jù)一個坐標(biāo)點得到一個地址的描述。您可以通過Geocoder.getLocation()方法獲得地址描述。當(dāng)解析工作完成后，您提供的回調(diào)函數(shù)將會被觸發(fā)。如果解析成功，則回調(diào)函數(shù)的參數(shù)為GeocoderResult對象，否則為null。
var map = new BMap.Map("l-map");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11);
// 創(chuàng)建地理編碼實例
var myGeo = new BMap.Geocoder();
// 根據(jù)坐標(biāo)得到地址描述
myGeo.getLocation(new BMap.Point(116.364, 39.993), function(result){
if (result){
alert(result.address);
}
});