ウェイポイントには、ルートの計算方法を変更するための位置修飾子(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
},
...