實例方法
透過 mapPlus DirectionsService API 中的方法，可以在地圖上規劃路線。
| 實例方法 | 描述 |
|---|---|
| route | 規劃路線。 |
route
route(options, callback)
可根據文字查詢傳回地點，例如地點的名稱或地址。
參數
- options
(object)：請求參數。 - callback
(function)：回調函數，返回第一個參數為查詢到的資料，第二個參數為請求狀態。
| 參數 | 描述 |
|---|---|
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。 |
範例
const map = await new mapPlus(document.getElementById('map'), { accessToken: 'get_your_token', accessKey: 'get_your_key', style: 'https://kw3dmap.localking.com.tw/openapi/map/kwmap.etxt',});
const service = new mapPlus.DirectionsService(map);
const options = { origin: [121.464585, 25.041024], destination: [121.517532, 25.046255], waypoints: [ [121.525049, 25.087765], [121.531367, 25.111857], ], optimizeWaypoints: false, travelMode: 'DRIVING', avoid: 'TOLL',};
const callback = (result, status) => { console.log(result);};
service.route(options, callback);