指定車輛的方向和道路

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

注意： heading 和 sideOfRoad 不相容。您不得將這些參數用於相同位置。

注意： 使用 heading 和 sideOfRoad 的請求會以較高的費率計費。進一步瞭解 Routes API 的結帳系統。

指定車輛方向

如要定義路線控點，請將地理 Location (REST) 或 Location (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
  },
  ...