DIV CSS 佈局教程網

用百度地圖 API 取得公車路線沿途站點座標的實作
編輯:關於JavaScript     

做地圖相關的模擬資料時,常需要某條公車路線沿途站點的座標。百度地圖沒有現成 API 直接回傳這份清單,因此作者做了一個小工具頁面來把它挖出來(IE6/7/8 不支援)。

關鍵發現:座標是在哪個回呼裡才出現的

百度地圖的 API 文件中一共有四個回呼:onGetBusListComplete、onBusLineHtmlSet、onBusListHtmlSet、onGetBusLineComplete。實測的結論是:在 onGetBusListComplete 階段,結果物件裡還沒有座標資訊;必須等到 onBusLineHtmlSet(線路格式化完畢)這一步,百度才會把座標附加到先前那個結果物件上。

因此 busline.getBusLine(...) 這一行呼叫不能省——不呼叫它就不會觸發格式化,也就永遠拿不到座標。這是一個典型的「API 未文件化的副作用」:你得先觸發一個看似無關的流程,資料才會被填進來。

第一版:單一路線

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>獲取公交站點坐標</title>
<style type="text/css">
html, body { height: 100%; }
#results, #coordinate {
  display: inline-block; width: 45%; min-height: 200px;
  border: 1px solid #e4e4e4; vertical-align: top;
}
</style>
<script src="https://api.map.baidu.com/api?v=1.3" type="text/javascript"></script>
</head>
<body>
<p>
  <label for="busId">公車線路:</label>
  <input type="text" value="521" id="busId" />
  <input type="button" id="btn-search" value="查詢" />
</p>
<div id="results"></div>
<div id="coordinate"></div>

<script type="text/javascript">
(function(){
  var tempVar;
  var busline = new BMap.BusLineSearch('武漢', {
    renderOptions: { panel: "results" },
    onGetBusListComplete: function(result){
      if (result) {
        tempVar = result;   // 此時尚無座標,先存起來
        busline.getBusLine(result.getBusListItem(0));   // 這行必須存在
      }
    },
    onBusLineHtmlSet: function(){
      try { getCoordinate(tempVar); } catch (e) {}
    }
  });

  function getCoordinate(result){
    var coordinate = document.getElementById("coordinate");
    var stations   = result['0']._stations;
    var html = [];
    stations.forEach(function(item){
      html.push('<li>' + item.name + ' '
                + item.position.lng + ' ' + item.position.lat + '</li>');
    });
    coordinate.innerHTML = '<ul>' + html.join('') + '</ul>';
  }

  document.getElementById('btn-search').onclick = function(){
    busline.getBusList(document.getElementById("busId").value);
  };
})();
</script>
</body>
</html>

想取反方向的路線,只要把 result['0']._stations 的索引改成對應的項即可。

第二版:支援點擊切換方向

改版的重點是:把狀態集中到一個 global 物件,並透過事件 delegation 攔下左側清單的點擊,從被點的連結當中解析出 _selectBusListItem(n) 的索引,再重新格式化該路線。

var global = { tempVar: {}, index: 0, lineNo: 0 };

var busline = new BMap.BusLineSearch('武漢', {
  renderOptions: { panel: "results" },
  onGetBusListComplete: function(result){
    if (result) global.tempVar = result;
  },
  onBusLineHtmlSet: function(){
    try { getCoordinate(global.tempVar); } catch (e) {}
  }
});

function $$(id){ return document.getElementById(id); }

function getCoordinate(result){
  var html = [];
  result[global.index]._stations.forEach(function(item, index){
    html.push('<li>' + global.lineNo + '#' + global.index + '#'
              + index + '#' + item.name + '#'
              + item.position.lng + '#' + item.position.lat + '</li>');
  });
  $$("coordinate").innerHTML = '<ul>' + html.join('') + '</ul>';
}

$$('btn-search').onclick = function(){
  global.lineNo = $$("busId").value;
  busline.getBusList(global.lineNo);
};

// 事件 delegation:監聽容器而非每個連結
$$('results').addEventListener('click', function(event){
  var target = event.target;
  if ('a' == target.tagName.toLowerCase()
      && 'dt' == target.parentNode.tagName.toLowerCase()){
    event.preventDefault();
    var tempHtml = target.parentNode.innerHTML;
    var key = '_selectBusListItem(';
    var indexOfValue = tempHtml.indexOf(key);
    global.index = -( - tempHtml.substring(indexOfValue + key.length,
                                          indexOfValue + key.length + 1) );
    busline.getBusLine(global.tempVar.getBusListItem(global.index));
  }
}, false);

第二版的輸出格式刻意改成以 # 分隔的扁平行(線路#方向#序號#站名#經度#緯度),方便直接貼進試算表或做後續處理——這是很實際的工程思維:先想清楚資料要流到哪裡去,再決定輸出格式。

使用上的提醒

這份程式碼依賴 _stations 這個以下底線開頭的屬性,代表它是 API 的內部欄位而非公開介面,百度在版本更新時有權在未公告的情況下改掉它。範例中包了 try/catch 正是這個原因。若要在正式專案中長期依賴這份資料,比較穩健的作法是改用官方有文件化的路線規劃服務,或自行建立一份離線的站點座標資料表,避免被上游變動影響。另外,範例中的 API 使用固定版本號 v=1.3,實際串接時應改用官方目前建議的版本與金鑰(ak)機制。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved