路線控點可能包含位置修飾符以變更路線的計算方式,包括 heading
和 sideOfRoad
的設定。
指定車輛方向
如要定義路線控點,請將地理位置 (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 }, ...