経由地

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

一致する経由地

経由地 には、 2 つの経由地 一致戦略があります。

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

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

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

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

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