HERE Routing v8: Toll Calculation with Emission Type and CO2 Class

APIs

3 min read

07 December 2023

HERE Routing v8: Toll Calculation with Emission Type and CO2 Class

screenshot 2023 12 06 at 10.34.23 am.png

The German federal parliament (Bundestag) recently approved an additional CO2 surcharge to truck toll costs, effective from December 1, 2023. The surcharge amount varies based on the vehicle's characteristics. This blog explores how HERE Routing v8 now incorporates CO2 emission class considerations in toll calculations.

HERE Routing V8: CO2 Class in Toll Calculation

HERE Routing v8 has been updated to include the parameter tolls[emissionType], supporting the CO2 emission class, co2class. This parameter defines emission types and CO2 emission classes according to the toll operator's specifications, based on emission standards. Emission types are disclosed only when toll costs are determined by emission type classes.

Format:

The format is going to be the following: EmissionType[CO2EmissionClass]

EmissionType is specified as euro6, euro5, etc., with allowed values including [euro1, euro2, euro3, euro4, euro5, euro6, euroEev].

CO2EmissionClass is optional, specified as ;co2class=1, ;co2class=2, etc., with allowed values for co2class being [1, 2, 3, 4, 5].

Sample Requests:

The request for only toll emission type (euro6), without CO2 emission class: euro6

https://router.hereapi.com/v8/routes?
....
&toll[emissionType]=euro6
....
&return=tolls

The request for toll emission type (euro6) with CO2 emission class (class3): euro6;co2class=3

https://router.hereapi.com/v8/routes?
....
&toll[emissionType]=euro6;co2class=3
....
&return=tolls

NOTE: When not specified, co2class defaults to 1. Providing an invalid combination of EmissionType and CO2EmissionClass may result in unexpected tolls.

NOTE: This parameter is not compatible with EV routing. When EV routing is used, the appropriate emission type (Electric Vehicle) is used.

Sample Response:

Request to Routing API including the toll cost from Lübeck to Rotenburg, Germany via Bundesstraße 75.

https://router.hereapi.com/v8/routes?
origin=53.860802,10.686913
&destination=53.11246,9.41141
&return=travelSummary,tolls
&currency=Eur
&transportMode=truck
&tolls[summaries]=total
&apikey=<...>
&toll[emissionType]=euro6;co2class=3

Response from Routing API including the toll cost from Lübeck to Rotenburg, Germany via Bundesstraße 75.

{
    "notices": [...],
    "routes": [
        {
            "id": "39f158c4-c19b-4899-af5b-3b2626812466",
            "sections": [
                ...
                    "travelSummary": {
                        "duration": 7454,
                        "length": 141115,
                        "baseDuration": 7452,
                        "tolls": {
                            "total": {
                                "type": "value",
                                "currency": "EUR",
                                "value": 26.0474
                            }
                        }
                    },
                    "transport": {
                        "mode": "truck"
                    },
                    "tolls": [
                        {
                            "countryCode": "DEU",
                            "tollSystemRef": 0,
                            "tollSystem": "TOLL COLLECT GMBH",
                            "fares": [
                                {
                                    "id": "695afc0c-10d9-439a-9101-117c376fd543",
                                    "name": "TOLL COLLECT GMBH",
                                    "price": {
                                        "type": "value",
                                        "currency": "EUR",
                                        "value": 25.08
                                    },
                                    "convertedPrice": {
                                        "type": "value",
                                        "currency": "EUR",
                                        "value": 25.08
                                    },
                                    "reason": "toll",
                                    "paymentMethods": [
                                        "cash",
                                        "bankCard",
                                        "creditCard",
                                        "transponder",
                                        "travelCard"
                                    ]
                                }
                            ]
                        }
                        ...
                    ],
                    "tollSystems": [
                        {
                            "id": 5200,
                            "name": "TOLL COLLECT GMBH"
                        }
                    ]
                }
            ]
        }
    ]
}

Closing Thought

The integration of CO2 emission class considerations in toll calculations by HERE Routing v8 offers a customizable approach. Users can utilize parameters like tolls[emissionType] and co2class to tailor toll calculations based on specific vehicle characteristics.