指定車輛的方向和道路

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

指定車輛方向

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