路線規劃服務
透過 mapPlus DirectionsService API 中的方法,可以在地圖上規劃路線。

開始使用
調用 new mapPlus.DirectionsService(map)
,開始使用路線規劃API,以下為參數說明:
- map
(object)
: 帶入new mapPlus()
返回的物件。
實例方法
- route: 規劃路線。
route
route(options, callback)
可根據文字查詢傳回地點,例如地點的名稱或地址。
Parameters
- options
(object)
: 請求參數。 - callback
(function)
: 回調函數,返回第一個參數為查詢到的資料,第二個參數為請求狀態。
Name | Description |
---|---|
options.origin (Location) | 必填,路線規劃的起點,詳情參考 Location。 |
options.destination (Location) | 必填,路線規劃的目的地,詳情參考 Location。 |
options.travelMode (TravelMode) | 選填,交通方式,預設為 DRIVING ,詳情參考 TravelMode。 |
options.waypoints (Location[]) | 選填,航點設定,上限為 10 個航點,預設為 undefined ,詳情參考 Location。 |
options.optimizeWaypoints (boolean) | 選填,是否簡化航點的路線,預設為 false 。 |
options.avoid (Avoid) | 選填,要避開的路線,預設為 undefined ,詳情參考 Avoid。 |
Examples
參數說明
Location
地標參數,可使用以下格式:
mapPlus.LngLat
{lng, lat}
座標陣列
地名
※注意:此為實驗性功能。建議先使用 PlacesService 取得欲查詢地名之座標。
地址
※注意:此為實驗性功能。建議先使用 PlacesService 取得欲查詢地址之座標。
TravelMode
交通方式。
Value | Description |
---|---|
DRIVING | 汽車 |
TWO_WHEELER | 機車 |
BICYCLING | 腳踏車 |
WALKING | 走路 |
TRANSIT | 大眾運輸。 ※注意: 當設為 mode: 'TRANSIT' 時,將不支援航點 waypoints 設定。 |
Avoid
要避開的路線。
Value | Description |
---|---|
TOLL | 收費路段 |
HIGHWAY | 高速公路 |