代替ルートの取得方法

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

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

レスポンスのrouteLabelsデータは、UIでさまざまなルートのラベルを作成するのに役立ちます。たとえば、「A10経由の幹線道路」、「A10、B273経由の代替ルート」などです。

curl -gX 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"
          }
        }
      ],
      ...
    },
    {
      "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"
          }
        }
      ],
      ...
    }
  ]
}

先月の更新