指定車輛的方向和道路

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

如果您的帳單地址位於歐洲經濟區，自 2025 年 7 月 8 日起，使用服務時將適用《 Google 地圖平台歐洲經濟區服務條款》。功能會因區域而異。 瞭解詳情。

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

注意： heading 和 sideOfRoad 不相容。您不得在同一地點使用。

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

指定車輛航向

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

您也可以指定車輛抵達每個中途點時的行進方向。這項功能可確保車輛停靠在與等待上車的消費者同側的道路。如未指定行進方向，車輛可能會抵達道路的錯誤側。

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

航向值是與羅盤方向一致的整數，因此範圍為零到 359。舉例來說，值為 0 表示正北方的航向。

以下範例說明如何為路徑點設定 heading。

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

指定偏好的道路側

如要表示位置，請建立 Waypoint (REST) 或 Waypoint (gRPC) 物件。以經緯度組合定義的位置資訊可對應至道路的特定側。不過，為了支援路線最佳化，路線仍可將中途停靠點設在指定位置的馬路對面。

路線控點支援 sideOfRoad 屬性，指出車輛偏好停靠在路線控點位置的同一側。

將 Waypoint sideOfRoad 屬性設為 true，指定路線使用道路的偏好側。接著路線會經過該地點，讓車輛停靠在該地點偏向的道路側。

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

以下範例說明如何為途中的停靠點設定 sideOfRoad。

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