ルートに経由地を追加するには

1つ以上のvia経由地パラメーターを指定することにより、追加の中間経由地をルートに挿入できます。ルートは指定された順序でそれらの場所を訪れます。

たとえば、次のリクエストでは、destinationに向かう前に訪れる中間地点via=52.52426,13.43000を指定します。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'transportMode=car&'\
'return=polyline,summary&'\
'origin=52.51375,13.42462&'\
'destination=52.52332,13.42800&'\
'via=52.52426,13.43000&'\
'apiKey=YOUR_API_KEY'

結果のルートはこのvia (画像の「1」) を訪れ、方向転換してdestinationに向かいます。

レスポンスには、origin から via と via から destination の 2 つのセクションが含まれます。

"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
      }
    },
    ...
  },
  {
    "departure": {
      "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
      }
    },
    "arrival": {
      ...
    },
    ...
  }
]

最初のセクションの arrival と 2 番目のセクションの departure には、waypoint というプロパティがあります。このプロパティは、これがインデックス 0 の中間経由地であるという事実を通知します。

次のリクエストは、前の例の via パラメーターの前に別の via パラメーター (via=52.517871,13.434175) を追加します。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.51375,13.42462&'\
'transportMode=car&'\
'destination=52.52332,13.42800&'\
'via=52.517871,13.434175&'\
'via=52.52426,13.43000&'\
'return=polyline,summary&'\
'apiKey=YOUR_API_KEY'

結果のルートは、リクエストに表示されるのと同じ順序で両方の中間ウェイポイントを訪れます。

結果には3つのセクションが含まれ、それに応じてwaypointインデックスが入力されます。

"sections": [
  {
    "departure": {
      ...
    },
    "arrival": {
      "place": {
        ...,
        "waypoint": 0
      }
    },
    ...
  },
  {
    "departure": {
      "place": {
        ...,
        "waypoint": 0
      }
    },
    "arrival": {
      "place": {
        ...,
        "waypoint": 1
      }
    },
    ...
  },
  {
    "departure": {
      "place": {
        ...,
        "waypoint": 1
      }
    },
    "arrival": {
      ...
    },
    ...
  }
]

その他のチュートリアル

ルートをセクションに分割しない経由地を追加するには、次のチュートリアルを確認してください。

パススルー経由地を使用したルートを形成する

25 日前の更新