路線控點可能包含位置修飾符,可變更路線的計算方式,包括 heading
和 sideOfRoad
的設定。
指定車輛航向
如要定義路線控點,請指定地理位置 (REST) 或位置 (gRPC) 做為經緯度座標。
您也可以指定車輛抵達每個中途點時的行進方向。這項功能可確保車輛停靠在與等待上車的消費者同側的道路。如未指定行進方向,車輛可能會抵達道路的錯誤側。
航向值是與羅盤方向一致的整數,因此範圍為零到 359。舉例來說,值為 0 表示正北方的航向。
以下範例說明如何為航點設定 heading
。
{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 }, "heading": 127 } }, ...
指定偏好的道路側
如要表示位置,請建立 Waypoint (REST) 或 Waypoint (gRPC) 物件。以經緯度組合定義的位置資訊可對應至道路的特定側。不過,為了支援路線最佳化,路線仍可將中途停靠點設在指定位置的馬路對面。
路線控點支援 sideOfRoad
屬性,指出路線控點位置偏好車輛停靠在與指定位置同一側的道路。
將 Waypoint sideOfRoad
屬性設為 true
,指定路線使用道路的偏好側。接著路線會經過該地點,讓車輛停靠在該地點偏向的道路側。
以下範例說明如何為途中的停靠點設定 sideOfRoad
。
{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } }, "sideOfRoad": true }, ...