Europe Tolls (TollDetail)
Contents
Toll information for routes in Europe is available as a premium add-on feature. Europe toll information is generated by calling the Toll Detail Report through a POST request. The report provides toll information for each segment of the route as well as an overall summary of the toll information, by country.
Tolls for routes in North America are available to Premium web services customers in several Route Reports, including Mileage, Comparison and Detailed reports.
In addition to the standard reporting and routing options, this API takes into account the dimensions of both the truck and trailer to generate the most accurate toll costs. These can be set using our TruckConfig and TrailerConfig objects.
| Dimension | How to Use in Toll Detail Report |
|---|---|
Weight
| TruckConfig.Weight and TrailerConfig.MaxWeight are added together as the total vehicle weight used in calculations. |
Height
| The values of the TruckConfig.Height and TrailerConfig.MaxHeight are compared and the higher value is selected as the vehicle height used in calculations. |
Axle Count
| TruckConfig.Axles and TrailerConfig.MaxAxles are passed in as separate parameters for toll calculations. They must add up to the total number of axles on the vehicle. These values are not used in the routing. |
Please see additional Notes on Europe Tolls below.
POST /route/routeReports
Sample JSON POST Body
{
"ReportRoutes": [
{
"ReportingOptions": {
"UseTollData": true,
"FuelUnits": 1,
"TollCurrency": 11,
"IncludeFerryDistance": false
},
"ReportTypes": [
{
"__type": "TollDetailReportType:http://pcmiler.alk.com/APIs/v1.0"
}
],
"RouteId": "DemoRoute",
"Stops": [
{
"Costs": null,
"Coords": {
"Lat": 48.857196,
"Lon": 2.341414
},
"Region": 3
},
{
"Costs": null,
"Coords": {
"Lat": 48.202614,
"Lon": 16.368460
},
"Region": 3
}
],
"Options": {
"BordersOpen": true,
"HighwayOnly": false,
"TollDiscourage": false,
"TrailerCfg": {
"TypeOfTrailer": 2,
"Count": 1,
"MaxHeight": 4.0,
"MaxWeight": 20000,
"MaxAxles": 3,
"Engine": {
"Hybrid": false,
"EmissionType": 7,
"MinPollutionVeh": false
}
},
"TruckCfg": {
"LCV": false,
"Units": 1,
"Height": 4.0,
"Width": 2.55,
"Length": 12.0,
"Weight": 18000,
"Axles": 2
}
}
}
]
}
Sample Response
[
{
"__type": "TollDetailReport:http://pcmiler.alk.com/APIs/v1.0",
"RouteID": "DemoRoute",
"SegmentLines": [
{
"Country": "FR",
"Road": "A 4 - Autoroute de l'Est",
"TollName": "SANEF",
"DistanceBased": "",
"Pass": "",
"Flat": "6.70"
},
{
"Country": "FR",
"Road": "A 4 - Autoroute de l'Est",
"TollName": "SANEF",
"DistanceBased": "",
"Pass": "",
"Flat": "71.00"
},
{
"Country": "FR",
"Road": "A 4 - Autoroute de l'Est",
"TollName": "SANEF",
"DistanceBased": "",
"Pass": "",
"Flat": "14.30"
},
{
"Country": "GM",
"Road": "A 6",
"TollName": "TOLL COLLECT GMBH",
"DistanceBased": "20.96",
"Pass": "",
"Flat": ""
},
{
"Country": "GM",
"Road": "Exit 21 (Koblenz)",
"TollName": "TOLL COLLECT GMBH",
"DistanceBased": "0.17",
"Pass": "",
"Flat": ""
},
{
"Country": "GM",
"Road": "A 61",
"TollName": "TOLL COLLECT GMBH",
"DistanceBased": "7.44",
"Pass": "",
"Flat": ""
},
{
"Country": "GM",
"Road": "A 6",
"TollName": "TOLL COLLECT GMBH",
"DistanceBased": "11.65",
"Pass": "",
"Flat": ""
},
{
"Country": "GM",
"Road": "A 6",
"TollName": "TOLL COLLECT GMBH",
"DistanceBased": "31.56",
"Pass": "",
"Flat": ""
},
{
"Country": "GM",
"Road": "Exit 61 (Würzburg)",
"TollName": "TOLL COLLECT GMBH",
"DistanceBased": "0.03",
"Pass": "",
"Flat": ""
},
{
"Country": "GM",
"Road": "Passau Exit",
"TollName": "TOLL COLLECT GMBH",
"DistanceBased": "0.19",
"Pass": "",
"Flat": ""
},
{
"Country": "GM",
"Road": "A 3",
"TollName": "TOLL COLLECT GMBH",
"DistanceBased": "42.81",
"Pass": "",
"Flat": ""
},
{
"Country": "AU",
"Road": "A 8 - Innkreis Autobahn",
"TollName": "ASFINAG GO-MAUT",
"DistanceBased": "25.58",
"Pass": "",
"Flat": ""
},
{
"Country": "AU",
"Road": "A 25 - Linzer Autobahn",
"TollName": "ASFINAG GO-MAUT",
"DistanceBased": "8.29",
"Pass": "",
"Flat": ""
},
{
"Country": "AU",
"Road": "A 1 - West Autobahn",
"TollName": "ASFINAG GO-MAUT",
"DistanceBased": "2.68",
"Pass": "",
"Flat": ""
},
{
"Country": "AU",
"Road": "A 1 - West Autobahn",
"TollName": "ASFINAG GO-MAUT",
"DistanceBased": "60.92",
"Pass": "",
"Flat": ""
},
{
"Country": "AU",
"Road": "A 1 - West Autobahn",
"TollName": "ASFINAG GO-MAUT",
"DistanceBased": "9.15",
"Pass": "",
"Flat": ""
}
],
"SummaryLines": [
{
"Country": "Austria",
"TollType": "Distance Based",
"TollName": "ASFINAG GO-MAUT",
"TollDistance": "157.78",
"TollsLocal": "106.62 EUR",
"Tolls": "106.62",
"PaymentOption": "Transponder"
},
{
"Country": "France",
"TollType": "Special Toll Charges",
"TollName": "SANEF",
"TollDistance": "",
"TollsLocal": "92.00 EUR",
"Tolls": "92.00",
"PaymentOption": "Cash"
},
{
"Country": "Germany",
"TollType": "Distance Based",
"TollName": "TOLL COLLECT GMBH",
"TollDistance": "360.31",
"TollsLocal": "114.81 EUR",
"Tolls": "114.81",
"PaymentOption": "Cash"
}
],
"TollCurrency": 11
}
]
Toll Detail Report Response
| Data Element | Description | Data Type | Value/Example |
|---|---|---|---|
type
| Describes the type of report and what it does. |
string | TollDetailReport |
RouteID
| The route identification key(Can be null) |
Int | |
SegmentLines
| Indicates the country, road, toll name, distance based cost, toll pass cost and flat rate cost for each toll. |
Complex | |
SummaryLines
| Indicates the country, toll type, toll name, toll distance (for distance based tolls), the toll cost in local currency, toll cost in EUR and the payment option. |
Complex | |
TollCurrency
| Indicates the toll currency used for the Summary Lines. |
Enum(int) |
SegmentLines
| Data Element | Description | Data Type | Value/Example |
|---|---|---|---|
Country
| Country abbreviation. |
string | UK |
Road
| The name of the toll road |
string | A 501 - Marylebone Road |
TollName
| Indicates the name of the toll. |
string | UK HGV LEVY ENGLAND |
DistanceBased
| Toll cost if the toll is distance based. |
double | 5.29 |
Pass
| Toll cost if the toll requires a pass. |
string | DayPass :2.70 |
Flat
| Toll cost if the toll has a flat rate. |
string | 85.70 |
SummaryLines
| Data Element | Description | Data Type | Value/Example |
|---|---|---|---|
Country
| Country name. |
string | United Kingdom |
Toll Type
| Indicates the type of the toll. |
string | Distance Based |
TollName
| Indicates the name of the toll. |
string | UK HGV LEVY ENGLAND |
TollDistance
| If the toll is distance based, this will be the distance used in toll calculation. |
double | 5.29 |
TollsLocal
| Toll cost in local currency. |
string | 2.70 GBP |
Tolls
| Toll cost in EUR. |
double | 3.16 |
PaymentOption
| Toll payment option. |
string | Cash |
Notes on Europe Tolls
Vehicle Types
Toll results are validated for trucks with a weight greater than 3.5 tons only.
Vignettes
The result for vignette-style toll systems will show the price of a one-day tariff as default, with a rate specific to a country and vehicle setup. The vignette price is supported in the toll cost per country result, but not added to the total. This is done in order to not interfere with already existing vignettes for the vehicle making the trip. For example, if there is a valid one-year vignette already assigned to a vehicle, it would not be ideal to add the cost of a one-day vignette to the total by default.
The Eurovignette is valid in Luxembourg, Netherlands, Denmark and Sweden. The cost of a one-day Eurovignette is displayed for each country, even if a truck is traveling more than one of these countries within the valid time frame of the vignette.
Discounts
Discounts are not currently supported. Discounts might be granted by toll providers, resulting in a reduced toll price—for example, by paying with a specific payment type like a credit card or for return journeys using the same structure within a limited time frame.
Time-based Tolls
For time-based tolls to work correctly, departure time must be entered. In case it is not, the highest toll for the given vehicle profile will be returned.
For countries with time-based tolls, the different tariffs will switch exactly as scheduled. This is consistent with the tolling schemes in reality, but technical circumstances might cause minor differences between the calculated toll cost and the actual toll cost. For example, when switching from the day tariff to the night rate at 10 p.m. in Austria, our calculation will do so at that moment. In reality, the onboard-unit of the truck will also switch tariffs, but only after passing one of the automated control points, which are being passed every few kilometers.
Ferries
Ferry costs are not included.