航点可能包含位置修饰符,用于更改路线的计算方式,包括 heading 和 sideOfRoad 的设置。
指定车辆朝向
如需定义航点,您需要将地理位置 (REST) 或位置 (gRPC) 指定为一对纬度/经度坐标。
通过位置信息,您还可以指定车辆到达每个航点时要朝向的方向。您可以使用此功能确保车辆到达等待上车的消费者所在的道路一侧。如果您未指定朝向,车辆可能会到达道路的错误一侧。
航向值为与罗盘方向一致的整数,因此范围为 0 到 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
},
...