物流、貨運、跨城服務這類應用,經常需要算出兩地之間的實際駕駛里程與預估時間。百度地圖 JavaScript API 提供了 DrivingRoute 這個類別,你只要給定起點與終點,它就會回傳路線規劃結果,其中 getDistance() 與 getDuration() 就是我們要的數字。
下面先示範純前端的版本:用省/市/縣三層下拉選單選擇起訖點,或直接輸入地名,按下查詢後在地圖上繪出路線,右側顯示里程與時間。
<script src="js/jquery-1.9.0.js" type="text/javascript"></script>
<script src="js/area.js" type="text/javascript"></script>
<script type="text/javascript" src="https://api.map.baidu.com/api?v=1.2"></script>
<script language="javascript" type="text/javascript">
var map = new BMap.Map("container");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);
map.addControl(new BMap.NavigationControl()); // 平移縮放控制項
map.addControl(new BMap.OverviewMapControl()); // 縮略圖
map.enableScrollWheelZoom(); // 允許滾輪縮放
map.setMapStyle({ style: "mapbox" });
// 依下拉選單的起訖點查詢
function SetMap() {
var oGl = document.getElementById("div_gongli");
var ofprovince = document.getElementById("AreaDept1_Province");
var ofname = document.getElementById("AreaDept1_Prefecture");
var ofxian = document.getElementById("AreaDept1_Xian");
var otprovince = document.getElementById("mdd");
var otname = document.getElementById("cdd");
var otxian = document.getElementById("xian");
var output = "全程:";
if (ofname.value == "") { alert('請選擇出發地!'); return; }
if (otname.value == "") { alert('請選擇到達地!'); return; }
document.getElementById("div_title").innerText =
"'" + ofprovince.value + ofname.value + ofxian.value + "到"
+ otprovince.value + otname.value + otxian.value + "' 查詢結果";
var searchComplete = function (results) {
if (transit.getStatus() != BMAP_STATUS_SUCCESS) return;
var plan = results.getPlan(0);
output += plan.getDistance(true); // 取得距離
output += "/";
output += plan.getDuration(true); // 取得時間
};
var transit = new BMap.DrivingRoute(map, {
renderOptions: { map: map, panel: "results", autoViewport: true },
onSearchComplete: searchComplete,
onPolylinesSet: function () { oGl.innerText = output; }
});
transit.search(ofprovince.value + ofname.value + ofxian.value,
otprovince.value + otname.value + otxian.value);
}
// 直接輸入地名查詢
function SetMap2() {
var oGl = document.getElementById("div_gongli");
var ofname = document.getElementById("farea");
var otname = document.getElementById("tarea");
var output = "全程:";
if (ofname.value == "") { alert('請輸入出發地!'); return; }
if (otname.value == "") { alert('請輸入到達地!'); return; }
document.getElementById("div_title").innerText =
"'" + ofname.value + "到" + otname.value + "' 查詢結果";
var searchComplete = function (results) {
if (transit.getStatus() != BMAP_STATUS_SUCCESS) return;
var plan = results.getPlan(0);
output += plan.getDistance(true) + "/" + plan.getDuration(true);
};
var transit = new BMap.DrivingRoute(map, {
renderOptions: { map: map, panel: "results", autoViewport: true },
onSearchComplete: searchComplete,
onPolylinesSet: function () { oGl.innerText = output; }
});
transit.search(ofname.value, otname.value);
}
</script>
對應的頁面結構大致如下,包含兩個查詢表單、地圖容器與結果面板:
<table border="0" align="center" cellpadding="0" cellspacing="0">
<tr>
<td>出發城市
<select id="AreaDept1_Province" onchange="changearea(this.value,document.getElementById('AreaDept1_Prefecture'))">
<option value="">-省份-</option></select>
<select id="AreaDept1_Prefecture" onchange="changecity(...)">
<option value="">-城市-</option></select>
<select id="AreaDept1_Xian"><option value="">-縣-</option></select>
</td>
<td>到
<select id="mdd" onchange="changearea(this.value,document.getElementById('cdd'))">
<option value="">-省份-</option></select>
<select id="cdd"><option value="">-城市-</option></select>
<select id="xian"><option value="">-縣-</option></select>
</td>
<td><div onclick="SetMap(); return false;" style="cursor:pointer">查詢</div></td>
<td>
出發城市 <input id="farea" type="text" size="10" />
到 <input id="tarea" type="text" size="10" />
<div onclick="SetMap2(); return false;" style="cursor:pointer">查詢</div>
</td>
</tr>
</table>
<div style="float:left; width:670px">
<div id="container" style="height:500px; border:1px solid gray"></div>
</div>
<div style="float:right; width:300px">
<div id="div_title">查詢結果</div>
<div id="div_gongli"></div>
<div id="results"></div>
</div>
如果只需要一組固定的起訖點,程式碼可以更精簡——不必做表單,直接把地名寫進 search() 即可:
var map = new BMap.Map("allmap");
map.centerAndZoom(new BMap.Point(116.404, 39.915), 12);
var output = "從上地到西單駕車需要";
var searchComplete = function (results) {
if (transit.getStatus() != BMAP_STATUS_SUCCESS) return;
var plan = results.getPlan(0);
output += plan.getDuration(true) + "\n"; // 時間
output += "總路程為:";
output += plan.getDistance(true) + "\n"; // 距離
};
var transit = new BMap.DrivingRoute(map, {
renderOptions: { map: map },
onSearchComplete: searchComplete,
onPolylinesSet: function () {
setTimeout(function () { alert(output); }, 1000);
}
});
transit.search("上地", "西單");
最後補充一點架構上的建議。上面兩種寫法都把計算放在瀏覽器端,缺點是使用者必須開著頁面、而且每次都要重新請求。若你的需求是後端運算(例如報價、批量里程表、離線分析),更合適的做法是改走「地理編碼 + 路線規劃」的 Web 服務 API,由伺服器送出請求並取回 JSON 結果,再視需要快取起來。此外,getDistance(true) 的參數 true 表示以公尺為單位回傳整數;若省略則回傳的是帶單位的字串,做數值運算時務必注意這個差別。