ルートの通行料金情報を取得する

通行料金情報を取得するには、return パラメーターに tolls を含めます。この情報は、次の移動モードで利用できます。

乗用車
truck
タクシー
バス

📘
注
ルートの通行料金情報のリクエストは、追加のトランザクションとしてカウントされます。

ルートの各セクションには、該当する通行料金のリストが、その名前、支払い方法、現地通貨での料金、さらに該当する場合はリクエストされた通貨に換算された料金とともに含まれます。通行料金の詳細さは、ルート全体 (ビネットの場合) から個々の道路区間 (km あたり支払いのトラック通行料金の場合) まで多岐にわたります。

通行料金のシステムによっては、支払い方法、車の特性、通過時間、その他の要因によって通行料金が異なる場合があります。車の特性は、transportMode、vehicle[hovOccupancy] で (ある程度まで) 指定でき、トラックモードではトラックのプロフィールで指定できます。出発時間を指定して到達予測時刻からの通過時間を計算するさまざまな通行料金による複雑な体系があるため、料金はベストエフォート方式で提供されます。

currency=USDなどの3文字の通貨コードを含めると、通行料金の通貨換算をリクエストできます。

以下は、通過時間と車高に基づいて請求されるトンネルを通過するルートの通行料金を米ドルでリクエストしています。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=51.307986,4.327722&'\
'destination=51.282912,4.286618&'\
'return=tolls&'\
'transportMode=truck&'\
'vehicle[height]=310&'\
'departureTime=2021-01-01T21:00:00&'\
'currency=USD&'\
'apiKey=YOUR_API_KEY'

{
  "routes": [
    {
      "id": "395379a4-2db7-485e-ad10-911ffce911cf",
      "sections": [
        {
          "id": "700c42a0-a981-4817-a250-74037c7699ba",
          "type": "vehicle",
          "departure": {
            "time": "2021-01-01T21:00:00+01:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 51.3079803,
                "lng": 4.3277143
              },
              "originalLocation": {
                "lat": 51.307986,
                "lng": 4.3277219
              }
            }
          },
          "arrival": {
            "time": "2021-01-01T21:06:15+01:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 51.2828957,
                "lng": 4.286669
              },
              "originalLocation": {
                "lat": 51.2829119,
                "lng": 4.2866179
              }
            }
          },
          "transport": {
            "mode": "truck"
          },
          "tolls": [
            {
              "countryCode": "BEL",
              "tollSystem": "LIEFKENSHOEKTUNNEL",
              "fares": [
                {
                  "id": "26051851-9c7f-4635-933f-bd3022c1743e",
                  "name": "LIEFKENSHOEKTUNNEL",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 14.16
                  },
                  "convertedPrice": {
                    "type": "value",
                    "currency": "USD",
                    "value": 17.08
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "transponder"
                  ]
                },
                {
                  "id": "7ee701ba-5967-4236-aa74-38deb0cc063c",
                  "name": "LIEFKENSHOEKTUNNEL",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 19
                  },
                  "convertedPrice": {
                    "type": "value",
                    "currency": "USD",
                    "value": 22.91
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "cash"
                  ]
                },
                {
                  "id": "266bfb58-9114-4254-a785-7b1941a6383d",
                  "name": "LIEFKENSHOEKTUNNEL",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 17.6
                  },
                  "convertedPrice": {
                    "type": "value",
                    "currency": "USD",
                    "value": 21.23
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "bankCard",
                    "creditCard",
                    "travelCard"
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

先月の更新