Get toll costs when paying with transponders

Transponders are wireless, in-vehicle payment devices that use RFID, microwaves, or other wireless communication methods to enable automatic toll payments.

This solution is used around the world and is sometimes designated as the mandatory means of toll payment for heavy vehicles, such as trucks. The benefits of paying by transponders include convenience, speed, and, in some cases, cheaper fares.

Example systems include:

ETC Japan
EZ-Pass (USA)
GO-Box (AUT)

Usage

To get toll costs for payment with transponders, add the return=tolls and tolls[transponders]=all options to your route calculation request. This results in the following behavior:

Only transponder-specific fares are returned.
If you request a tolls summary, transponder-specific fares are used to calculate it.

📘
Note
Requesting toll cost information for routes counts as an additional transaction.

If you don't add the tolls[transponders]=all option, the API returns costs for payment with other means, such as cards or cash. Fares for transponder payment are omitted unless they are the only option available.

Example

The first request calculates a route where all tolls can be paid by means other than transponder systems. When you add the tolls[transponders]=all option as shown in the second request, the means of payment for the Liefkenshoektunnel tunnel changes to a transponder. Note how the response for the second request contains a list of transponder systems supported for the Liefkenshoektunnel payment.

Request without transponder fares

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=51.255598,4.260537&'\
'destination=51.316223,4.337377&'\
'return=tolls&'\
'transportMode=car&'\
'departureTime=any&'\
'apiKey=YOUR_API_KEY'

{
  "routes": [
    {
      "id": "9e10cd65-373a-490c-8391-aee1190f8828",
      "sections": [
        {
          "id": "f821525e-f4cb-4966-b6d6-5442f3fa1ead",
          "type": "vehicle",
          ...,
          "transport": {
            "mode": "car"
          },
          "tolls": [
            {
              "countryCode": "BEL",
              "tollSystemRef": 0,
              "tollSystem": "LIEFKENSHOEKTUNNEL",
              "fares": [
                {
                  "id": "f4d356a1-7e8e-49b7-8fbe-fbc6a14394ab",
                  "name": "LIEFKENSHOEKTUNNEL",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 5.6
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "bankCard",
                    "creditCard",
                    "travelCard"
                  ]
                },
                {
                  "id": "c878e538-58ea-4968-94b7-8e22a696e0d8",
                  "name": "LIEFKENSHOEKTUNNEL",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 7.0
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "cash"
                  ]
                }
              ],
              "tollCollectionLocations": [
                {
                  "name": "Kallo",
                  "location": {
                    "lat": 51.28629,
                    "lng": 4.28951
                  }
                }
              ]
            }
          ],
          "tollSystems": [
            {
              "name": "LIEFKENSHOEKTUNNEL"
            }
          ]
        }
      ]
    }
  ]
}

Request with transponder fares

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=51.255598,4.260537&'\
'destination=51.316223,4.337377&'\
'return=tolls&'\
'tolls[transponders]=all&'\
'transportMode=car&'\
'departureTime=any&'\
'apiKey=YOUR_API_KEY'

{
  "routes": [
    {
      "id": "61b324f5-7c73-4dc0-95eb-4eadd09742af",
      "sections": [
        {
          "id": "f4c48fb5-4ee1-4137-95b4-df11be61057b",
          "type": "vehicle",
          ...,
          "transport": {
            "mode": "car"
          },
          "tolls": [
            {
              "countryCode": "BEL",
              "tollSystemRef": 0,
              "tollSystem": "LIEFKENSHOEKTUNNEL",
              "fares": [
                {
                  "id": "26274842-b8ab-42eb-b7a4-37815a8884a9",
                  "name": "LIEFKENSHOEKTUNNEL",
                  "price": {
                    "type": "value",
                    "currency": "EUR",
                    "value": 4.0
                  },
                  "reason": "toll",
                  "paymentMethods": [
                    "transponder"
                  ],
                  "transponders": [
                    {
                      "system": "BP TOLLBOX"
                    },
                    {
                      "system": "DKV BOX EUROPE"
                    },
                    {
                      "system": "EUROWAG"
                    },
                    {
                      "system": "Eurotoll Tribox-Air Trucks"
                    },
                    {
                      "system": "PASSango EuroPilot Trucks "
                    },
                    {
                      "system": "PASSango Europe Trucks"
                    },
                    {
                      "system": "Telepass EU Trucks"
                    },
                    {
                      "system": "UTA"
                    },
                    {
                      "system": "Viaxxès SAT Trucks"
                    },
                    {
                      "system": "Viaxxès Trucks"
                    }
                  ]
                }
              ],
              "tollCollectionLocations": [
                {
                  "name": "Kallo",
                  "location": {
                    "lat": 51.28629,
                    "lng": 4.28951
                  }
                }
              ]
            }
          ],
          "tollSystems": [
            {
              "name": "LIEFKENSHOEKTUNNEL"
            }
          ]
        }
      ]
    }
  ]
}

Avoid transponder tolls

To calculate a route that avoids route sections with tolls that can be paid only by transponders, add the avoid[tollTransponders]=all option to the route calculation request.