ルート出発地の更新

Route Handle のエンドポイントもパラメータoriginを受け入れます。 ルートの出発地を更新するために使用できます。基本的には、新しい場所 originとして渡されるまで、元のルートの最初の部分を削除します。

この動作では、origin はルート上にある必要があります。 origin のルートにない場所に移動すると、エラーが発生します。

ルートが同じポイントを複数回通過する場合、 origin はルートの最初のオカレンスにマッチングされます。

この要求は、更新されたRoute Handleを取得します。

curl -X GET \
    'https://router.hereapi.com/v8/routes?origin=52.531029,13.384831&destination=52.539451,13.410595&return=summary,routeHandle&transportMode=car&apikey={YOUR_API_KEY}'

{
  "routes": [
    {
      "id": "d5d4eda5-ca9e-4722-ba23-33d8878a0c9a",
      "sections": [
        {
          "id": "41d20dd7-35ee-4da0-a5d8-60f7dea495db",
          "type": "vehicle",
          "departure": {
            "time": "2021-06-29T13:37:29+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.53105,
                "lng": 13.38481
              },
              "originalLocation": {
                "lat": 52.5310289,
                "lng": 13.3848309
              }
            }
          },
          "arrival": {
            "time": "2021-06-29T13:44:19+02:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 52.5394429,
                "lng": 13.4106148
              },
              "originalLocation": {
                "lat": 52.539451,
                "lng": 13.410595
              }
            }
          },
          "summary": {
            "duration": 410,
            "length": 2624,
            "baseDuration": 289
          },
          "transport": {
            "mode": "car"
          }
        }
      ],
      "routeHandle": "{originalRouteHandle}"
    }
  ]
}