Waypoint

Waypointは、要求されたルートが通過する必要があるポイントを指定します。 origin と destination はWaypointですが、 1つのリクエストでviaを使ってさらに多くの中間のWaypointを指定することもできます。　例については、中間のWaypoint経由のルートを参照してください。

Waypointは、ストップオーバーポイント（ルートに戻る前に少し立寄るポイント）、またはルートの形状にのみ影響を与えるが実際のストップが実行されないパススルーポイントを表します。

Waypointには、 WGS84 座標に加えて、物理的な位置ポイントまたは経由地自体に関連する他のいくつかのオプションおよび詳細情報が組み込まれています。

オプションの例としては、ストップオーバー時間（上記を参照）、指定した時間にルートを到着させるように要求する、または指定した距離のルートの開始時に操作（ターンなど）を無視するなどのナビゲーションヒントがあります。

関連するサンプルリクエストについては、次のチュートリアルを参照してください。

中間のWaypoint経由でルートを作成します

ルートにWaypointを追加するには、リクエストの パラメータvia を使用して指定します。

Waypointのリストを via で指定して、結果のルートをセクションに分割できます。

  1. origin から最初のviaまで
  2. それ以降の via に、要求された順序の各ポイントまで
  3. 最後の via から destination まで

各 via パラメータに passThrough オプションを設定します。 passThrough を true に設定した場合、ルートの計算時にWaypointでルート計算は次のように動作します。

  • ストップオーバーは発生しません
  • ルートをセクションに分割しません
  • 進行方向の変更を回避します

また、応答でWaypointを介したパススルーに関する情報を取得するために return=passthrough を指定します。 これには、パススルーが照合された location が含まれます。また、ポリラインが要求された場合は、オフセットにポリラインが入ります。

現在、経由するWaypointの数に制限はありませんが、 HTTP 要求のサイズには制限があります。 Waypoint経由などのオプションのテキストの長さ、または要求された回避オプションに応じて、指定できる Waypointの数が異なります。 このため、 100 を超えるWaypointを指定することは推奨されません。

ユースケースに一致するルートを実現し、 GPS トレースまたは既存のルートからの座標を使用してルートを再作成するには、多数のWaypointが必要です。 このシナリオでは、入力ではるかに多くの点をサポートしているため、ルートインポートサービスを使用することをお勧めします。

ルート計算に 1 つのストップオーバーWaypointを追加する方法の簡単なチュートリアルについては、「 ストップオーバーの追加」を参照してください。

Waypointの計算方法を示すサンプルリクエストについては、次のチュートリアルを参照してください。

Waypointのマッチ

Waypoint には、 2 つのWaypointをマッチさせる機能があります。

  • radius パラメータ : これにより、Waypoint がエリア内のすべてのセグメントに一致するようになり、ルート計算はルートに最適なセグメントを選択します。

  • snapRadius パラメーター。 この場合、Waypoint は指定された半径で最も近い最も重要な道路にマッチングされます。

これらのパラメータは相互に排他的です。 たとえば 、 1 つ目のWaypointで radiusを使用し、と 2 つ目でsnapRadiusを使用できますが、両方を 1 つのWaypoint に設定することはできません。

「」に一致する結果は 件です

    「」に一致する結果はありません