Toll information

Toll costs can be obtained by including tolls in return parameter and are available for the following transport modes:

  • car
  • truck
  • taxi
  • bus

Each section of the route will contain a list of applicable tolls, with their names, payment methods, prices in local currencies and, if applicable, converted prices in requested currency. The granularity of the toll costs can span from the entire route (in case of vignette) to individual road segments (in case of pay-per-km truck tolls).

Depending on the toll system, toll prices may differ based on the payment method, vehicle characteristics, time of passage and other factors. Vehicle characteristics can be specified (to some extent) with transportMode, vehicle[hovOccupancy] and, in the truck mode, with truck profile. The time of passage is calculated from ETA, if the departure time is specified. Due to complexity of various toll systems, the prices are provided on the best-effort basis.

Currency conversion of the toll prices can be requested by including the currency three-letter code, e.g., currency=USD.

Examples

A Request for tolls in USD for a route through a tunnel which is billed based on the time of passage and vehicle height:

curl -X GET \
'https://router.hereapi.com/v8/routes?origin=51.307986,4.327722&destination=51.282912,4.286618&return=tolls&transportMode=truck&truck[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"
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

A Request for tolls for a multi-leg route including a paid highway with a stopover in a rest area, disregarding departure time. The toll is paid in the second section, after the stopover, at the highway exit booth:

curl -X GET \
'https://router.hereapi.com/v8/routes?origin=41.465218,1.912036&destination=41.447398,1.865010&via=41.455196,1.882819&return=tolls&transportMode=car&departureTime=any&apikey={YOUR_API_KEY}'
{
  "routes": [
    {
      "id": "bc63ecb7-dd44-4c76-a9e4-baec8629a5d1",
      "sections": [
        {
          "id": "319cad34-5e89-4723-90fe-5b0e50c45f43",
          "type": "vehicle",
          "departure": {
            "place": {
              "type": "place",
              "location": {
                "lat": 41.4651747,
                "lng": 1.9120686
              },
              "originalLocation": {
                "lat": 41.465218,
                "lng": 1.912036
              }
            }
          },
          "arrival": {
            "place": {
              "type": "place",
              "location": {
                "lat": 41.4551983,
                "lng": 1.8828158
              },
              "originalLocation": {
                "lat": 41.4551959,
                "lng": 1.8828189
              },
              "waypoint": 0
            }
          },
          "transport": {
            "mode": "car"
          }
        },
        {
          "id": "0ff92e1b-3bda-4dae-bc5c-7af672f22fbb",
          "type": "vehicle",
          "departure": {
            "place": {
              "type": "place",
              "location": {
                "lat": 41.4551983,
                "lng": 1.8828158
              },
              "originalLocation": {
                "lat": 41.4551959,
                "lng": 1.8828189
              },
              "waypoint": 0
            }
          },
          "arrival": {
            "place": {
              "type": "place",
              "location": {
                "lat": 41.4473975,
                "lng": 1.8650177
              },
              "originalLocation": {
                "lat": 41.447398,
                "lng": 1.8650099
              }
            }
          },
          "transport": {
            "mode": "car"
          },
          "tolls": [
            {
              "countryCode": "ESP",
              "tollSystem": "AUTOPISTAS AP2-AP7",
              "fares": [
                {
                  "id": "48a15121-4d1d-4218-b5e1-7ba8d5ffb289",
                  "name": "AUTOPISTAS AP2-AP7",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 2.5
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "cash",
                    "bankCard",
                    "creditCard",
                    "transponder",
                    "travelCard"
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

results matching ""

    No results matching ""