實例方法

實例方法	描述
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);

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);

route​

route