指定車輛的方向和道路

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

指定車輛方向

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