ラベル付きの代替ルート

このパラメータalternative は、利用可能な代替ルートを検索するようにサービスに指示します。 また、このパラメータrouteLabelsを使用すると、ルートにラベルを付けるように要求できます。 このルートで最も重要な名前とルート番号のリストが使用され、他の代替手段と区別されてから、ラベルが生成されます。

各ルートには、 2 つまでのラベルがあります。 最初の標識はルートで最長の道路で、 2 番目の標識は次の最長の「一般的ではない」道路です。 一般的ではないということは、この道路が他のルートの標識付けに使用されていないことを意味します。 道路の総ルート長の 3 分の 2 以上を使用する場合、そのようなルートのラベルは 1 つだけである可能性があります。

レスポンスのデータrouteLabels は、 UI で異なるルートのラベルを作成する場合に役立ち ます。たとえば、「 main road via A10 」、「 alternative route via A10,B273 」のようになります。

curl -X GET 'https://router.hereapi.com/v8/routes?origin=52.534647%2C13.286891&destination=52.53329%2C13.47486&return=routeLabels,summary&transportMode=car&lang=en-gb&alternatives=1&apikey={YOUR_API_KEY}'

{
   "routes" : [
      {
         "id" : "20d89644-f7f0-4fc6-811d-3efd4545d036",
         "routeLabels" : [
            {
               "label_type" : "Name",
               "name" : {
                  "language" : "de",
                  "value" : "Seestraße"
               }
            },
            {
               "label_type" : "Name",
               "name" : {
                  "language" : "de",
                  "value" : "Stadtring Berlin"
               }
            }
         ],
         "sections" : [
            {
               "arrival" : {
                  "place" : {
                     "location" : {
                        "lat" : 52.5334674,
                        "lng" : 13.4745833
                     },
                     "originalLocation" : {
                        "lat" : 52.53329,
                        "lng" : 13.4748599
                     },
                     "type" : "place"
                  },
                  "time" : "2022-09-19T16:21:26+02:00"
               },
               "departure" : {
                  "place" : {
                     "location" : {
                        "lat" : 52.5341366,
                        "lng" : 13.2871219
                     },
                     "originalLocation" : {
                        "lat" : 52.534647,
                        "lng" : 13.286891
                     },
                     "type" : "place"
                  },
                  "time" : "2022-09-19T15:50:52+02:00"
               },
               "id" : "1b4ce9e1-96eb-44d6-aae7-e5ab63b8dce7",
               "summary" : {
                  "baseDuration" : 1834,
                  "duration" : 1834,
                  "length" : 16273
               },
               "transport" : {
                  "mode" : "car"
               },
               "type" : "vehicle"
            }
         ]
      },
      {
         "id" : "c34a0003-c55f-4100-b909-79fc88450847",
         "routeLabels" : [
            {
               "label_type" : "Name",
               "name" : {
                  "language" : "de",
                  "value" : "Danziger Straße"
               }
            },
            {
               "label_type" : "Name",
               "name" : {
                  "language" : "de",
                  "value" : "Seestraße"
               }
            }
         ],
         "sections" : [
            {
               "arrival" : {
                  "place" : {
                     "location" : {
                        "lat" : 52.5334674,
                        "lng" : 13.4745833
                     },
                     "originalLocation" : {
                        "lat" : 52.53329,
                        "lng" : 13.4748599
                     },
                     "type" : "place"
                  },
                  "time" : "2022-09-19T16:21:57+02:00"
               },
               "departure" : {
                  "place" : {
                     "location" : {
                        "lat" : 52.5341366,
                        "lng" : 13.2871219
                     },
                     "originalLocation" : {
                        "lat" : 52.534647,
                        "lng" : 13.286891
                     },
                     "type" : "place"
                  },
                  "time" : "2022-09-19T15:50:52+02:00"
               },
               "id" : "f736b1a1-87f1-4b9f-b7ac-382cbf8f7bc7",
               "summary" : {
                  "baseDuration" : 1865,
                  "duration" : 1865,
                  "length" : 16269
               },
               "transport" : {
                  "mode" : "car"
               },
               "type" : "vehicle"
            }
         ]
      }
   ]
}