使用位置修飾符

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

注意： heading 和 sideOfRoad 不相容。同一個位置不得相同。

注意： 使用 heading 和 sideOfRoad 的要求會以較高的費率計費。 進一步瞭解 Routes API 的計費方式。

使用標題屬性

如要定義路線控點，請將地理位置 (REST) 或位置 (gRPC) 指定為緯度和經度配對。

位置也可讓您指定車輛抵達各個路線控點時前往的方向。您可以使用這項功能，確保車輛在消費者等待上車時抵達相同的道路。如未指定標題，車輛可以抵達道路的錯誤的側。

注意： 只有在使用 Drive 或 Two-wheeler 交通方式時，以及使用經緯度組合指定位置時，您才能設定 heading。

方向值是用指南針方向對齊的整數，因此從 0 到 359 之間。例如，0 值表示向北方向的方向方向。

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

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

使用道路屬性側邊

建立 Waypoint (REST) 或 Waypoint (gRPC) 物件，代表位置。經緯度組合指定的位置可對應到道路的特定方向。不過，如要支援路線最佳化，路徑仍可將停靠站設為從指定位置向道路的另一側。

路線控點支援 sideOfRoad 屬性，表示路線控點位置的偏好設定是車輛停靠在地點指定的道路上。

將路線控點 sideOfRoad 屬性設為 true，即可指定路線使用道路的偏好的邊。接著，路線會通過位置，讓車輛可以在要偏遠的道路方向上停止。

注意： 只有在使用 Drive 或 Two-wheeler 交通方式時，才能設定 sideOfRoad。

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

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