ガイドAPIリファレンス
ガイド
  1. HERE Routing API V8 - 開発者ガイド
  2. 経由地

経由地の概要

経由地は、リクエストされたルートが通過する必要がある地点です。 ルートの出発地と目的地自体も経由地です。 各ルートには、少なくとも2つの経由地 (originおよびdestination) が必要です。

ルートには複数の中間経由地を含めることもできます。中間経由地は出発地と目的地の間にあり、指定された順序でルートが通過する地点のことです。

中間経由地は、viaパラメーターを使用して指定します。

中間経由地タイプ

中間経由地には次の2つのタイプがあります。

  • 経由地ポイント：旅程がしばらく停止し、その後再開される経由地。これは、すべての中間経由地のデフォルト設定です。passThrough=falseオプションを使用して明示的に有効にできます。
  • パススルーポイント：旅程を停止せずに、ルートの形状のみが変更される経由地。passThrough=trueオプションを使用して有効にします。

経由地オプション

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

例：

  • 経由地での滞在時間
  • ナビゲーションのヒント
  • 運転指示

経由地オプションの詳細なリストについては、「HERE Routing API V8 APIリファレンス」を参照してください。

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

中間経由地を通るルート

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

途中via経由地 (passThrough=false) を追加すると、ルートは次のセクションに分割されます。

  1. originから最初のviaまで
  2. リクエストされた順序のすべてのポイントに対して、後続のviaまで
  3. 最後のviaからdestinationまで

経由地に停車地 (passThrough=true) を使用しない場合、APIは以下を行います。

  • ルートをセクションに分割しない
  • 進行方向の変更を回避する

return=passthroughパラメーターをルートリクエストに追加し、レスポンスでパススルー経由地に関する情報を取得できます。これには、パススルー経由地が一致したlocationと、そのルートに対してポリラインがリクエストされた場合はポリラインへのオフセットが含まれます。

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

経由地のマッチング

Routing APIは、リクエストされた各経由地の位置を地図上のナビゲーション可能な位置とマッチングします。経由地のマッチングには、さまざまな経由地パラメーターを使用します。

経由地のマッチングには2つの方法があります。これらの方法は以下のパラメーターを使用して有効になります。

  • radiusパラメーター：設定された半径内のすべてのセグメントに経由地をマッチングし、ルーターがルートに最適なセグメントを選択できるようにします。
  • snapRadiusパラメーター：設定された半径内で最も近く「重要な」道路に経由地をマッチングします。

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

詳細については、「UIインタラクションに基づいて経由地を設定する」を参照してください。

locationとoriginalLocation

経由地とマッチングした場所は、リクエストされた元の場所と異なる場合があります。APIレスポンスには、リクエストされた元の場所とマッチングした場所の両方が含まれます。

  • locationは、ルート計算で使用される経由地のナビゲーション可能な場所です。
  • originalLocationは、APIリクエストで指定された元の場所です。

locationおよびoriginalLocationを使用したレスポンスの引用例を参照してください。

"sections": [
  {
    "departure": {
      ...
    },
    "arrival": {
      "time": "2024-09-05T09:47:46+02:00",
      "place": {
        "type": "place",
        "location": {
          "lat": 52.5242323,
          "lng": 13.4301462
        },
        "originalLocation": {
          "lat": 52.52426,
          "lng": 13.43
        },
        "waypoint": 0
      }
    },
    ...
  }
]

経由地の最大数

ルートに対する経由地の最大数は、HTTPリクエストの最大長によって制限されます。オプションの数とそのテキストの長さに応じて、リクエストに収まる経由地の数は変わる場合があります。

1つのルートリクエストに追加する経由地は、100個以下にすることをお勧めします。

ルートの照合

ルートの照合のユースケースを実現し、GPSトレースまたは既存のルートからの座標を使用してルートを再作成するには、多数の経由地が必要です。 これには、入力でサポートしている経由地の数が多い、/importエンドポイントを使用します。

/importエンドポイントの詳細については、「トレースからルートをインポートするには」を参照してください。

25 日前の更新