Waypointsパラメータ

経由地は、マトリックスリクエストの出発地と目的地を記述するために使用されます。 これらの値は座標で構成されていますが、必要に応じて他の詳細情報を含めることができます。これは、マトリックスの計算に影響を与える

SideOfStreetHint

このパラメータsideOfStreetHintでは、Waypointsの優先する道路の側面を指定します。 通常は、道路の側面にある主要施設の場所です。 このパラメータを設定すると、目的地が配達のドロップオフポイントを表す場合などに便利です。

sideOfStreetHintは、 座標とオプションのパラメータ matchで構成されています。 この設定では、ヒントの処理方法を指定します。 可能な値は、ヒントが常に使用されることを意味する alwaysと、反対方向の交通が分割されている道路でのみヒントが使用されることを意味する ,onlyIfDividedです。 車線間に物理的な分離があるか、車線を横切ることが法的に禁止されているかのどちらかですデフォルト sideOfStreetHint では、は分割された道路でのみ使用されます。

Course および minCourseDistance

このパラメータcourseでは、Waypointsを残す方向、出発地の場合はその方向、目的地の場合はその方向に到達する必要があります。 実際には、 0 （北） ～ 359 の範囲の値の時計回りの角度です。 このパラメータは、目的地に目的のコースの見出しがある場合などに使用します。 マトリックスの計算では、可能であればそのことが考慮されます。

出発地を考慮する場合 、このパラメーターcourseは別のWaypointsパラメーターminCourseDistanceと一緒に使用されることがよく あります。 指定されたコースでルートを継続する最小距離です。 たとえば、特定の方向への走行中にマトリックスの計算が行われた場合、ドライバーはその方向への走行を続行し、しばらくの間曲がるのを避けることができます。

nameHint 、 radius 、 snapRadius

nameHint パラメーター、radius パラメーター、および snapRadius パラメーターを使用して、出発地 / 目的地　Waypointsを検索する際のマトリックスの計算をガイドできます。

nameHintを使用すると、最も似た名前のWaypointsが計算で検索されます。 ヒントには north 、 I66 North とを使用する場合などがあります 南に向かって I66 です。

一方、正確な場所が不明な場合、または重要でない場合 は、このパラメータ radiusを使用して、半径内のすべての場所がルート計算で考慮されるようにします。 通常のパラメータradiusとは対照的に、snapRadiusは潜在的な候補を「重要度」の順に並べ替えます。 snapRadius は、Drag and drop インターフェイスで経由地を照合する場合に最も役立ち、Matrix Routing では使用されませ ん。 snapRadius Matching waypoint on drag-and-drop interfaceの詳細については、『ユースケース ルーティング開発ガイド』を参照してください。

注

これらのパラメータを使用すると、ルートの計算に使用される場所が入力座標と同じではない可能性があります。

たとえば、マトリックスリクエストの各出発地がルート上のWaypointsを表していても、異なるエントリが異なるベースとなる場所を使用する場合、これらのエントリ間の接続部分は失われます。

この例では、 A から B 、 C の順に移動する方法を示します。この例では、出発地 A と B を持つマトリックスリクエスト、および目的地 B と C が必要です。 B の半径を 200 メートルに設定すると、計算では B1 と B2 がベースとなる場所として使用されることがあります。 これは、 A から B までのルートの実際の長さ、および C がマトリックス結果で返された長さよりも長いことを意味します。