Kingwaytek

路線規劃服務

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

路線規劃服務

開始使用

調用 new mapPlus.DirectionsService(map),開始使用路線規劃API,以下為參數說明:

  • map (object): 帶入 new mapPlus() 返回的物件。

實例方法

route

route(options, callback)

可根據文字查詢傳回地點,例如地點的名稱或地址。

Parameters

  • options (object): 請求參數。
  • callback (function): 回調函數,返回第一個參數為查詢到的資料,第二個參數為請求狀態。
NameDescription
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

交通方式。

ValueDescription
DRIVING汽車
TWO_WHEELER機車
BICYCLING腳踏車
WALKING走路
TRANSIT大眾運輸。 ※注意: 當設為 mode: 'TRANSIT' 時,將不支援航點 waypoints 設定。

Avoid

要避開的路線。

ValueDescription
TOLL收費路段
HIGHWAY高速公路