指定車輛的方向和道路

歐洲經濟區 (EEA) 開發人員

路線控點可能包含位置修飾符,可變更路線的計算方式,包括 heading 和 sideOfRoad 的設定。

指定車輛行進方向

如要定義路線控點,請將地理位置 (REST) 或位置 (gRPC) 指定為一組經緯度座標。

您也可以透過位置指定車輛抵達各個路線控點時的行進方向。這項功能可確保車輛抵達乘客等候上車的路側。如未指定車頭方向,車輛可能會抵達道路錯誤的一側。

航向值是與指南針方向一致的整數,因此範圍介於 0 到 359 之間。舉例來說,如果值為 0,表示朝向正北。

以下範例說明如何設定路線控點的 heading。

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      },
      "heading": 127
    }
  },
  ...

指定道路偏好設定

您可以建立 Waypoint (REST) 或 Waypoint (gRPC) 物件來代表地點。由經緯度組合定義的位置,可以對應到道路的特定一側。不過,為了支援路線最佳化,路線仍可將停靠點設在指定位置的對向車道。

路線控點支援 sideOfRoad 屬性,表示路線控點位置偏好車輛停靠在位置指定的道路同一側。

將路線控點 sideOfRoad 屬性設為 true,指定路線使用偏好的道路側。路線會經過該位置,讓車輛停在該位置偏向的道路一側。

以下範例說明如何設定路線控點的 sideOfRoad。

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    },
    "sideOfRoad": true
  },
  ...