HERE Matrix Routing API v8の経由地パラメーター

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

sideOfStreetHintパラメーター

sideOfStreetHintパラメーターは経由地の優先する道路の側面を指定します。通常は、道路の側面にある主要施設の場所です。このパラメーターを設定すると、目的地が配達のドロップオフポイントを表す場合などに便利です。 sideOfStreetHintは座標とオプションのパラメーターmatchで構成されています。この設定では、ヒントの処理方法を指定します。可能な値は、ヒントが常に使用されることを意味するalwaysと、反対方向の交通が分割されている道路でのみヒントが使用されることを意味するonlyIfDividedです。車線間に物理的な分離があるか、車線を横切ることが法的に禁止されているかのどちらかです。デフォルトでは、sideOfStreetHintは分割された道路でのみ使用されます。

course、minCourseDistanceパラメーター

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

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

nameHint、radius、snapRadiusパラメーター

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

nameHintを使用すると、最も似た名前の経由地が計算で検索されます。ヒントは、たとえばI66 SouthではなくI66 Northを使用する場合、northとします。

一方、正確な場所が不明な場合、または重要でない場合は、このパラメーター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までのルートの実際の長さが、マトリックス結果で返された長さよりも長いことを意味します。