車両の見出しと道路の片側を指定

地点に場所の修飾子を追加すると、heading や sideOfRoad の設定など、ルートの計算方法を変更できます。

車両の進行方向を指定する

ウェイポイントを定義するには、緯度と経度の座標のペアとして地理的な Location（REST）または Location（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
  },
  ...