百度地圖API之如何制作公交導航
前面我們介紹過駕車導航了，今天來說說公交導航。
什么是公交導航
公交導航功能是告訴使用者從A到B的公交出行方案，而不是某條具體的公交線路信息，這一點需要廣大開發者注意。
公交導航功能通過類TransitRoute來實現，這里需要說說為啥不是BusRoute，而是TransitRoute。百度提供的是公共交通導航，公共交通不僅僅涉及bus，可能還會有地鐵、渡輪甚至以后的飛機火車，所以這里使用的是public transit中的transit進行描述。
一個簡單的例子
我們還是從一個簡單的例子開始：
- var transit = new BMap.TransitRoute('北京', {
- renderOptions: {
- map: map,
- panel: 'panel'
- }
- });
- transit.search('頤和園', '西單');
代碼通過renderOptions設置渲染的地圖實例和側欄面板容器的id，其中map是已經實例化好的地圖，panel為已經準備好的div元素的id。我們會看到如下結果：
地圖上顯示了一個方案，在面板中列出了所有方案的描述，點擊不同的方案地圖會予以展示。除了使用字符串類型以外，還可以提供坐標進行查詢，這樣可以得到更精確的結果。比如從“麥當勞”到“肯德基”這樣的路線查詢就不會得到結果，因為API不知道是從哪個麥當勞到哪個肯德基。下面的示例使用了坐標進行搜索。
- transit2.search(new BMap.Point(116.315157,39.987946),
- new BMap.Point(116.371499,39.880394));
下面是使用坐標作為參數進行查詢得到的結果：
注意，由于提供的是坐標，所以起點和終點沒有具體的地點描述。
自定義覆蓋物展示
如果你不滿意API提供的默認線路的顏色和標注的樣式，你也可以選擇通過通過數據接口自行創建。注意，自己創建覆蓋物時，點擊列表中的方案將不會更新地圖區域，因為此時地圖區域的元素都是由開發者自行創建的。在使用數據接口之前，先通過一個結構圖來了解一個完整的公交方案的各個組成部分，以方便理解：
一個不需要換乘的公交方案是由：起點、起點到上車站的步行線路、上車站到下車站的公交線路以及下車站到終點的步行線路構成。當然有可能起點和上車站是重合的，或者終點和下車站是重合的，此時步行線路長度就為0(起點或終點本身就為公交站的時候)。如果有換乘，那么每次換乘中的下車站到上車站也有步行線路(如上圖的第二個方案所示)。
所以不論公交方案具體是什么樣，在數據上的表示都是一致的：
◆ 直達方案：2條步行線路 + 1條公交線路
◆ 換乘一次方案：3條步行線路 + 2條公交線路
◆ 換乘兩次方案：4條步行線路 + 3條公交線路
以此類推。
API中通過TransitRouteResult來描述公交導航結果，通過TransitRoutePlan來描述一條公交方案。那么怎么獲取公交導航結果和具體的方案的信息呢?請看下面的示例：
- var transit = new BMap.TransitRoute('北京', {
- onSearchComplete: function(result) {
- if (transit.getStatus() == BMAP_STATUS_SUCCESS) {
- // 從結果對象中獲取起點和終點信息
- var start = result.getStart();
- var end = result.getEnd();
- addStart(start.point, start.title);
- addEnd(end.point, end.title);
- // 直接獲取***個方案
- var plan = result.getPlan(0);
- // 遍歷所有步行線路
- for (var i = 0; i < plan.getNumRoutes(); i++) {
- if (plan.getRoute(i).getDistance(false) > 0) {
- // 判斷只有大于0的步行線路才會繪制
- addWalkRoute(plan.getRoute(i).getPath());
- }
- }
- // 遍歷所有公交線路
- var allLinePath = [];
- for (i = 0; i < plan.getNumLines(); i++) {
- allLinePathallLinePath = allLinePath.concat(plan.getLine(i).getPath());
- addLine(plan.getLine(i).getPath());
- }
- // ***根據公交線路的點設置地圖視野
- map.setViewport(allLinePath);
- }
- }
- });
- transit.search('清華大學', '北京交通大學');
- // 添加起點覆蓋物
- function addStart(point, title){
- map.addOverlay(new BMap.Marker(point, {
- title: title,
- icon: new BMap.Icon('http://images.cnblogs.com/cnblogs_com/jz1108/329471/o_blue.png', new BMap.Size(38, 41), {
- anchor: new BMap.Size(4, 36)
- })}));
- }
- // 添加終點覆蓋物
- function addEnd(point, title){
- map.addOverlay(new BMap.Marker(point, {
- title: title,
- icon: new BMap.Icon('http://images.cnblogs.com/cnblogs_com/jz1108/329471/o_red.png', new BMap.Size(38, 41), {
- anchor: new BMap.Size(4, 36)
- })}));
- }
- // 添加路線
- function addWalkRoute(path){
- map.addOverlay(new BMap.Polyline(path, {
- strokeColor: 'black',
- strokeOpacity: 0.7,
- strokeWeight: 4,
- strokeStyle: 'dashed',
- enableClicking: false
- }));
- }
- function addLine(path){
- map.addOverlay(new BMap.Polyline(path, {
- strokeColor: 'blue',
- strokeOpacity: 0.6,
- strokeWeight: 5,
- enableClicking: false
- }));
- }
在上面的代碼中，通過TransitRouteOptions的onSearchComplete屬性設置了回調函數，一旦檢索完成這個回調函數就會被調用。在回調函數開始我們先判斷檢索是否成功，如果成功表示至少有一條公交方案返回，這里我們先通過結果對象獲取起點和終點，接著直接獲取***條方案，遍歷方案中所有步行線路和公交線路并繪制在地圖上，***我們根據公交線路的點來設置一個合適的地圖視野。
你會在瀏覽器中得到如下效果：
在獲取結果對象時，除了通過回調函數參數獲取以外，還可以通過TransitRoute的getResults方法獲得，需要注意的是，由于搜索過程是異步的，以下代碼的寫法將不會得到結果：
- transit.search('西單', '頤和園');
- var res = transit.getResults(); // undefined
因為search方法調用結束后搜索結果并沒有立即返回。開發者可以在回調函數中調用此方法立即獲得結果，也可以等回調函數執行完若干時間后再想獲取結果數據時調用。
自定義方案描述
通過TransitRoutePlan的getDescription可以獲得完整的方案描述，但是如果開發者想自行定義描述的形式則可通過數據接口進行。例如：
- var transit = new BMap.TransitRoute('北京', {
- onSearchComplete: function(result) {
- if (transit.getStatus() == BMAP_STATUS_SUCCESS) {
- // 從結果對象中獲取起點和終點信息
- var start = result.getStart().title;
- var end = result.getEnd().title;
- // 直接獲取***個方案
- var plan = result.getPlan(0);
- // 獲取步行線路與公交線路個數總和，用于遍歷
- var total = plan.getNumRoutes() + plan.getNumLines();
- var description = ['從' + start];
- var addEndTitle = true;
- for (var i = 0; i < total; i++) {
- if (i % 2 == 0) {
- // i為偶數
- // 處理***個步行描述邏輯
- if (i / 2 == 0) {
- if (plan.getRoute(i / 2).getDistance(false) == 0) {
- description = ['從'];
- }
- }
- // 處理***一個步行描述邏輯
- if (i / 2 == plan.getNumRoutes() - 1) {
- if (plan.getRoute(i / 2).getDistance(false) == 0) {
- addEndTitle = false;
- }
- }
- if (plan.getRoute(i / 2).getDistance(false) > 0) {
- description.push('步行約' + plan.getRoute(i / 2).getDistance(true) + '至');
- }
- } else {
- // i為奇數
- var line = plan.getLine((i - 1) / 2);
- description.push(line.getGetOnStop().title + ', ');
- description.push('乘坐' + line.title + ', ');
- description.push('經過' + line.getNumViaStops() + '站');
- description.push('在' + line.getGetOffStop().title + '站下車，');
- }
- }
- if (addEndTitle) {
- description.push(end + '。');
- }
- // 替換可能出現的末尾位置的逗號
- var descriptiondescriptionStr = description.join('').replace(/\uff0c$/, '。');
- }
- }
- });
- transit.search('清華大學', '北京交通大學');
變量descriptionStr的內容為：“從清華大學步行約830米至五道口, 乘坐地鐵13號線(東直門-西直門), 經過3站在西直門站下車，步行約310米至城鐵西直門站, 乘坐運通105(上地環島東-中苑賓館), 經過2站在北京交通大學站下車。”
回調函數詳解
前面的幾個例子我們使用了onSearchComplete回調函數，在API中還提供了如下幾個回調函數，它們的含義和觸發時機如下：
◆ onMarkersSet：如果設置了渲染的地圖，則API自動添加標注后會觸發此函數。
◆ onPolylinesSet：如果設置了渲染的地圖，則API自動添加線路覆蓋物后會觸發此函數。
◆ onInfoHtmlSet：如果設置了渲染地圖，當用戶點擊標注彈出信息窗口時會觸發此函數。
◆ onResultsHtmlSet：如果設置了渲染側欄，則API填充完HTML后會觸發此函數。
原文：http://www.cnblogs.com/jz1108/archive/2011/10/21/2220574.html
【編輯推薦】
