TollGuru Toll API
- Calculate tolls for your route.
- Calculate other costs for your route (such as fuel expenses, driver expenses).
- Calculate the cheapest, the fastest and other other optimal routes.
By integrating our API with your application or website, you can provide your users with a powerful tool for efficient and cost-effective route planning.
How to use TollGuru and TollTally API
With the Toll API you can calculate tolls, fuel costs and optimal routes for:
Pre-trip planning
- Specify origin, destination and waypoints, if any
- Specify pre-trip route polyline or shape (latitude, longitude coordinates) from any mapping service including Google, Bing, MapBox, Apple Map, HERE, TomTom, Waze, ESRI, MapQuest, JawgMaps, Trimble, PTV, MapmyIndia, Yandex, Michelin, Baidu, Gaode or your custom source
Post-trip toll cost reconciliation
- Send GPS tracks, such as those received from a smartphone, car GPS or a fleet telematics device.
Get started
Sign up for a free API key using your email and password. We suggest you use Postman to test the API before you integrate Toll API into your products. TollGuru Toll API is a REST API with predictable resource-oriented URLs. It uses standard HTTP response codes and authentication to accept form-encoded request bodies and return JSON-encoded responses.
Authentication
Registering for a new TollGuru developer API key at TollGuru developer portal.
Sign up for a trial account using your business email to get 150 transactions/day. If you sign up with a personal email, your trial includes 15 transactions/day. For a higher daily limit, please reach out to us at api@tollguru.com, providing details about your business and how you plan to use the API.
Adding API Key to Your Request
The API key should be included in all API requests to the server in the header. In the following example, replace DEVELOPER_KEY with your API key. It should look like:
| Header Parameter Name | Security Schema Type |
|---|---|
| x-api-key | apiKey |
TollGuru - Origin, Destination and Waypoints
- Calculate tolls for various vehicle types including cars, pickups, SUV towing trailers, taxis, trucks (up to 9-axles), RV, motorcycles, etc.
- See tolls for all routes
- See fuel expenses for all routes
- See the cheapest, the fastest and other optimal routes
- Modify vehicle types to include
Specifically, for trucks, you can
- Return tolls by specifying zip codes (zip code followed by country name)
- Return tolls for truck compliant routes (based on axle count, height, weight, truck length
- Return Hours-of-service (HOS) compliant routes with information for suggested stop locations
- Return distance traveled in each state (mileage per state)
Questions for constructing request body
- How to make requests using addresses?
- How to make requests using geo-coordinates?
- How to add waypoints?
- How to choose a mapping service provider?
- How to customize a vehicle?
- How to customize fuel related information?
- How to get turn by turn directions in response?
- How to get tolls on your route based on departure time?
- How to get state mileage information for North America?
- How to get tolls for EV along with charging points for North America?
- How to get vignette information for Europe?
Tolls between Origin, Destination and Waypoints
If you are looking for toll information for routes that consider bridge height restrictions, axle count, weight restrictions, we suggest that you use HERE maps (we use HERE maps by default). Specifically, with the HERE maps API service, you can:
- Specify origins, destinations, and waypoints as text strings (e.g. “Dallas, TX”, “Sydney, NSW, Australia”, “Paris, France” or “Jaipur, Rajasthan, India”), as place IDs, or as latitude/longitude coordinates
- Specify origin, destination, and waypoints as zip codes (followed by country code or name)
- Specify vehicle type. The route and tolls are returned for the specific vehicle. For example, you can get tolls for vehicles based on axle count (cars, SUV, pick-up, truck, motorcycle, bus, motorhome / RV, limousine.
- The response will include toll information, fuel cost information, duration
Request Schema
fromobject+−requiredThe starting point of the trip
- One of:
- addressstringSpecify address as string. Example: New York, NY
- place_idstringSpecify as Google Place ID string. Example-ChIJlTlXssSPxokROy60gaOlloQ
- latnumberSpecify as geo-coordinates in decimals (latitude)
- lngnumberSpecify as geo-coordinates in decimals (longitude)
toobject+−requiredThe end point of the trip
- One of:
- addressstringSpecify address as string. Example: New York, NY
- place_idstringSpecify as Google Place ID string. Example-ChIJlTlXssSPxokROy60gaOlloQ
- latnumberSpecify as geo-coordinates in decimals (latitude)
- lngnumberSpecify as geo-coordinates in decimals (longitude)
- serviceProviderstringThe map service provider to fetch routes from. Default: herePossible values:heregmaps
waypointsobject+−Specify a range of intermediary locations, along your route between your origin and destination points
- One of:
- addressstringSpecify address as string. Example: New York, NY
- place_idstringSpecify as Google Place ID string. Example-ChIJlTlXssSPxokROy60gaOlloQ
- latnumberSpecify as geo-coordinates in decimals (latitude)
- lngnumberSpecify as geo-coordinates in decimals (longitude)
vehicleobject+−Options to configure vehicle parameters
- typestringThese vehicles are specific to US region. For more information about vehicle types, click here.Possible values:2AxlesAuto3AxlesAuto4AxlesAuto2AxlesDualTire3AxlesDualTire4AxlesDualTire2AxlesEV3AxlesEV4AxlesEV2AxlesTNC2AxlesTNCPool2AxlesTaxi2AxlesTaxiPoolCarpool2Carpool32AxlesTruck3AxlesTruck4AxlesTruck5AxlesTruck6AxlesTruck7AxlesTruck8AxlesTruck9AxlesTruck2AxlesBus3AxlesBus2AxlesMotorcycle3AxlesMotorcycle2AxlesRv3AxlesRv4AxlesRv
weightobject+−The weight of the vehicle
- valuenumber
- unitstringPossible values:kgpoundtonnes
heightobject+−The height of the vehicle
- valuenumber
- unitstringPossible values:meterfeet
lengthobject+−The length of the vehicle
- valuenumber
- unitstringPossible values:meterfeet
- axlesnumberNumber of axles on the vehicle
- emissionClassstringThe emission class of the vehicle (only for Europe)Possible values:euro_0euro_1euro_2euro_3euro_4euro_5euro_6euro_eeveuro_15
- co2EmissionClassnumberVehicle CO2 emission category (only for Europe)Possible values:0 - 5
- allowFerrybooleanA flag indicating whether or not to include ferry routes in the trip if available. By default, only land routes are provided.
- countrystringSpecify the country code in ISO 3166-1 alpha-3 format (For example, USA, CAN, AUS, JPN, CHN, etc.)
Response Schema
- statusstringPossible values:okerror
summaryobject+−Summary including distance, time (duration), name, whether the route has tolls (hasTolls), diffs object that shows the difference between the cost between the cheapest route and current route and difference in duration between the current route and the fastest route.
routearray+−The list of points along the current route
locationobject+−The geographic coordinates for the given location
- latnumberThe latitude of the coordinate
- lngnumberThe longitude of the coordinate
- addressstringThe human-readable address for the given location (Note: The address field in the response will be available only if the address parameter is sent in the request body)
countriesarray+−The list of countries that the current route spans
- stringstring
- currencystringThe currency unit used for calculations
- vehicleTypestringThe vehicle type used for calculations. For more information about vehicle types, click here.Possible values:2AxlesAuto3AxlesAuto4AxlesAuto2AxlesDualTire3AxlesDualTire4AxlesDualTire2AxlesEV3AxlesEV4AxlesEV2AxlesTNC2AxlesTNCPool2AxlesTaxi2AxlesTaxiPoolCarpool2Carpool32AxlesTruck3AxlesTruck4AxlesTruck5AxlesTruck6AxlesTruck7AxlesTruck8AxlesTruck9AxlesTruck2AxlesBus3AxlesBus2AxlesMotorcycle3AxlesMotorcycle2AxlesRv3AxlesRv4AxlesRv
- vehicleDescriptionstringThe provided vehicle description
fuelPriceobject+−Fuel price from request or the default fuel price (including currency)
- valuenumberThe cost of fuel in a specified unit
- currencystringThe currency in which the fuel cost is represented
- unitsstringMeasurement unit for fuel cost
- fuelUnitstringMeasurement unit for fuel
fuelEfficiencyobject+−If you want an accurate estimate of fuel expenses, you will need to specify parameters specific to fuel price and fuel efficiency as fuelEfficiency object.
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringDefault: kmpl
Measurement units for efficiency values. If the fuel price is in liter, then we expect fuel efficiency to be in kmpl or L/100km, similarly, if it is in gallons, then we expect, efficiency in mpg.Possible values:mpgkmplL/100km - fuelUnitstringMeasurement unit for fuel value
unitsobject+−A summary of the measurement units used for calculations
- currencyUnitstringThe currency unit specified in the request
- fuelEfficiencyUnitstringThe fuel efficiency units specified in the request
- fuelUnitstringThe fuel units specified in the request
- departureTimestringThe provided start time for the trip. If departure_time and locTimes both are not specified then we will use the current time for toll calculations.Possible values:DateTime (string)TimeStamp (number)
shareobject+−Shareable parameters for this response
- namestring
- prefixstring
- uuidstring
- timestampstring
- clientstring
- sourcestringThe map provider source used to get the list of possible routes
routesarray+−A list of possible routes for the given trip
summaryobject+−Summary including distance, time (duration), name, whether the route has tolls (hasTolls), diffs object that shows the difference between the cost between the cheapest route and current route and difference in duration between the current route and the fastest route.
- hasTollsbooleanValue indicating whether there are any tolls along the current route
- hasExpressTollsbooleanValue indicating whether there are any express tolls along the current route
diffsobject+−The difference in overall cost between the given trip and the cheapest and fastest trips
- cheapestnumber
- fastestnumber
- urlstringURL for navigation for the current route through Google Maps
distanceobject+−The total distance of the current route
- textstringThe display value for the distance
- metricstringThe measurement unit for the distance
- valuenumberThe actual distance value
durationobject+−The estimated travel duration of the current route
- textstringThe display value for the duration
- valuenumberThe actual duration value in seconds
durationInTrafficobject+−The estimated travel duration in traffic for the current route.(Available only when serviceProvider: gmaps)
- textstringThe display value for the duration
- valuenumberThe actual duration value in seconds
- namestringThe name of the current route
- notearray
costsobject+−Costs object summarizes the toll cost and the fuel cost for the route.The fuel costs calculated from fuel efficiency (city fuel efficiency and highway fuel efficiency) and the speeds on each leg of the route.The tolls are added for all the tolls on the route for each payment type. If a payment type cannot be using on all the toll points on the route, the toll cost is returned as false. Else, the sum of tolls for the payment type is returned.
The tolls are returned for the following payment types:- Cash
- Transponder
- License Plate
- Credit card
- Prepaid pass
- tagAndCashnumberThe minimum cost between tag and cash
- minimumTollCostnumberThe minimum total cost
- maximumTollCostnumberThe maximum total cost
- fuelnumberThe calculated cost for fuel
- tagnumberThe calculated toll cost for tags
- cashnumberThe calculated cost for cash
- prepaidCardnumberThe calculated cost for prepaid cards
- licensePlatenumberThe calculated license cost for plate
tollsarray+−Array containing Open system - "barrier" (object) and Closed system - "ticketSystem1" (object), "ticketSystem2" (object), "ticketSystem3" (object), "distBarrier" (object).
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
- typestringType of the Toll System
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- tagPriCostnumberPrimary transponder cost, typically offering standard or discounted rates
- tagSecCostnumberSecondary transponder cost, usually without discounts
- cashCostnumberCash toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardNamesarray of stringsNames of prepaid cards accepted at the toll facility, eg: E-Toll
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
arrivalobject+−
- distancenumberDistance to the toll location in meters.
- timestringEstimated time of arrival (ETA) at the toll location in ISO 8601 format, e.g., '2024-12-17T12:30:00Z'
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem1
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem2
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem3
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
directionsarray+−
positionobject+−
- latitudenumber
- longitudenumber
- maneuverstring
- html_instructionsstring
- distancenumber
- durationnumber
- notearray
taxiChargesobject+−Only visible when vehicle type is of type "Taxi".
taxiFarearray+−
- statestring
startobject+−
geometryobject+−
- coordinatesarrayExample: [-75.360105,40.614533]
endobject+−
geometryobject+−
- coordinatesarrayExample: [-75.360105,40.614533]
- distanceTravellednumber
- costPerUnitMilenumber
- taxiFareForDistanceTravellednumber
congestionSurchargearray+−Example: congestionSurcharge: [{"zone": "New York Congestion Zone 1", "charge": 2.5}]
Objectobject+−
- zonestring
- chargenumber
airportChargesarray+−Example: airportCharges: [{"name": "Hartsfield–Jackson Atlanta International Airport", "pickupCharge": 3.85, "dropOffCharge": 3.85, }]
Objectobject+−
- namestring
- pickupChargenumber
- dropOffChargenumber
taxiSummaryobject+−
- totalTaxiCostnumber
- totalTaxiFarenumber
- totalDistanceTravellednumber
- totalExtraChargesnumber
- tollCostnumber
- currencystring
- distanceUnitstring
- polylinestringA base64 encoded linestring representing the current route
vignettesarray+−
- typestring
- countrystring
- countryCodestring
ratesarray+−
- durationstring
- vignetteCostnumber
- currencyUnitstring
vignetteCoordinatesobject+−
- typestring
coordinatesarray+−
- numbernumber
chargingPointsarray+−Only visible when vehicle type is EV and region is US
- idnumber
evStationobject+−
contactobject+−
- phonestring
- brandstring
- connectorTypestring
powerFeedTypesarray+−
- totalNumberOfConnectorsnumber
- idnumber
- namestring
- facilityTypestring
- addressstring
positionobject+−
pointobject+−
- typestring
- propertiesobject
geometryobject+−
- typestring
coordinatesarray+−
- numbernumber
pricingStructureTypeobject+−
- descriptionstring
- accessTimestring
- otherInfostring
- namestring
metaobject+−The metadata associated with the request
- typestringType of user
- clientstringClient accessing the API (e.g., "web", "mobile")
- sourcestringMapping service, e.g., HERE Maps, Google Maps, etc.
- userIdstringUnique identifier for the user (e.g., email)
- customerIdstringUnique identifier for the customer
- txnumberNumber of transactions done
Request
Response
Tolls for Truck
For truck routes you can specify restrictions - bridge height restrictions, axle count, weight restrictions - to receive truck compliant routes. But you don’t need to send all the parameters. You can
- Specify origins, destinations, and waypoints as text strings (e.g. “Dallas, TX”), as place IDs, or as latitude/longitude coordinates
- Specify origin, destination, and waypoints as zip codes (followed by country code or name)
- Specify truck type by changing the number of axles and other parameters such as weight, height, etc.
- The response will include toll information, fuel cost information, duration
For trucks, you will receive
- Tolls between zip codes (zip code followed by country name)
- Truck compliant routes (based on axle count, height, weight, truck length.
- ETA that accounts for Hours-of-service (HOS) compliance
- State mileage for IFTA reporting
Request Schema
fromobject+−requiredThe starting point of the trip
- One of:
- addressstringSpecify address as string. Example: New York, NY
- place_idstringSpecify as Google Place ID string. Example-ChIJlTlXssSPxokROy60gaOlloQ
- latnumberSpecify as geo-coordinates in decimals (latitude)
- lngnumberSpecify as geo-coordinates in decimals (longitude)
toobject+−requiredThe end point of the trip
- One of:
- addressstringSpecify address as string. Example: New York, NY
- place_idstringSpecify as Google Place ID string. Example-ChIJlTlXssSPxokROy60gaOlloQ
- latnumberSpecify as geo-coordinates in decimals (latitude)
- lngnumberSpecify as geo-coordinates in decimals (longitude)
vehicleobject+−requiredOptions to configure vehicle parameters
- typestringrequiredThese vehicles are specific to US region. For more information about vehicle types, click here.Possible values:2AxlesTruck3AxlesTruck4AxlesTruck5AxlesTruck6AxlesTruck7AxlesTruck8AxlesTruck9AxlesTruck
heightobject+−The height of the vehicle
- valuenumber
- unitstringPossible values:meterfeet
lengthobject+−The length of the vehicle (same unit as height)
- valuenumber
- unitstringPossible values:meterfeet
weightobject+−The weight of the vehicle
- valuenumber
- unitstringPossible values:kgpoundtonnes
- axlesnumberNumber of axles on the vehicle
- emissionClassstringThe emission class of the vehicle (only for Europe)Possible values:euro_0euro_1euro_2euro_3euro_4euro_5euro_6euro_eeveuro_15
- co2EmissionClassnumberVehicle CO2 emission category (only for Europe)Possible values:0 - 5
waypointsobject+−Specify a range of intermediary locations, along your route between your origin and destination points
- One of:
- addressstringSpecify address as string. Example: New York, NY
- place_idstringSpecify as Google Place ID string. Example-ChIJlTlXssSPxokROy60gaOlloQ
- latnumberSpecify as geo-coordinates in decimals (latitude)
- lngnumberSpecify as geo-coordinates in decimals (longitude)
- serviceProviderstringThe map service provider to fetch routes from. To include vehicle stops in the response, set the value of the map service provider to "tollguru".
Default: herePossible values:heregmapstollguru - departureTimestringThe provided start time for the trip. If departure_time and locTimes both are not specified then we will use the current time for toll calculations.Possible values:DateTime (string)TimeStamp (number)
fuelOptionsobject+−The fuel options for the specified vehicle
fuelCostobject+−Specifies the cost of fuel. This value is used only when fuel optimization is disabled (i.e., when 'fuelOptionsConfig.optimizeFuel' is false).
- valuenumberThe cost of fuel in a specified unit
- unitsstringMeasurement unit for fuel cost
- currencystringThe currency in which the fuel cost is represented (If currency in units is not provided, the currency in fuel options will be used. If neither is provided, calculations will be based on the region by default.)
- fuelUnitstringMeasurement unit for fuel cost
fuelEfficiencyobject+−If you want an accurate estimate of fuel expenses, you will need to specify parameters specific to fuel price and fuel efficiency as fuelEfficiency object.
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringDefault: kmpl
Measurement units for efficiency values. If the fuel price is in liter, then we expect fuel efficiency to be in kmpl or L/100km, similarly, if it is in gallons, then we expect, efficiency in mpg.Possible values:mpgkmplL/100km
fuelOptionsConfigobject+−The fuel options configuration for the specified vehicle
- tankCapacitynumberMaximum capacity of the fuel tank.
- currentFuelnumberAmount of fuel available at the start of the trip. Must be less than tankCapacity and greater than fuelThreshold.
- fuelThresholdnumberMinimum fuel level to be maintained throughout the trip.
- maxDetourMilesnumberMaximum distance (in miles) a fuel stop can deviate from the main route.
- partialFillPenaltynumberPenalty applied for partially filling at a fuel station.
- detourCostPerMilenumberCost penalty per mile for any detour taken to reach a fuel stop.
- minimumFillAmountnumberMinimum amount of fuel that must be filled at any fuel station. Must be less than tankCapacity.
- fullFillbooleanDetermines how fuel is filled at each stop.
- true: Ignores minimumFillAmount and ensures that at least 65% of the tank is filled at every selected stop.
- false (default): Fills at least the minimumFillAmount at each selected stop. - optimizeFuelbooleanWhen true, enables fuel optimization based on the above parameters.
unitsobject+−Default: USD
When currency in units is provided, it takes precedence for all calculations. When the value of fuelOptions.fuelCost.value is provided, we will extract this value and perform the necessary conversion- currencystringSet currency for calculationsPossible values:USDCADMXNINRAUDGBPNOKSEKDKKPENCOPARSCLFCLPSOL
driverobject+−Specify Driver's Wage or Value of Time. For example, if you are willing to spend Can$1.45 to save 15 minutes for a particular trip, your value of time is Can$1.45* (60/15) = Can$5.8 per hour
- wagenumberDefault: 30
Driver wage per hour - roundingnumberDefault: 30
How is the driver time is rounded (to 30 minutes, an hour, etc.)? - valueOfTimenumberDefault: 0
If driver wages are specified, do not add value of time. If value of time is specified, it is assumed you are the driver and not being paid for the time. Driver wage calculations will not be returned.
- wagenumberDefault: 30
- state_mileagebooleanA flag indicating whether or not to include state mileage calculations in the response
hosobject+−Parameters for Hours of Service calculations for trucks
- dutyHoursBeforeEndOfWorkDaynumberThe remaining total duty hours before the work day ends
- dutyHoursBeforeRestBreaknumberThe remaining total duty hours before the next rest break
- drivingHoursBeforeEndOfWorkDaynumberThe remaining driving hours before the work day ends
- timeRemainingnumberThe remaining driving time after a shift
- rulestringThe FMCSA HOS rule to followPossible values:"60""70"
- getPathPolygonbooleanA flag indicating whether or not to include path polygon in the response
- optimizeWaypointsbooleanA flag indicating whether or not to optimize the order of the waypoints provided in the request. When set to true, the waypoints will be reordered to minimize the total duration of the trip. The "serviceProvider" must be set to "tollguru" to optimize the order of the waypoints
- allowFerrybooleanA flag indicating whether or not to include ferry routes in the trip if available. By default, only land routes are provided.
- applyHazmatRestrictionbooleanApplies hazardous material restrictions, avoiding roads where such materials are prohibited (Only for North America and serviceProvider=here or serviceProvider=tollguru).
- countrystringSpecify the country code in ISO 3166-1 alpha-3 format (For example, USA, CAN, AUS, JPN, CHN, etc.)
Response Schema
- statusstringPossible values: okerror
summaryobject+−Summary including distance, time (duration), name, whether the route has tolls (hasTolls), diffs object that shows the difference between the cost between the cheapest route and current route and difference in duration between the current route and the fastest route.
routearray+−The list of points along the current route
locationobject+−The geographic coordinates for the given location
- latnumberThe latitude of the coordinate
- lngnumberThe longitude of the coordinate
- addressstringThe human-readable address for the given location (Note: The address field in the response will be available only if the address parameter is sent in the request body)
countriesarray+−The list of countries that the current route spans
- stringstring
- currencystringThe currency unit used for calculations
- vehicleTypestringThe vehicle type used for calculations. For more information about vehicle types, click herePossible values:2AxlesAuto3AxlesAuto4AxlesAuto2AxlesDualTire3AxlesDualTire4AxlesDualTire2AxlesEV3AxlesEV4AxlesEV2AxlesTNC2AxlesTNCPool2AxlesTaxi2AxlesTaxiPoolCarpool2Carpool32AxlesTruck3AxlesTruck4AxlesTruck5AxlesTruck6AxlesTruck7AxlesTruck8AxlesTruck9AxlesTruck2AxlesBus3AxlesBus2AxlesMotorcycle3AxlesMotorcycle2AxlesRv3AxlesRv4AxlesRv
- vehicleDescriptionstringThe provided vehicle description
fuelPriceobject+−Fuel price from request or the default fuel price (including currency)
- valuenumberThe cost of fuel in a specified unit
- currencystringThe currency in which the fuel cost is represented
- unitsstringMeasurement unit for fuel cost
- fuelUnitstringMeasurement unit for fuel
fuelEfficiencyobject+−If you want an accurate estimate of fuel expenses, you will need to specify parameters specific to fuel price and fuel efficiency as fuelEfficiency object.
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringMeasurement units for efficiency values
- fuelUnitstringMeasurement unit for fuel value
unitsobject+−A summary of the measurement units used for calculations
- currencyUnitstringThe currency unit specified in the request
- fuelEfficiencyUnitstringThe fuel efficiency units specified in the request
- fuelUnitstringThe fuel units specified in the request
- departureTimestringThe provided start time for the trip. If departure_time and locTimes both are not specified then we will use the current time for toll calculations.Possible values:DateTime (string)TimeStamp (number)
shareobject+−Shareable parameters for this response
- namestring
- prefixstring
- uuidstring
- timestampstring
- clientstring
- sourcestringThe map provider source used to get the list of possible routes
routesarray+−A list of possible routes for the given trip
summaryobject+−Summary including distance, time (duration), name, whether the route has tolls (hasTolls), diffs object that shows the difference between the cost between the cheapest route and current route and difference in duration between the current route and the fastest route.
- hasTollsbooleanValue indicating whether there are any tolls along the current route
- hasExpressTollsbooleanValue indicating whether there are any express tolls along the current route
diffsobject+−The difference in overall cost between the given trip and the cheapest and fastest trips
- cheapestnumber
- fastestnumber
- urlstringURL for navigation for the current route through Google Maps
distanceobject+−The total distance of the current route
- textstringThe display value for the distance
- metricstringThe measurement unit for the distance
- valuenumberThe actual distance value
durationobject+−The estimated travel duration of the current route
- textstringThe display value for the duration
- valuenumberThe actual duration value in seconds
durationInTrafficobject+−The estimated travel duration in traffic for the current route.(Available only when serviceProvider: gmaps)
- textstringThe display value for the duration
- valuenumberThe actual duration value in seconds
- namestringThe name of the current route
- notearray
costsobject+−Costs object summarizes the toll cost and the fuel cost for the route.The fuel costs calculated from fuel efficiency (city fuel efficiency and highway fuel efficiency) and the speeds on each leg of the route.The tolls are added for all the tolls on the route for each payment type. If a payment type cannot be using on all the toll points on the route, the toll cost is returned as false. Else, the sum of tolls for the payment type is returned.
The tolls are returned for the following payment types:- Cash
- Transponder
- License Plate
- Credit card
- Prepaid pass
- tagAndCashnumberThe minimum cost between tag and cash
- minimumTollCostnumberThe minimum total cost
- maximumTollCostnumberThe maximum total cost
- fuelnumberThe calculated cost for fuel
- tagnumberThe calculated toll cost for tags
- cashnumberThe calculated cost for cash
- prepaidCardnumberThe calculated cost for prepaid cards
- licensePlatenumberThe calculated license cost for plate
tollsarray+−Array containing Open system - "barrier" (object) and Closed system - "ticketSystem1" (object), "ticketSystem2" (object), "ticketSystem3" (object), "distBarrier" (object).
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
- typestringType of the Toll System
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- tagPriCostnumberPrimary transponder cost, typically offering standard or discounted rates
- tagSecCostnumberSecondary transponder cost, usually without discounts
- cashCostnumberCash toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardNamesarray of stringsNames of prepaid cards accepted at the toll facility, eg: E-Toll
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
arrivalobject+−
- distancenumberDistance to the toll location in meters.
- timestringEstimated time of arrival (ETA) at the toll location in ISO 8601 format, e.g., '2024-12-17T12:30:00Z'
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem1
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem2
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem3
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
fuelStopsarray+−List of optimized fuel stops along the route, including pricing, fuel levels, and location details.
- latnumberLatitude of the fuel stop location.
- lngnumberLongitude of the fuel stop location.
- namestringName of the fuel station.
- amenitiesstringComma-separated list of available amenities at the station (e.g., food, showers, truck services).
- fuelPricePerGallonnumberBase price of fuel per gallon at the stop, before taxes.
- arrivalDistanceInMilesnumberTotal distance (in miles) traveled from the trip start to reach this stop.
- arrivalFuelInGallonsnumberRemaining fuel in the tank upon arrival at the stop.
- departureFuelInGallonsnumberFuel level in the tank after refueling and leaving the stop.
- amountPaidInDollarsnumberTotal cost (in USD) paid for the fuel filled at this stop, excluding taxes.
- distanceCanBeTraveledNextnumberEstimated distance (in miles) the vehicle can travel with the fuel filled at this stop.
- addressstringFull address of the fuel station.
- iftaTaxPerGallonnumberIFTA (International Fuel Tax Agreement) tax rate per gallon applicable at this stop.
- stateTaxPerGallonnumberState-specific fuel tax rate per gallon.
- amountPaidInDollarsWithTaxnumberTotal amount paid for the fuel including all applicable taxes.
allFuelStopsarray+−List of nearby fuel stops along or near the route, determined based on the input fuel configuration parameters (e.g., detour limits, required amenities, fuel thresholds).
- latnumberLatitude of the fuel stop location.
- lngnumberLongitude of the fuel stop location.
- namestringName of the fuel station.
- amenitiesstringComma-separated list of available amenities at the station (e.g., food, showers, truck services).
- fuelPricePerGallonnumberBase price of fuel per gallon at the stop, before taxes.
- addressstringFull address of the fuel station.
- iftaTaxPerGallonnumberIFTA (International Fuel Tax Agreement) tax rate per gallon applicable at this stop.
- stateTaxPerGallonnumberState-specific fuel tax rate per gallon.
fuelStopSummaryobject+−Summary of total costs and metrics derived from the selected fuel stops, including fuel expenses, detour penalties, and driver-related costs.
- totalDetourCostnumberTotal cost from detouring to fuel stops.
- partialFillPenaltynumberPenalty for not fully refueling at stops.
- fuelCostPerMilenumberAverage fuel cost per mile.
- paidFuelCostnumberTotal fuel cost paid (pre-tax).
- usedFuelCostnumberCost of fuel actually consumed.
- totalCostnumberTotal trip cost without tax.
- totalCostWithTaxnumberTotal trip cost including taxes.
- iftaTaxnumberTotal IFTA tax applied.
- stateTaxnumberTotal state fuel tax applied.
driverCostsobject+−Driver wage details.
- wagenumberDriver's hourly wage.
- totalnumberTotal driver cost for the trip.
directionsarray+−
positionobject+−
- latitudenumber
- longitudenumber
- maneuverstring
- html_instructionsstring
- distancenumber
- durationnumber
- notearray
hosarray+−
summaryobject+−
total_drive_durationobject+−
- textstring
- valuenumber
total_break_durationobject+−
- textstring
- valuenumber
total_durationobject+−
- textstring
- valuenumber
total_distanceobject+−
- textstring
- metricstring
- valuenumber
- breakpointsarray
stopsarray+−
- additionalServicesstring
- amenitiesstring
- businessesNamestring
- citystring
- contactNamestring
- faxstring
- fuelLanesnumber
- highwaystring
- latitudenumber
- longitudenumber
- parkingSpotsstring
- paymentMethodsstring
- phone1string
- phone2string
- phone3string
- postalCodestring
- restIndexstring
- showersnumber
- statestring
- stopIdnumber
- streetAddressstring
- truckServiceBaysnumber
- typestring
- webAddressstring
dataobject+−
- instructionstring
durationobject+−
- textstring
- valuenumber
distanceobject+−
- textstring
- metricstring
- valuenumber
territoryMileagearray+−
territoryobject+−
- namestring
- codestring
- typestring
distanceobject+−
- textstring
- metricnumber
- valuenumber
- trafficTimestring
- polylinestringA base64 encoded linestring representing the current route
vehicleStopsarray+−Details of vehicle stops located along the route.
stopsarray+−List of vehicle stops located along the route.
- stopIdnumberUnique identifier for the vehicle stop.
- latnumberLatitude of the vehicle stop location.
- lngnumberLongitude of the vehicle stop location.
distanceobject+−Distance from the start of the route.
- textstring
- metricstring
- valuenumber
geometryobject+−Geometry details of the vehicle stop location.
coordinatesarray+−Coordinates of the vehicle stop location in [longitude, latitude] format, e.g., [-87.010376, 41.448527].
- numbernumber
- typestringGeometry type.Possible values:Point
- stopTypestringType of the vehicle stop (e.g., 'fuel').
- stopNamestringName of the vehicle stop.
- addressstringAddress of the vehicle stop.
- citystringCity where the vehicle stop is located.
- stateProvincestringState or Province where the vehicle stop is located.
- countrystringCountry where the vehicle stop is located.
- postalCodestringPostal code of the vehicle stop location.
- stopCompanyNamestringName of the company operating the vehicle stop.
- interstatestringInterstate highway where the vehicle stop is located.
- phonestringPhone number of the vehicle stop.
- faxstringFax number of the vehicle stop.
- totalParkingSpacesnumberTotal number of parking spaces available at the vehicle stop.
- primeParkingSpacesnumberNumber of prime parking spaces available at the vehicle stop.
- dieselLanesnumberNumber of diesel lanes available at the vehicle stop.
- defLanesnumberNumber of DEF (Diesel Exhaust Fluid) lanes available at the vehicle stop.
- showerCountnumberNumber of showers available at the vehicle stop.
- hasCatScalebooleanIndicates if the vehicle stop has a CAT Scale.
- amenitiesstringAmenities available at the vehicle stop.
- restaurantsstringTypes of restaurants available at the vehicle stop.
metaDataobject+−Meta data related to fuel prices and currency.
- fuelRegularPricenumberPrice of regular fuel.
- fuelMidgradePricenumberPrice of midgrade fuel.
- fuelPremiumPricenumberPrice of premium fuel.
- fuelDieselPricenumberPrice of diesel fuel.
- currencystringCurrency used for the fuel prices.
startobject+−Details about the starting point of the segment of the route.
- indexnumberIndex of the starting point of the segment of the route.
- latnumberLatitude of the starting point of the segment of the route.
- lngnumberLongitude of the starting point of the segment of the route.
distanceobject+−Distance from the start of the route.
- textstring
- metricstring
- valuenumber
endobject+−Details about the end point of the segment of the route.
- indexnumberIndex of the end point of the segment of the route.
- latnumberLatitude of the end point of the segment of the route.
- lngnumberLongitude of the end point of the segment of the route.
distanceobject+−Distance from the start of the route.
- textstring
- metricstring
- valuenumber
metaobject+−The metadata associated with the request
- typestringType of user
- clientstringClient accessing the API (e.g., "web", "mobile")
- sourcestringMapping service, e.g., HERE Maps, Google Maps, etc.
- userIdstringUnique identifier for the user (e.g., email)
- customerIdstringUnique identifier for the customer
- txnumberNumber of transactions done
Request
Response
TollTally - Tolls for Complete Route Polyline from a Mapping Service
- Specify whether you want to send route polyline (encoded using Google encoded polyline algorithm or shape (latitude and longitude pairs)
- Specify vehicle type. For example, you can receive tolls for vehicles based on axle counts for cars, SUV, pick-up, trucks (up to 9-axles), motorcycle, bus, motorhome, RV, limousine.
- Specify truck parameters such as weight, height, axle counts and receive tolls based on weight, height, etc.
- Specify the source of route polyline such as Google, Bing, MapBox, Apple Map, HERE, TomTom, Waze, ESRI, MapQuest, JawgMaps, Trimble, PTV, MapmyIndia, Yandex, Michelin, Baidu, Gaode or your custom source (“custom”)
- Since you specify the exact route, you will receive tolls for the route. You will not receive tolls for alternate routes between origin and destination.
Questions for constructing request body
Route Encoded Polyline
You will receive toll information for all tolls on the single route you requested. You will need to get the complete route from your mapping service (and not just origin, destination and some stops on the route) to receive accurate toll information.
Request Schema
- mapProviderstringDefault: here
Specify route source, either here for HERE maps routes based polyline or gmaps for Google Maps polylinesPossible values:googlebingmapboxapple mapheretomtomwazeesrimapquestjawgmapstrimbleptvmapmyindiayandexmichelinbaidugaode - polylinestringThe base64 encoded linestring. Specified route as Google Maps encoded polyline (see details).
locTimesarray+−Specify the locTimes utilizing a two-dimensional array of floating-point numbers, where each sub-array consists of the path or polyline index and the corresponding time-stamp for that coordinate. If locTimes is not specified we use departure_time as a the timestamp and if departure_time is also not specified we will use current time for toll calculations
arrayarray+−
- numbernumber
vehicleobject+−Options to configure vehicle parameters
- typestringThese vehicles are specific to US region. For more information about vehicle types, click here.Possible values:2AxlesAuto3AxlesAuto4AxlesAuto2AxlesDualTire3AxlesDualTire4AxlesDualTire2AxlesEV3AxlesEV4AxlesEV2AxlesTNC2AxlesTNCPool2AxlesTaxi2AxlesTaxiPoolCarpool2Carpool32AxlesTruck3AxlesTruck4AxlesTruck5AxlesTruck6AxlesTruck7AxlesTruck8AxlesTruck9AxlesTruck2AxlesBus3AxlesBus2AxlesMotorcycle3AxlesMotorcycle2AxlesRv3AxlesRv4AxlesRv
heightobject+−The height of the vehicle
- valuenumber
- unitstringPossible values:meterfeet
lengthobject+−The length of the vehicle (same unit as height)
- valuenumber
- unitstringPossible values:meterfeet
weightobject+−The weight of the vehicle
- valuenumber
- unitstringPossible values:kgpoundtonnes
- axlesnumberNumber of axles on the vehicle
- emissionClassstringThe emission class of the vehicle (only for Europe)Possible values:euro_0euro_1euro_2euro_3euro_4euro_5euro_6euro_eeveuro_15
- co2EmissionClassnumberVehicle CO2 emission category (only for Europe)Possible values:0 - 5
fuelOptionsobject+−The fuel options for the specified vehicle
fuelCostobject+−Options to specify the cost of fuel
- valuenumberThe cost of fuel in a specified unit
- unitsstringMeasurement unit for fuel cost
- currencystringThe currency in which the fuel cost is represented (If currency in units is not provided, the currency in fuel options will be used. If neither is provided, calculations will be based on the region by default.)
- fuelUnitstringMeasurement unit for fuel cost
fuelEfficiencyobject+−If you want an accurate estimate of fuel expenses, you will need to specify parameters specific to fuel price and fuel efficiency as fuelEfficiency object.
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringDefault: kmpl
Measurement units for efficiency values (If the fuel price is in liter, then we expect fuel efficiency to be in kmpl or L/100km, similarly, if it is in gallons, then we expect, efficiency in mpg.)Possible values:mpgkmplL/100km
unitsobject+−Default: USD
When currency in units is provided, it takes precedence for all calculations. When the value of fuelOptions.fuelCost.value is provided, we will extract this value and perform the necessary conversion- currencystringSet currency for calculationsPossible values:USDCADMXNINRAUDGBPNOKSEKDKKPENCOPARSCLFCLPSOL
- departureTimestringThe provided start time for the trip. If departure_time and locTimes both are not specified then we will use the current time for toll calculations.Possible values:DateTime (string)TimeStamp (number)
- includeParkingFeebooleanA flag indicating whether or not to include parking fee calculations in the response. Available only for SDK requests.
Response Schema
- statusstringPossible values: okerror
summaryobject+−A summary of the toll API response for the given trip
countriesarray+−The list of countries that the current route spans
- stringstring
- currencystringThe currency unit used for calculations
- vehicleTypestringThe vehicle type used for calculations. For more information about vehicle types, click here
- vehicleDescriptionstringThe provided vehicle description
fuelPriceobject+−The fuel cost details used for calculations
- valuenumberThe cost of fuel in a specified unit
- currencystringThe currency in which the fuel cost is represented
- unitsstringMeasurement unit for fuel cost
- fuelUnitstringMeasurement unit for fuel
fuelEfficiencyobject+−If you want an accurate estimate of fuel expenses, you will need to specify parameters specific to fuel price and fuel efficiency as fuelEfficiency object.
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringMeasurement units for efficiency values
- fuelUnitstringMeasurement unit for fuel value
unitsobject+−A summary of the measurement units used for calculations
- currencyUnitstringThe currency unit specified in the request
- fuelEfficiencyUnitstringThe fuel efficiency units specified in the request
- fuelUnitstringThe fuel units specified in the request
- departureTimestringThe provided start time for the trip. If departure_time and locTimes both are not specified then we will use the current time for toll calculations.Possible values:DateTime (string)TimeStamp (number)
shareobject+−Shareable parameters for this response
- namestring
- prefixstring
- uuidstring
- timestampstring
- clientstring
routeobject+−Route information for the given trip
- hasTollsbooleanValue indicating whether there are any tolls along the current route
distanceobject+−The total distance of the current route
- textstringThe display value for the distance
- metricstringThe measurement unit for the distance
- valuenumberThe actual distance value
costsobject+−Costs object summarizes the toll cost and the fuel cost for the route.The fuel costs calculated from fuel efficiency (city fuel efficiency and highway fuel efficiency) and the speeds on each leg of the route.The tolls are added for all the tolls on the route for each payment type. If a payment type cannot be using on all the toll points on the route, the toll cost is returned as false. Else, the sum of tolls for the payment type is returned.
The tolls are returned for the following payment types:- Cash
- Transponder
- License Plate
- Credit card
- Prepaid pass
- tagAndCashnumberThe minimum cost between tag and cash
- minimumTollCostnumberThe minimum total cost
- maximumTollCostnumberThe maximum total cost
- fuelnumberThe calculated cost for fuel
- tagnumberThe calculated toll cost for tags
- cashnumberThe calculated cost for cash
- prepaidCardnumberThe calculated cost for prepaid cards
- licensePlatenumberThe calculated license cost for plate
tollsarray+−Array containing Open system - "barrier" (object) and Closed system - "ticketSystem1" (object), "ticketSystem2" (object), "ticketSystem3" (object), "distBarrier" (object).
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
- typestringType of the Toll System
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- tagPriCostnumberPrimary transponder cost, typically offering standard or discounted rates
- tagSecCostnumberSecondary transponder cost, usually without discounts
- cashCostnumberCash toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardNamesarray of stringsNames of prepaid cards accepted at the toll facility, eg: E-Toll
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
arrivalobject+−
- distancenumberDistance to the toll location in meters.
- timestringEstimated time of arrival (ETA) at the toll location in ISO 8601 format, e.g., '2024-12-17T12:30:00Z'
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem1
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem2
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem3
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- polylinestringThe base64 encoded linestring. Specified route as Google Maps encoded polyline (see details).
parkingsarray+−Parking facility details including entry and exit points, fees, and duration.
- parkingIdnumberUnique identifier for the parking facility.
- namestringName of the parking facility.
- addressstringStreet address of the parking facility.
- citystringCity where the parking facility is situated.
- statestringState where the parking facility is situated.
- countrystringCountry where the parking facility is situated.
- currencystringCurrency in which the parking fee is represented.
feeobject+−Fee details for the parking facility.
- cashnumberThe calculated parking cost for cash.
- tagnumberThe calculated parking cost for tags.
durationInsideParkingobject+−Details about the duration of the stay inside the parking facility.
- durationnumberDuration of stay within the parking facility.
- unitstringUnit of time for the parking duration.Possible values:seconds
entryobject+−Details about the entry point of the parking facility.
arrivalobject+−Arrival details at the entry point.
- distancenumberDistance from the origin to the entry point of the parking facility, measured in meters.
- timestringIndicates the time and date of arrival at the entry point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_formattedstringIndicates the time and date of arrival at the entry point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_localizedstringIndicates the time and date of arrival at the entry point in localized format, e.g., 2024-06-24T08:07:50+01:00.
pointobject+−Location details of the entry point of the parking facility.
- typestringType of the point (e.g., 'Feature').
geometryobject+−Geometry details of the entry point.
- typestringGeometry type (e.g., 'Point').
coordinatesarray+−Coordinates of the point in [longitude, latitude] format, e.g., [-9.1825, 38.7065].
- numbernumber
exitobject+−Details about the exit point of the parking facility.
arrivalobject+−Arrival details at the exit point.
- distancenumberDistance from the origin to the exit point of the parking facility, measured in meters.
- timestringIndicates the time and date of arrival at the exit point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_formattedstringIndicates the time and date of arrival at the exit point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_localizedstringIndicates the time and date of arrival at the exit point in localized format, e.g., 2024-06-24T08:07:50+01:00.
pointobject+−Location details of the exit point of the parking facility.
- typestringType of the point (e.g., 'Feature').
geometryobject+−Geometry details of the exit point.
- typestringGeometry type (e.g., 'Point').
coordinatesarray+−Coordinates of the point in [longitude, latitude] format, e.g., [-9.1825, 38.7065].
- numbernumber
vignettesarray+−
- typestring
- countrystring
- countryCodestring
ratesarray+−
- durationstring
- vignetteCostnumber
- currencyUnitstring
vignetteCoordinatesobject+−
- typestring
coordinatesarray+−
- numbernumber
metaobject+−The metadata associated with the request
- userIdstringUnique identifier for the user (e.g., email)
- customerIdstringUnique identifier for the customer
- txnumberNumber of transactions done
- typestringType of user
- clientstringClient accessing the API
- sourcestringMapping service, e.g., HERE Maps, Google Maps, etc.
Request
Response
Route Encoded Polyline with Timestamps
Receive time-based tolls for your trip by providing the timestamps corresponding to your trip's polyline.
Request Schema
- mapProviderstringThe map service provider for map matching given GPS tracks
- polylinestringThe base64 encoded linestring. Specified route as Google Maps encoded polyline (see details).
locTimesarray+−Specify the locTimes utilizing a two-dimensional array of floating-point numbers, where each sub-array consists of the path or polyline index and the corresponding time-stamp for that coordinate. If locTimes is not specified we use departure_time as a the timestamp and if departure_time is also not specified we will use current time for toll calculations
arrayarray+−
- numbernumber
vehicleobject+−Options to configure vehicle parameters
- typestringThese vehicles are specific to US region. For more information about vehicle types, click here.Possible values:2AxlesAuto3AxlesAuto4AxlesAuto2AxlesDualTire3AxlesDualTire4AxlesDualTire2AxlesEV3AxlesEV4AxlesEV2AxlesTNC2AxlesTNCPool2AxlesTaxi2AxlesTaxiPoolCarpool2Carpool32AxlesTruck3AxlesTruck4AxlesTruck5AxlesTruck6AxlesTruck7AxlesTruck8AxlesTruck9AxlesTruck2AxlesBus3AxlesBus2AxlesMotorcycle3AxlesMotorcycle2AxlesRv3AxlesRv4AxlesRv
heightobject+−The height of the vehicle
- valuenumber
- unitstringPossible values:meterfeet
lengthobject+−The length of the vehicle (same unit as height)
- valuenumber
- unitstringPossible values:meterfeet
weightobject+−The weight of the vehicle
- valuenumber
- unitstringPossible values:kgpoundtonnes
- axlesnumberNumber of axles on the vehicle
- emissionClassstringThe emission class of the vehicle (only for Europe)Possible values:euro_0euro_1euro_2euro_3euro_4euro_5euro_6euro_eeveuro_15
- co2EmissionClassnumberVehicle CO2 emission category (only for Europe)Possible values:0 - 5
- includeParkingFeebooleanA flag indicating whether or not to include parking fee calculations in the response. Available only for SDK requests.
Response Schema
- statusstringPossible values: okerror
summaryobject+−A summary of the toll API response for the given trip
- currencystringThe currency unit used for calculations
- vehicleDescriptionstringThe provided vehicle description
fuelPriceobject+−The fuel cost details used for calculations
- valuenumberThe cost of fuel in a specified unit
- currencystringThe currency in which the fuel cost is represented
- unitsstringMeasurement unit for fuel cost
- fuelUnitstringMeasurement unit for fuel
fuelEfficiencyobject+−If you want an accurate estimate of fuel expenses, you will need to specify parameters specific to fuel price and fuel efficiency as fuelEfficiency object.
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringMeasurement units for efficiency values
- fuelUnitstringMeasurement unit for fuel value
unitsobject+−A summary of the measurement units used for calculations
- currencyUnitstringThe currency unit specified in the request
- fuelEfficiencyUnitstringThe fuel efficiency units specified in the request
- fuelUnitstringThe fuel units specified in the request
- departureTimestringThe provided start time for the trip. If departure_time and locTimes both are not specified then we will use the current time for toll calculations.Possible values:DateTime (string)TimeStamp (number)
countriesarray+−The list of countries that the current route spans
- stringstring
- vehicleTypestringThe vehicle type used for calculations. For more information about vehicle types, click here
shareobject+−Shareable parameters for this response
- prefixstring
- uuidstring
- timestampstring
- clientstring
- namestring
routeobject+−Route information for the given trip
- hasTollsbooleanValue indicating whether there are any tolls along the current route
distanceobject+−The total distance of the current route
- textstringThe display value for the distance
- metricstringThe measurement unit for the distance
- valuenumberThe actual distance value
costsobject+−Costs object summarizes the toll cost and the fuel cost for the route.The fuel costs calculated from fuel efficiency (city fuel efficiency and highway fuel efficiency) and the speeds on each leg of the route.The tolls are added for all the tolls on the route for each payment type. If a payment type cannot be using on all the toll points on the route, the toll cost is returned as false. Else, the sum of tolls for the payment type is returned.
The tolls are returned for the following payment types:- Cash
- Transponder
- License Plate
- Credit card
- Prepaid pass
- tagAndCashnumberThe minimum cost between tag and cash
- minimumTollCostnumberThe minimum total cost
- maximumTollCostnumberThe maximum total cost
- fuelnumberThe calculated cost for fuel
- tagnumberThe calculated toll cost for tags
- cashnumberThe calculated cost for cash
- prepaidCardnumberThe calculated cost for prepaid cards
- licensePlatenumberThe calculated license cost for plate
tollsarray+−Array containing Open system - "barrier" (object) and Closed system - "ticketSystem1" (object), "ticketSystem2" (object), "ticketSystem3" (object), "distBarrier" (object).
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
- typestringType of the Toll System
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- tagPriCostnumberPrimary transponder cost, typically offering standard or discounted rates
- tagSecCostnumberSecondary transponder cost, usually without discounts
- cashCostnumberCash toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardNamesarray of stringsNames of prepaid cards accepted at the toll facility, eg: E-Toll
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
arrivalobject+−
- distancenumberDistance to the toll location in meters.
- timestringEstimated time of arrival (ETA) at the toll location in ISO 8601 format, e.g., '2024-12-17T12:30:00Z'
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem1
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem2
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem3
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- polylinestringThe base64 encoded linestring. Specified route as Google Maps encoded polyline (see details).
parkingsarray+−Parking facility details including entry and exit points, fees, and duration.
- parkingIdnumberUnique identifier for the parking facility.
- namestringName of the parking facility.
- addressstringStreet address of the parking facility.
- citystringCity where the parking facility is situated.
- statestringState where the parking facility is situated.
- countrystringCountry where the parking facility is situated.
- currencystringCurrency in which the parking fee is represented.
feeobject+−Fee details for the parking facility.
- cashnumberThe calculated parking cost for cash.
- tagnumberThe calculated parking cost for tags.
durationInsideParkingobject+−Details about the duration of the stay inside the parking facility.
- durationnumberDuration of stay within the parking facility.
- unitstringUnit of time for the parking duration.Possible values:seconds
entryobject+−Details about the entry point of the parking facility.
arrivalobject+−Arrival details at the entry point.
- distancenumberDistance from the origin to the entry point of the parking facility, measured in meters.
- timestringIndicates the time and date of arrival at the entry point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_formattedstringIndicates the time and date of arrival at the entry point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_localizedstringIndicates the time and date of arrival at the entry point in localized format, e.g., 2024-06-24T08:07:50+01:00.
pointobject+−Location details of the entry point of the parking facility.
- typestringType of the point (e.g., 'Feature').
geometryobject+−Geometry details of the entry point.
- typestringGeometry type (e.g., 'Point').
coordinatesarray+−Coordinates of the point in [longitude, latitude] format, e.g., [-9.1825, 38.7065].
- numbernumber
exitobject+−Details about the exit point of the parking facility.
arrivalobject+−Arrival details at the exit point.
- distancenumberDistance from the origin to the exit point of the parking facility, measured in meters.
- timestringIndicates the time and date of arrival at the exit point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_formattedstringIndicates the time and date of arrival at the exit point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_localizedstringIndicates the time and date of arrival at the exit point in localized format, e.g., 2024-06-24T08:07:50+01:00.
pointobject+−Location details of the exit point of the parking facility.
- typestringType of the point (e.g., 'Feature').
geometryobject+−Geometry details of the exit point.
- typestringGeometry type (e.g., 'Point').
coordinatesarray+−Coordinates of the point in [longitude, latitude] format, e.g., [-9.1825, 38.7065].
- numbernumber
vignettesarray+−
- typestring
- countrystring
- countryCodestring
ratesarray+−
- durationstring
- vignetteCostnumber
- currencyUnitstring
vignetteCoordinatesobject+−
- typestring
coordinatesarray+−
- numbernumber
warningsarray+−
- typestring
- messagestring
metaobject+−The metadata associated with the request
- typestringType of user
- clientstringClient accessing the API (e.g., "web", "mobile")
- sourcestringMapping service, e.g., HERE Maps, Google Maps, etc.
- userIdstringUnique identifier for the user (e.g., email)
- customerIdstringUnique identifier for the customer
- txnumberNumber of transactions done
Request
Response
Route Polyline - Latitude, Longitude
You will receive toll information for all tolls on the single route you requested. You will need to get the complete route from your mapping service (and not just origin, destination and some stops on the route) to receive accurate toll information.
Request Schema
- mapProviderstringDefault: here
Specify route source, either here for HERE maps routes based polyline or gmaps for Google Maps polylinesPossible values:googlebingmapboxapple mapheretomtomwazeesrimapquestjawgmapstrimbleptvmapmyindiayandexmichelinbaidugaode - pathstringSpecify route as a set of comma-separated lat,lng coordinates delimited by a pipe character (|)
locTimesarray+−Specify the locTimes utilizing a two-dimensional array of floating-point numbers, where each sub-array consists of the path or polyline index and the corresponding time-stamp for that coordinate. If locTimes is not specified we use departure_time as a the timestamp and if departure_time is also not specified we will use current time for toll calculations
arrayarray+−
- numbernumber
vehicleobject+−Options to configure vehicle parameters
- typestringThese vehicles are specific to US region. For more information about vehicle types, click here.Possible values:2AxlesAuto3AxlesAuto4AxlesAuto2AxlesDualTire3AxlesDualTire4AxlesDualTire2AxlesEV3AxlesEV4AxlesEV2AxlesTNC2AxlesTNCPool2AxlesTaxi2AxlesTaxiPoolCarpool2Carpool32AxlesTruck3AxlesTruck4AxlesTruck5AxlesTruck6AxlesTruck7AxlesTruck8AxlesTruck9AxlesTruck2AxlesBus3AxlesBus2AxlesMotorcycle3AxlesMotorcycle2AxlesRv3AxlesRv4AxlesRv
heightobject+−The height of the vehicle
- valuenumber
- unitstringPossible values:meterfeet
lengthobject+−The length of the vehicle (same unit as height)
- valuenumber
- unitstringPossible values:meterfeet
weightobject+−The weight of the vehicle
- valuenumber
- unitstringPossible values:kgpoundtonnes
- axlesnumberNumber of axles on the vehicle
- emissionClassstringThe emission class of the vehicle (only for Europe)Possible values:euro_0euro_1euro_2euro_3euro_4euro_5euro_6euro_eeveuro_15
- co2EmissionClassnumberVehicle CO2 emission category (only for Europe)Possible values:0 - 5
fuelOptionsobject+−The fuel options for the specified vehicle
fuelCostobject+−Options to specify the cost of fuel
- valuenumberThe cost of fuel in a specified unit
- unitsstringMeasurement unit for fuel cost
- currencystringThe currency in which the fuel cost is represented (If currency in units is not provided, the currency in fuel options will be used. If neither is provided, calculations will be based on the region by default.)
- fuelUnitstringMeasurement unit for fuel cost
fuelEfficiencyobject+−If you want an accurate estimate of fuel expenses, you will need to specify parameters specific to fuel price and fuel efficiency as fuelEfficiency object.
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringDefault: kmpl
Measurement units for efficiency values (If the fuel price is in liter, then we expect fuel efficiency to be in kmpl or L/100km, similarly, if it is in gallons, then we expect, efficiency in mpg.)Possible values:mpgkmplL/100km
unitsobject+−Default: USD
When currency in units is provided, it takes precedence for all calculations. When the value of fuelOptions.fuelCost.value is provided, we will extract this value and perform the necessary conversion- currencystringSet currency for calculationsPossible values:USDCADMXNINRAUDGBPNOKSEKDKKPENCOPARSCLFCLPSOL
- departureTimestringThe provided start time for the trip. If departure_time and locTimes both are not specified then we will use the current time for toll calculations.Possible values:DateTime (string)TimeStamp (number)
- includeParkingFeebooleanA flag indicating whether or not to include parking fee calculations in the response. Available only for SDK requests.
Response Schema
- statusstringPossible values: okerror
summaryobject+−A summary of the toll API response for the given trip
- currencystringThe currency unit used for calculations
- vehicleDescriptionstringThe provided vehicle description
fuelPriceobject+−The fuel cost details used for calculations
- valuenumberThe cost of fuel in a specified unit
- currencystringThe currency in which the fuel cost is represented
- unitsstringMeasurement unit for fuel cost
- fuelUnitstringMeasurement unit for fuel
fuelEfficiencyobject+−If you want an accurate estimate of fuel expenses, you will need to specify parameters specific to fuel price and fuel efficiency as fuelEfficiency object.
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringMeasurement units for efficiency values
- fuelUnitstringMeasurement unit for fuel value
unitsobject+−A summary of the measurement units used for calculations
- currencyUnitstringThe currency unit specified in the request
- fuelEfficiencyUnitstringThe fuel efficiency units specified in the request
- fuelUnitstringThe fuel units specified in the request
- departureTimestringThe provided start time for the trip. If departure_time and locTimes both are not specified then we will use the current time for toll calculations.Possible values:DateTime (string)TimeStamp (number)
countriesarray+−The list of countries that the current route spans
- stringstring
- vehicleTypestringThe vehicle type used for calculations. For more information about vehicle types, click here
shareobject+−Shareable parameters for this response
- prefixstring
- uuidstring
- timestampstring
- clientstring
- namestring
routeobject+−Route information for the given trip
- hasTollsbooleanValue indicating whether there are any tolls along the current route
distanceobject+−The total distance of the current route
- textstringThe display value for the distance
- metricstringThe measurement unit for the distance
- valuenumberThe actual distance value
costsobject+−Costs object summarizes the toll cost and the fuel cost for the route.The fuel costs calculated from fuel efficiency (city fuel efficiency and highway fuel efficiency) and the speeds on each leg of the route.The tolls are added for all the tolls on the route for each payment type. If a payment type cannot be using on all the toll points on the route, the toll cost is returned as false. Else, the sum of tolls for the payment type is returned.
The tolls are returned for the following payment types:- Cash
- Transponder
- License Plate
- Credit card
- Prepaid pass
- tagAndCashnumberThe minimum cost between tag and cash
- minimumTollCostnumberThe minimum total cost
- maximumTollCostnumberThe maximum total cost
- fuelnumberThe calculated cost for fuel
- tagnumberThe calculated toll cost for tags
- cashnumberThe calculated cost for cash
- prepaidCardnumberThe calculated cost for prepaid cards
- licensePlatenumberThe calculated license cost for plate
tollsarray+−Array containing Open system - "barrier" (object) and Closed system - "ticketSystem1" (object), "ticketSystem2" (object), "ticketSystem3" (object), "distBarrier" (object).
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
- typestringType of the Toll System
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- tagPriCostnumberPrimary transponder cost, typically offering standard or discounted rates
- tagSecCostnumberSecondary transponder cost, usually without discounts
- cashCostnumberCash toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardNamesarray of stringsNames of prepaid cards accepted at the toll facility, eg: E-Toll
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
arrivalobject+−
- distancenumberDistance to the toll location in meters.
- timestringEstimated time of arrival (ETA) at the toll location in ISO 8601 format, e.g., '2024-12-17T12:30:00Z'
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem1
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem2
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem3
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- polylinestringThe base64 encoded linestring. Specified route as Google Maps encoded polyline (see details).
parkingsarray+−Parking facility details including entry and exit points, fees, and duration.
- parkingIdnumberUnique identifier for the parking facility.
- namestringName of the parking facility.
- addressstringStreet address of the parking facility.
- citystringCity where the parking facility is situated.
- statestringState where the parking facility is situated.
- countrystringCountry where the parking facility is situated.
- currencystringCurrency in which the parking fee is represented.
feeobject+−Fee details for the parking facility.
- cashnumberThe calculated parking cost for cash.
- tagnumberThe calculated parking cost for tags.
durationInsideParkingobject+−Details about the duration of the stay inside the parking facility.
- durationnumberDuration of stay within the parking facility.
- unitstringUnit of time for the parking duration.Possible values:seconds
entryobject+−Details about the entry point of the parking facility.
arrivalobject+−Arrival details at the entry point.
- distancenumberDistance from the origin to the entry point of the parking facility, measured in meters.
- timestringIndicates the time and date of arrival at the entry point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_formattedstringIndicates the time and date of arrival at the entry point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_localizedstringIndicates the time and date of arrival at the entry point in localized format, e.g., 2024-06-24T08:07:50+01:00.
pointobject+−Location details of the entry point of the parking facility.
- typestringType of the point (e.g., 'Feature').
geometryobject+−Geometry details of the entry point.
- typestringGeometry type (e.g., 'Point').
coordinatesarray+−Coordinates of the point in [longitude, latitude] format, e.g., [-9.1825, 38.7065].
- numbernumber
exitobject+−Details about the exit point of the parking facility.
arrivalobject+−Arrival details at the exit point.
- distancenumberDistance from the origin to the exit point of the parking facility, measured in meters.
- timestringIndicates the time and date of arrival at the exit point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_formattedstringIndicates the time and date of arrival at the exit point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_localizedstringIndicates the time and date of arrival at the exit point in localized format, e.g., 2024-06-24T08:07:50+01:00.
pointobject+−Location details of the exit point of the parking facility.
- typestringType of the point (e.g., 'Feature').
geometryobject+−Geometry details of the exit point.
- typestringGeometry type (e.g., 'Point').
coordinatesarray+−Coordinates of the point in [longitude, latitude] format, e.g., [-9.1825, 38.7065].
- numbernumber
vignettesarray+−
- typestring
- countrystring
- countryCodestring
ratesarray+−
- durationstring
- vignetteCostnumber
- currencyUnitstring
vignetteCoordinatesobject+−
- typestring
coordinatesarray+−
- numbernumber
warningsarray+−
- typestring
- messagestring
metaobject+−The metadata associated with the request
- typestringType of user
- clientstringClient accessing the API (e.g., "web", "mobile")
- sourcestringMapping service, e.g., HERE Maps, Google Maps, etc.
- userIdstringUnique identifier for the user (e.g., email)
- customerIdstringUnique identifier for the customer
- txnumberNumber of transactions done
Request
Response
TollTally - GPS Tracks to Toll API
- Specify vehicle type. For example, you can receive tolls for vehicles based on axle counts for cars, SUV, pick-up, trucks (up to 9-axles), motorcycle, bus, motorhome, RV, limousine.
- Specify truck parameters such as weight, height, axle counts to receive tolls based on weight, height, etc.
- Specify the timestamp of each GPS trace. If you do not specify the timestamp, tolls are likely to be inaccurate on time-based-toll facilities.
- Specify whether you want to receive toll information immediately (isAsync=false) or can wait (isAsync=true). Use the asynchronous mode when uploading multiple or large GPS track files. Response in asynchronous mode comes with a requestId and a requestedTimestamp. These results would be available for download for up to 30 days.
Questions for constructing request body
Upload GPS Tracks
By default, the API returns tolls immediately. In other words in synchronous mode. When you have a large GPS track, you need to specify to receive tolls in the asynchronous mode by specifying the url parameter as isAsync=true. Response in this case will include a requestId and a requestedTimestamp. You can use the requestId to download tolls for up to 30 days. Use the asynchronous mode when uploading multiple or large GPS tracks files.
- Upload CSV file - You can use the CSV format file as shown in the table below. Alternatively you can download the sample file from here.
The first line in the CSV needs to contain the attribute names. The subsequent lines need to contain the data in temporal order. The following parameters are available:
| Parameter | Description |
|---|---|
| latitude | Latitude coordinate in WGS84 degree (mandatory) |
| longitude | Longitude coordinate in WGS84 degree (mandatory) |
| timestamp | indicates the time and date, for example 2018-05-21T17:05:06Z (mandatory since tolls may change based on time) |
You can use the CSV format file as shown in the table below:
| latitude | longitude | timestamp |
|---|---|---|
| 38.90479 | -77.02607 | 2019-12-16T15:45:23Z |
| 38.90479 | -77.02606 | 2019-12-16T15:47:24Z |
| 38.9048 | -77.02608 | 2019-12-16T15:49:25Z |
| 38.9044 | -77.02604 | 2019-12-16T15:50:42Z |
| 38.90424 | -77.02646 | 2019-12-16T15:50:49Z |
| 38.90422 | -77.02686 | 2019-12-16T15:50:55Z |
Query Parameters
vehicleobject+−Please take note that the object must be in URI encoded format prior to sending a request. It is possible to encode it here
- typestringThese vehicles are specific to US region. For more information about vehicle types, click here.Possible values:2AxlesAuto3AxlesAuto4AxlesAuto2AxlesDualTire3AxlesDualTire4AxlesDualTire2AxlesEV3AxlesEV4AxlesEV2AxlesTNC2AxlesTNCPool2AxlesTaxi2AxlesTaxiPoolCarpool2Carpool32AxlesTruck3AxlesTruck4AxlesTruck5AxlesTruck6AxlesTruck7AxlesTruck8AxlesTruck9AxlesTruck2AxlesBus3AxlesBus2AxlesMotorcycle3AxlesMotorcycle2AxlesRv3AxlesRv4AxlesRv
heightobject+−The height of the vehicle
- valuenumber
- unitstringPossible values:meterfeet
lengthobject+−The length of the vehicle (same unit as height)
- valuenumber
- unitstringPossible values:meterfeet
weightobject+−The weight of the vehicle
- valuenumber
- unitstringPossible values:kgpoundtonnes
- axlesnumberNumber of axles on the vehicle
- emissionClassstringThe emission class of the vehicle (only for Europe)Possible values:euro_0euro_1euro_2euro_3euro_4euro_5euro_6euro_eeveuro_15
- co2EmissionClassnumberVehicle CO2 emission category (only for Europe)Possible values:0 - 5
- vehicleNamestringSpecify name for your vehicle to identify the response json for particular vehicle
- isAsyncbooleanWhether the provided GPS tracks are processed asynchronously
- mapProviderstringThe map service provider for map matching given GPS tracks
fuelOptionsobject+−Please take note that the object must be in URI encoded format prior to sending a request. It is possible to encode it here
fuelCostobject+−Options to specify the cost of fuel
- valuenumberThe cost of fuel in a specified unit
- currencystringThe currency in which the fuel cost is represented
- unitsstringMeasurement unit for fuel cost
- fuelUnitstringMeasurement unit for fuel
fuelEfficiencyobject+−Options to specify the cost of fuel
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringMeasurement units for efficiency values
- fuelUnitstringMeasurement unit for fuel value
unitsobject+−Please take note that the object must be in URI encoded format prior to sending a request. It is possible to encode it here
- currencystringThe currency specified for the calculations
Request Schema
- stringbinary
Response Schema
- statusstringPossible values: okerror
summaryobject+−A summary of the toll API response for the given trip
countriesarray+−The list of countries that the current route spans
- stringstring
- currencystringThe currency unit used for calculations
- vehicleTypestringThe vehicle type used for calculations. For more information about vehicle types, click here
- vehicleDescriptionstringThe provided vehicle description
fuelPriceobject+−The fuel cost details used for calculations
- valuenumberThe cost of fuel in a specified unit
- currencystringThe currency in which the fuel cost is represented
- unitsstringMeasurement unit for fuel cost
- fuelUnitstringMeasurement unit for fuel
fuelEfficiencyobject+−If you want an accurate estimate of fuel expenses, you will need to specify parameters specific to fuel price and fuel efficiency as fuelEfficiency object.
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringMeasurement units for efficiency values
- fuelUnitstringMeasurement unit for fuel value
unitsobject+−A summary of the measurement units used for calculations
- currencyUnitstringThe currency unit specified in the request
- fuelEfficiencyUnitstringThe fuel efficiency units specified in the request
- fuelUnitstringThe fuel units specified in the request
- departureTimestringThe provided start time for the trip. If departure_time and locTimes both are not specified then we will use the current time for toll calculations.Possible values:DateTime (string)TimeStamp (number)
shareobject+−Shareable parameters for this response
- namestring
- prefixstring
- uuidstring
- timestampstring
- clientstring
routeobject+−Route information for the given trip
- hasTollsbooleanValue indicating whether there are any tolls along the current route
distanceobject+−The total distance of the current route
- textstringThe display value for the distance
- metricstringThe measurement unit for the distance
- valuenumberThe actual distance value
costsobject+−Costs object summarizes the toll cost and the fuel cost for the route.The fuel costs calculated from fuel efficiency (city fuel efficiency and highway fuel efficiency) and the speeds on each leg of the route.The tolls are added for all the tolls on the route for each payment type. If a payment type cannot be using on all the toll points on the route, the toll cost is returned as false. Else, the sum of tolls for the payment type is returned.
The tolls are returned for the following payment types:- Cash
- Transponder
- License Plate
- Credit card
- Prepaid pass
- tagAndCashnumberThe minimum cost between tag and cash
- minimumTollCostnumberThe minimum total cost
- maximumTollCostnumberThe maximum total cost
- fuelnumberThe calculated cost for fuel
- tagnumberThe calculated toll cost for tags
- cashnumberThe calculated cost for cash
- prepaidCardnumberThe calculated cost for prepaid cards
- licensePlatenumberThe calculated license cost for plate
tollsarray+−Array containing Open system - "barrier" (object) and Closed system - "ticketSystem1" (object), "ticketSystem2" (object), "ticketSystem3" (object), "distBarrier" (object).
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
- typestringType of the Toll System
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- tagPriCostnumberPrimary transponder cost, typically offering standard or discounted rates
- tagSecCostnumberSecondary transponder cost, usually without discounts
- cashCostnumberCash toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardNamesarray of stringsNames of prepaid cards accepted at the toll facility, eg: E-Toll
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
arrivalobject+−
- distancenumberDistance to the toll location in meters.
- timestringEstimated time of arrival (ETA) at the toll location in ISO 8601 format, e.g., '2024-12-17T12:30:00Z'
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem1
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem2
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem3
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- polylinestringThe base64 encoded linestring. Specified route as Google Maps encoded polyline (see details).
parkingsarray+−Parking facility details including entry and exit points, fees, and duration.
- parkingIdnumberUnique identifier for the parking facility.
- namestringName of the parking facility.
- addressstringStreet address of the parking facility.
- citystringCity where the parking facility is situated.
- statestringState where the parking facility is situated.
- countrystringCountry where the parking facility is situated.
- currencystringCurrency in which the parking fee is represented.
feeobject+−Fee details for the parking facility.
- cashnumberThe calculated parking cost for cash.
- tagnumberThe calculated parking cost for tags.
durationInsideParkingobject+−Details about the duration of the stay inside the parking facility.
- durationnumberDuration of stay within the parking facility.
- unitstringUnit of time for the parking duration.Possible values:seconds
entryobject+−Details about the entry point of the parking facility.
arrivalobject+−Arrival details at the entry point.
- distancenumberDistance from the origin to the entry point of the parking facility, measured in meters.
- timestringIndicates the time and date of arrival at the entry point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_formattedstringIndicates the time and date of arrival at the entry point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_localizedstringIndicates the time and date of arrival at the entry point in localized format, e.g., 2024-06-24T08:07:50+01:00.
pointobject+−Location details of the entry point of the parking facility.
- typestringType of the point (e.g., 'Feature').
geometryobject+−Geometry details of the entry point.
- typestringGeometry type (e.g., 'Point').
coordinatesarray+−Coordinates of the point in [longitude, latitude] format, e.g., [-9.1825, 38.7065].
- numbernumber
exitobject+−Details about the exit point of the parking facility.
arrivalobject+−Arrival details at the exit point.
- distancenumberDistance from the origin to the exit point of the parking facility, measured in meters.
- timestringIndicates the time and date of arrival at the exit point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_formattedstringIndicates the time and date of arrival at the exit point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_localizedstringIndicates the time and date of arrival at the exit point in localized format, e.g., 2024-06-24T08:07:50+01:00.
pointobject+−Location details of the exit point of the parking facility.
- typestringType of the point (e.g., 'Feature').
geometryobject+−Geometry details of the exit point.
- typestringGeometry type (e.g., 'Point').
coordinatesarray+−Coordinates of the point in [longitude, latitude] format, e.g., [-9.1825, 38.7065].
- numbernumber
vignettesarray+−
- typestring
- countrystring
- countryCodestring
ratesarray+−
- durationstring
- vignetteCostnumber
- currencyUnitstring
vignetteCoordinatesobject+−
- typestring
coordinatesarray+−
- numbernumber
metaobject+−The metadata associated with the request
- userIdstringUnique identifier for the user (e.g., email)
- customerIdstringUnique identifier for the customer
- txnumberNumber of transactions done
- typestringType of user
- clientstringClient accessing the API
- sourcestringMapping service, e.g., HERE Maps, Google Maps, etc.
Request
Response
Download Async Results
The results will be available for download for upto 30 days by calling the API.
Request Schema
- requestIdstringThe ID of the async request.
- requestedTimestampstringThe timestamp when the async request was made
Response Schema
- statusstringPossible values: okerror
summaryobject+−A summary of the toll API response for the given trip
countriesarray+−The list of countries that the current route spans
- stringstring
- currencystringThe currency unit used for calculations
- vehicleTypestringThe vehicle type used for calculations. For more information about vehicle types, click here
- vehicleDescriptionstringThe provided vehicle description
fuelPriceobject+−The fuel cost details used for calculations
- valuenumberThe cost of fuel in a specified unit
- currencystringThe currency in which the fuel cost is represented
- unitsstringMeasurement unit for fuel cost
- fuelUnitstringMeasurement unit for fuel
fuelEfficiencyobject+−Options to specify the cost of fuel
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringMeasurement units for efficiency values
- fuelUnitstringMeasurement unit for fuel value
unitsobject+−A summary of the measurement units used for calculations
- currencyUnitstringThe currency unit specified in the request
- fuelEfficiencyUnitstringThe fuel efficiency units specified in the request
- fuelUnitstringThe fuel units specified in the request
- departureTimestringThe provided start time for the trip. If departure_time and locTimes both are not specified then we will use the current time for toll calculations.Possible values:DateTime (string)TimeStamp (number)
shareobject+−Shareable parameters for this response
- namestring
- prefixstring
- uuidstring
- timestampstring
- clientstring
routeobject+−Route information for the given trip
- hasTollsbooleanValue indicating whether there are any tolls along the current route
distanceobject+−The total distance of the current route
- textstringThe display value for the distance
- metricstringThe measurement unit for the distance
- valuenumberThe actual distance value
costsobject+−Costs object summarizes the toll cost and the fuel cost for the route.The fuel costs calculated from fuel efficiency (city fuel efficiency and highway fuel efficiency) and the speeds on each leg of the route.The tolls are added for all the tolls on the route for each payment type. If a payment type cannot be using on all the toll points on the route, the toll cost is returned as false. Else, the sum of tolls for the payment type is returned.
The tolls are returned for the following payment types:- Cash
- Transponder
- License Plate
- Credit card
- Prepaid pass
- tagAndCashnumberThe minimum cost between tag and cash
- minimumTollCostnumberThe minimum total cost
- maximumTollCostnumberThe maximum total cost
- fuelnumberThe calculated cost for fuel
- tagnumberThe calculated toll cost for tags
- cashnumberThe calculated cost for cash
- prepaidCardnumberThe calculated cost for prepaid cards
- licensePlatenumberThe calculated license cost for plate
tollsarray+−Array containing Open system - "barrier" (object) and Closed system - "ticketSystem1" (object), "ticketSystem2" (object), "ticketSystem3" (object), "distBarrier" (object).
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
- typestringType of the Toll System
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- tagPriCostnumberPrimary transponder cost, typically offering standard or discounted rates
- tagSecCostnumberSecondary transponder cost, usually without discounts
- cashCostnumberCash toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardNamesarray of stringsNames of prepaid cards accepted at the toll facility, eg: E-Toll
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
arrivalobject+−
- distancenumberDistance to the toll location in meters.
- timestringEstimated time of arrival (ETA) at the toll location in ISO 8601 format, e.g., '2024-12-17T12:30:00Z'
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem1
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem2
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem3
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- polylinestringThe base64 encoded linestring. Specified route as Google Maps encoded polyline (see details).
vignettesarray+−
- typestring
- countrystring
- countryCodestring
ratesarray+−
- durationstring
- vignetteCostnumber
- currencyUnitstring
vignetteCoordinatesobject+−
- typestring
coordinatesarray+−
- numbernumber
metaobject+−The metadata associated with the request
- typestringType of user
- clientstringClient accessing the API (e.g., "web", "mobile")
- sourcestringMapping service, e.g., HERE Maps, Google Maps, etc.
- userIdstringUnique identifier for the user (e.g., email)
- customerIdstringUnique identifier for the customer
- txnumberNumber of transactions done
Request
Response
TollTally - Tolls for Polyline map matching
- Specify vehicle type. For example, you can receive tolls for vehicles based on axle counts for cars, SUV, pick-up, trucks (up to 9-axles), motorcycle, bus, motorhome, RV, limousine.
- Specify truck parameters such as weight, height, axle counts and receive tolls based on weight, height, etc.
- Specify the timestamp of each GPS trace in polyline. If you do not specify the timestamp, tolls are likely to be inaccurate on time-based-toll facilities.
Route Encoded Polyline
Polyline map matching aligns the route polyline to the actual roads on a map. It's like connecting the dots, but instead of drawing straight lines, it follows the twists and turns of real streets. This process cleans up any errors or "noise" in the original route data, making sure the path sticks to real roads. The result is a smoother, more accurate representation of the journey that matches the real-world road network.
Request Schema
- mapProviderstringDefault: here
Specify route source, either here for HERE maps routes based polyline or gmaps for Google Maps polylinesPossible values:googlebingmapboxapple mapheretomtomwazeesrimapquestjawgmapstrimbleptvmapmyindiayandexmichelinbaidugaode - polylinestringThe base64 encoded linestring. Specified route as Google Maps encoded polyline (see details).
locTimesarray+−Specify the locTimes utilizing a two-dimensional array of floating-point numbers, where each sub-array consists of the path or polyline index and the corresponding time-stamp for that coordinate. If locTimes is not specified we use departure_time as a the timestamp and if departure_time is also not specified we will use current time for toll calculations
arrayarray+−
- numbernumber
vehicleobject+−Options to configure vehicle parameters
- typestringThese vehicles are specific to US region. For more information about vehicle types, click here.Possible values:2AxlesAuto3AxlesAuto4AxlesAuto2AxlesDualTire3AxlesDualTire4AxlesDualTire2AxlesEV3AxlesEV4AxlesEV2AxlesTNC2AxlesTNCPool2AxlesTaxi2AxlesTaxiPoolCarpool2Carpool32AxlesTruck3AxlesTruck4AxlesTruck5AxlesTruck6AxlesTruck7AxlesTruck8AxlesTruck9AxlesTruck2AxlesBus3AxlesBus2AxlesMotorcycle3AxlesMotorcycle2AxlesRv3AxlesRv4AxlesRv
heightobject+−The height of the vehicle
- valuenumber
- unitstringPossible values:meterfeet
lengthobject+−The length of the vehicle (same unit as height)
- valuenumber
- unitstringPossible values:meterfeet
weightobject+−The weight of the vehicle
- valuenumber
- unitstringPossible values:kgpoundtonnes
- axlesnumberNumber of axles on the vehicle
- emissionClassstringThe emission class of the vehicle (only for Europe)Possible values:euro_0euro_1euro_2euro_3euro_4euro_5euro_6euro_eeveuro_15
- co2EmissionClassnumberVehicle CO2 emission category (only for Europe)Possible values:0 - 5
fuelOptionsobject+−The fuel options for the specified vehicle
fuelCostobject+−Options to specify the cost of fuel
- valuenumberThe cost of fuel in a specified unit
- unitsstringMeasurement unit for fuel cost
- currencystringThe currency in which the fuel cost is represented (If currency in units is not provided, the currency in fuel options will be used. If neither is provided, calculations will be based on the region by default.)
- fuelUnitstringMeasurement unit for fuel cost
fuelEfficiencyobject+−If you want an accurate estimate of fuel expenses, you will need to specify parameters specific to fuel price and fuel efficiency as fuelEfficiency object.
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringDefault: kmpl
Measurement units for efficiency values (If the fuel price is in liter, then we expect fuel efficiency to be in kmpl or L/100km, similarly, if it is in gallons, then we expect, efficiency in mpg.)Possible values:mpgkmplL/100km
unitsobject+−Default: USD
When currency in units is provided, it takes precedence for all calculations. When the value of fuelOptions.fuelCost.value is provided, we will extract this value and perform the necessary conversion- currencystringSet currency for calculationsPossible values:USDCADMXNINRAUDGBPNOKSEKDKKPENCOPARSCLFCLPSOL
- departureTimestringThe provided start time for the trip. If departure_time and locTimes both are not specified then we will use the current time for toll calculations.Possible values:DateTime (string)TimeStamp (number)
- includeParkingFeebooleanA flag indicating whether or not to include parking fee calculations in the response. Available only for SDK requests.
Response Schema
- statusstringPossible values: okerror
summaryobject+−A summary of the toll API response for the given trip
countriesarray+−The list of countries that the current route spans
- stringstring
- currencystringThe currency unit used for calculations
- vehicleTypestringThe vehicle type used for calculations. For more information about vehicle types, click here
- vehicleDescriptionstringThe provided vehicle description
fuelPriceobject+−The fuel cost details used for calculations
- valuenumberThe cost of fuel in a specified unit
- currencystringThe currency in which the fuel cost is represented
- unitsstringMeasurement unit for fuel cost
- fuelUnitstringMeasurement unit for fuel
fuelEfficiencyobject+−If you want an accurate estimate of fuel expenses, you will need to specify parameters specific to fuel price and fuel efficiency as fuelEfficiency object.
- citynumberFuel efficiency of the vehicle in cities
- hwynumberFuel efficiency of the vehicle on highways
- unitsstringMeasurement units for efficiency values
- fuelUnitstringMeasurement unit for fuel value
unitsobject+−A summary of the measurement units used for calculations
- currencyUnitstringThe currency unit specified in the request
- fuelEfficiencyUnitstringThe fuel efficiency units specified in the request
- fuelUnitstringThe fuel units specified in the request
- departureTimestringThe provided start time for the trip. If departure_time and locTimes both are not specified then we will use the current time for toll calculations.Possible values:DateTime (string)TimeStamp (number)
shareobject+−Shareable parameters for this response
- namestring
- prefixstring
- uuidstring
- timestampstring
- clientstring
routeobject+−Route information for the given trip
- hasTollsbooleanValue indicating whether there are any tolls along the current route
distanceobject+−The total distance of the current route
- textstringThe display value for the distance
- metricstringThe measurement unit for the distance
- valuenumberThe actual distance value
costsobject+−Costs object summarizes the toll cost and the fuel cost for the route.The fuel costs calculated from fuel efficiency (city fuel efficiency and highway fuel efficiency) and the speeds on each leg of the route.The tolls are added for all the tolls on the route for each payment type. If a payment type cannot be using on all the toll points on the route, the toll cost is returned as false. Else, the sum of tolls for the payment type is returned.
The tolls are returned for the following payment types:- Cash
- Transponder
- License Plate
- Credit card
- Prepaid pass
- tagAndCashnumberThe minimum cost between tag and cash
- minimumTollCostnumberThe minimum total cost
- maximumTollCostnumberThe maximum total cost
- fuelnumberThe calculated cost for fuel
- tagnumberThe calculated toll cost for tags
- cashnumberThe calculated cost for cash
- prepaidCardnumberThe calculated cost for prepaid cards
- licensePlatenumberThe calculated license cost for plate
tollsarray+−Array containing Open system - "barrier" (object) and Closed system - "ticketSystem1" (object), "ticketSystem2" (object), "ticketSystem3" (object), "distBarrier" (object).
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
- typestringType of the Toll System
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- tagPriCostnumberPrimary transponder cost, typically offering standard or discounted rates
- tagSecCostnumberSecondary transponder cost, usually without discounts
- cashCostnumberCash toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardNamesarray of stringsNames of prepaid cards accepted at the toll facility, eg: E-Toll
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
arrivalobject+−
- distancenumberDistance to the toll location in meters.
- timestringEstimated time of arrival (ETA) at the toll location in ISO 8601 format, e.g., '2024-12-17T12:30:00Z'
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem1
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem2
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- typestringToll type: ticketSystem3
- tagCostnumberTransponder toll cost. For example, IAVE, Tag PASE, TeleVia, VIAPass etc.
- cashCostnumberCash toll cost
- licensePlateCostnumberLicense plate (video) toll cost
- prepaidCardCostnumberPrepaid card such as Nexpress, Nexus Card, etc. toll cost
- currencystringCurrency
taxobject+−Object of tax details (applicable only for Europe)
- isTaxIncludedbooleanRepresents toll plaza tax inclusion
- taxValuenumberTax amount for tag/cash payment
- taxPercentnumberApplied tax percentage
- taxNamestringTax type identifier
- tagPrimaryarray of stringsA primary transponder that can be used on the facility. Typically primary transponders have discounts for each usage or based on volume.
- tagSecondaryarray of stringsAll other transponders that can be used on the facility. Secondary transponders may not count towards discounts
- licensePlateNamesarray of stringsName of the primary license plate toll (video toll) collection system.
- discountCarTypestringCar type eligible for discounts
- discountCarDetailsstringDetails of eligible cars for discount
startobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
endobject+−
- idnumberTollGuru toll ID. Useful for error checking
- latnumberApproximate latitude of the toll location
- lngnumberApproximate longitude of the toll location
- namestringName of the toll location
- roadstringName of the toll road
- statestringState, province of the toll location
- countrystring
arrivalobject+−
- distancenumber
- timestring
pointobject+−
geometryobject+−
- typestring
- coordinatesarray[lng, lat]
- timestamp_formattedstringA standardized timestamp in ISO 8601 UTC format. eg: '2024-12-17T13:48:54Z'
- timestamp_localizedstringA localized timestamp adjusted for local time zone in ISO 8601 format. eg: '2024-12-17T07:48:54-06:00'
- polylinestringThe base64 encoded linestring. Specified route as Google Maps encoded polyline (see details).
parkingsarray+−Parking facility details including entry and exit points, fees, and duration.
- parkingIdnumberUnique identifier for the parking facility.
- namestringName of the parking facility.
- addressstringStreet address of the parking facility.
- citystringCity where the parking facility is situated.
- statestringState where the parking facility is situated.
- countrystringCountry where the parking facility is situated.
- currencystringCurrency in which the parking fee is represented.
feeobject+−Fee details for the parking facility.
- cashnumberThe calculated parking cost for cash.
- tagnumberThe calculated parking cost for tags.
durationInsideParkingobject+−Details about the duration of the stay inside the parking facility.
- durationnumberDuration of stay within the parking facility.
- unitstringUnit of time for the parking duration.Possible values:seconds
entryobject+−Details about the entry point of the parking facility.
arrivalobject+−Arrival details at the entry point.
- distancenumberDistance from the origin to the entry point of the parking facility, measured in meters.
- timestringIndicates the time and date of arrival at the entry point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_formattedstringIndicates the time and date of arrival at the entry point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_localizedstringIndicates the time and date of arrival at the entry point in localized format, e.g., 2024-06-24T08:07:50+01:00.
pointobject+−Location details of the entry point of the parking facility.
- typestringType of the point (e.g., 'Feature').
geometryobject+−Geometry details of the entry point.
- typestringGeometry type (e.g., 'Point').
coordinatesarray+−Coordinates of the point in [longitude, latitude] format, e.g., [-9.1825, 38.7065].
- numbernumber
exitobject+−Details about the exit point of the parking facility.
arrivalobject+−Arrival details at the exit point.
- distancenumberDistance from the origin to the exit point of the parking facility, measured in meters.
- timestringIndicates the time and date of arrival at the exit point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_formattedstringIndicates the time and date of arrival at the exit point in ISO 8601 format, e.g., 2024-06-13T12:27:21Z.
- timestamp_localizedstringIndicates the time and date of arrival at the exit point in localized format, e.g., 2024-06-24T08:07:50+01:00.
pointobject+−Location details of the exit point of the parking facility.
- typestringType of the point (e.g., 'Feature').
geometryobject+−Geometry details of the exit point.
- typestringGeometry type (e.g., 'Point').
coordinatesarray+−Coordinates of the point in [longitude, latitude] format, e.g., [-9.1825, 38.7065].
- numbernumber
vignettesarray+−
- typestring
- countrystring
- countryCodestring
ratesarray+−
- durationstring
- vignetteCostnumber
- currencyUnitstring
vignetteCoordinatesobject+−
- typestring
coordinatesarray+−
- numbernumber
metaobject+−The metadata associated with the request
- userIdstringUnique identifier for the user (e.g., email)
- customerIdstringUnique identifier for the customer
- txnumberNumber of transactions done
- typestringType of user
- clientstringClient accessing the API
- sourcestringMapping service, e.g., HERE Maps, Google Maps, etc.
Request
Response
Transaction Count API
Retrieves total number of transactions processed.
- Authentication and authorization are required to use the API, which is done by providing an API key.
- Developers can make requests to the API and specify the start and end dates to retrieve the transaction count for a desired time period.
- The API response is typically in JSON format.
- The response includes the total number of transactions processed for each day in the specified time period.
Query Parameters
- startTimestringTimestamp (epoch) in seconds
- endTimestringTimestamp (epoch) in seconds
Request Schema
- nullnullThis endpoint does not allow user to send a request body. Use query parameters instead.
Response Schema
- userIdstring
- planstringPlan subscribed to
- planStatusstringPossible values:active
transactionsarray+−Daily transaction record
- datestringTimestamp in UTC
- txnumberAmount of total transactions
Response
Errors and Troubleshooting
Error Messages
| Status | Code | Value |
|---|---|---|
| 400 | INPUT_ERROR | Invalid request. The From and To locations cannot be empty |
| 400 | INPUT_ERROR | Invalid request. The From and To locations must be different |
| 400 | INPUT_ERROR | No path or polyline provided |
| 400 | INPUT_ERROR | Invalid locTimes. Length should be greater than 2. |
| 400 | INPUT_ERROR | Unsupported vehicle type. Please provide a valid vehicle type. |
| 400 | INPUT_ERROR | Weight should be greater than zero |
| 400 | INPUT_ERROR | Height should be greater than zero |
| 400 | INPUT_ERROR | Fuel cost should be greater than zero |
| 400 | INPUT_ERROR | City fuel efficency should be greater than zero |
| 400 | INPUT_ERROR | Highway fuel efficency should be greater than zero |
| 400 | INPUT_ERROR | No timestamps data provided |
| 400 | INPUT_ERROR | Unknown weight unit. available units are [pounds, kgs, ton, pound, kg, tonnes] |
| 400 | INPUT_ERROR | Unknown height unit. available units are [meter, feet, meters, feets] |
| 400 | INPUT_ERROR | The country you are querying may not be supported, or invalid latitude and longitude values were provided. Please check your coordinates or reverse them and try again. |
| 400 | INPUT_ERROR | Empty request: No CSV file provided |
| 400 | INPUT_ERROR | CSV file must be UTF-8 encoded |
| 400 | INPUT_ERROR | Empty file: Headers 'latitude' 'longitude' 'timestamp' along with corresponding data must be present in CSV file |
| 400 | INPUT_ERROR | Invalid CSV file: Headers 'latitude' 'longitude' 'timestamp' must be present |
| 400 | INPUT_ERROR | Invalid CSV file: CSV file must contain 'latitude' 'longitude' and 'timestamp' data |
| 400 | INPUT_ERROR | Invalid CSV file: Error reading CSV file |
| 400 | INPUT_ERROR | File too large: Please use isAsync=true in order to process large files |
| 400 | INPUT_ERROR | Missing values: Latitude longitude and timestamp values must be present for all rows |
| 400 | INPUT_ERROR | Either polyline or path must be specified |
| 400 | INPUT_ERROR | Invalid polyline: Length too short |
| 400 | INPUT_ERROR | Invalid path: Length too short |
| 400 | INPUT_ERROR | Invalid path segment: Each segment must contain two coordinates separated by a comma |
| 400 | INPUT_ERROR | Invalid path segment: Coordinates must be valid float values |
| 400 | INPUT_ERROR | Missing locTimes. Length should be greater than 2 |
| 400 | INPUT_ERROR | Invalid locTimes: Length should be greater than 2 |
| 400 | INPUT_ERROR | Either index or timestamp is missing from one or more instances of the locTimes array |
| 400 | INPUT_ERROR | Invalid Timestamp: Timestamp must be in epoch format (non-negative integer) |
| 400 | INPUT_ERROR | Timestamps should increase in the direction of travel |
| 400 | INPUT_ERROR | Gap between consecutive timestamps should not be more than a day |
| 400 | INPUT_ERROR | locTimes should increase in the direction of travel |
| 400 | INPUT_ERROR | Invalid latitude: <lat>, must be between -90 and 90 |
| 400 | INPUT_ERROR | Invalid longitude: <lng>, must be between -180 and 180 |
| 400 | INPUT_ERROR | <Vehicle Type> is not a valid vehicle type for region <region>. For list of supported vehicle types by region, please visit this link |
| 400 | INPUT_ERROR | Polyline is invalid |
| 400 | INPUT_ERROR | Invalid request. please provide a valid address or pincode |
| 400 | INPUT_ERROR | Found repeating index in locTimes. Repeated index is <index> |
| 400 | INPUT_ERROR | Invalid timestamp format; expected one of <expected_timestamp> current format: <current_timestamp> |
| 403 | FORBIDDEN | Request denied. No active subscription found |
| 403 | FORBIDDEN | Request denied. You have exceeded daily quota of 150 transactions. Please add a credit card and upgrade to a paid plan for continuing. |
| 429 | TOO_MANY_REQUESTS | Plan quota exceeded. Please upgrade or contact support |
| 500 | ROUTING_ERROR | No route exist |
| 500 | ROUTING_ERROR | Unable to generate a route for the provided GPS tracks |
| 500 | TOLLING_ERROR | API call failed with status: 500 Internal Server Error |
| 500 | SERVICE_ERROR | Unable to geocode the address after multiple attempts |
Error response format
{
"status": 500,
"code": "TOLLING_ERROR",
"value": "API call failed with status: 500 Internal Server Error"
}
Input Error - (INPUT_ERROR)
Errors caused as a result of bad csv file or malformed inputs
Example:
{
"status": "ERROR",
"code": "INPUT_ERROR",
"value": "Invalid request. The From and To locations cannot be empty"
}
Routing Error - (ROUTING_ERROR)
Errors arising out of routing issues like traces not making a valid route as detected by our algorithm.
Example:
{
"status": 500,
"code": "ROUTING_ERROR",
"value": "No route exist"
}
Tolling Error - (TOLLING_ERROR)
Errors caused while finding the toll prices of a given route.
Example:
{
"status": 500,
"code": "TOLLING_ERROR",
"value": "API call failed with status: 500 Internal Server Error"
}
- The status is the status code returned by the server
- The code is the error type which can be INPUT_ERROR, TOLLING_ERROR, ROUTING_ERROR, SERVICE_ERROR
- The value is the error message return
Vehicle Types Supported by TollGuru
North America
-
Car, SUV, Pickup truck
Icon Vehicle Type Description
2AxlesAuto Car, SUV or Pickup truck
3AxlesAuto Car, SUV or Pickup truck towing 1-axle trailer
4AxlesAuto Car, SUV or Pickup truck towing 2-axle trailer
2AxlesDualTire SUV or Pickup, 4 tires on rear
3AxlesDualTire SUV or Pickup, 4 tires on rear, 1-axle trailer
4AxlesDualTire SUV or Pickup, 4 tires on rear, 2-axle trailer -
EV
Icon Vehicle Type Description
2AxlesEV EV
3AxlesEV EV towing 1-axle trailer
4AxlesEV EV towing 2-axle trailer -
Truck
Icon Vehicle Type Description
2AxlesTruck Truck - 2 Axles
3AxlesTruck Truck - 3 Axles
4AxlesTruck Truck - 4 Axles
5AxlesTruck Truck - 5 Axles
6AxlesTruck Truck - 6 Axles
7AxlesTruck Truck - 7 Axles
8AxlesTruck Truck - 8 Axles
9AxlesTruck Truck - 9 Axles -
Bus
Icon Vehicle Type Description
2AxlesBus Bus - 2 Axles
3AxlesBus Bus - 3 Axles -
Motorcycle
Icon Vehicle Type Description
2AxlesMotorcycle Motorcycle
3AxlesMotorcycle Motorcycle towing trailer -
Recreational Vehicle
Icon Vehicle Type Description
2AxlesRv RV
3AxlesRv RV towing 1-axle trailer
4AxlesRv RV towing 2-axle trailer -
Rideshare, Taxi, Carpool
Icon Vehicle Type Description
2AxlesTNC Rideshare - Car, SUV or Pickup truck
2AxlesTNCPool Rideshare Pool - Car, SUV or Pickup truck
2AxlesTaxi Taxi - Car, SUV or Pickup truck
2AxlesTaxiPool Taxi Pool - Car, SUV or Pickup truck
Carpool2 Carpool (2 occupants)
Carpool3 Carpool (3+ occupants)
Country covered:Bahamas, Belize, Canada, Costa Rica, Cuba, Dominican Republic, El Salvador, Guatemala, Honduras, Jamaica, Mexico, Nicaragua, Panama, Puerto Rico, United States of America
Europe
-
Car and SUV
Icon Vehicle Type Description
2AxlesAuto Car, SUV
3AxlesAuto Car, SUV towing 1-axle trailer
4AxlesAuto Car, SUV towing 2-axle trailer -
Light Commercial Vehicle
Icon Vehicle Type Description
2AxlesLCV Light Commercial Vehicles 2-Axles -
Truck
Icon Vehicle Type Description
2AxlesTruck Heavy goods vehicles 2-Axles
3AxlesTruck Truck - 3 Axles
4AxlesTruck Truck - 4 Axles
5AxlesTruck Truck - 5 Axles
6AxlesTruck Truck - 6 Axles
7AxlesTruck Truck - 7 Axles -
Bus
Icon Vehicle Type Description
2AxlesBus Bus - 2 Axles
3AxlesBus Bus - 3 Axles
4AxlesBus Bus - 4 Axles -
Motorhome
Icon Vehicle Type Description
2AxlesRv Motorhome
3AxlesRv Motorhome towing 1-axle trailer
4AxlesRv Motorhome towing 2-axle trailer -
Motorcycle
Icon Vehicle Type Description
2AxlesMotorcycle Motorcycle, Motorcycle with sidecar
Country covered:Albania, Andorra, Austria, Belarus, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czechia, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Kosovo, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Moldova, Monaco, Montenegro, Netherlands, North Macedonia, Norway, Poland, Portugal, Romania, Russia, Russia, San Marino, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United Kingdom
Australia
-
Car, SUV
Icon Vehicle Type Description
2AxlesAuto Car, SUV
AutoTrailerCatA Car towing trailer (length<12.5 meter & height <2 meter)
AutoTrailerCatB Car towing trailer (length>12.5 meter & height >2 meter) -
Taxi
Icon Vehicle Type Description
2AxlesTaxi Taxi -
Light Commercial Vehicle
Icon Vehicle Type Description
2AxlesLCV Light Commercial Vehicles -
Truck
Icon Vehicle Type Description
2AxlesTruck Truck 2-Axles, Rigid
3AxlesTruck Truck 3-Axles, Rigid, Articulated
4AxlesTruck Truck 4-Axles, Rigid, Articulated
5AxlesTruck Truck 5-Axles, Articulated
6AxlesTruck Truck 6-Axles, Articulated, B-Double
7AxlesTruck Truck 7-Axles, Articulated, B-Double -
Bus
Icon Vehicle Type Description
2AxlesBus Bus -
Recreational Vehicle
Icon Vehicle Type Description
RVCatA RV (length < 12.5 meter & height < 2 meter)
RVCatB RV (length > 12.5 meter or height > 2 meter) -
Motorcycle
Icon Vehicle Type Description
2AxlesMotorcycle Motorcycle; with or without trailer
Country covered:Australia, New Zealand
Asia
-
Car, Jeep, Van, SUV
Icon Vehicle Type Description 
2AxlesAuto Car, Jeep, Van, SUV 
3AxlesAuto Car, SUV towing 1-axle trailer 
4AxlesAuto Car, SUV towing 2-axle trailer -
Taxi
Icon Vehicle Type Description
2AxlesTaxi Taxi -
Pickup Truck, Light Commercial Vehicle
Icon Vehicle Type Description
2AxlesLCV Pickup truck, Light Commercial Vehicles -
Truck
Icon Vehicle Type Description
2AxlesTruck Truck - 2-Axles
For India: Truck with 2-Axle whose gross weight >12,000kgs & <=16,200kgs< /td>
3AxlesTruck Truck - 3 Axles
For India: Truck with 3-Axle whose gross weight >16,200kgs & <=25,000kgs< /td>
4AxlesTruck Truck - 4 Axles
For India: Truck with 4-Axle whose gross weight >25,000kgs & <=36,600kgs< /td>
5AxlesTruck Truck - 5 Axles
For India: Truck with 5-Axle whose gross weight >36,600kgs & <=45,400kgs< /td>
6AxlesTruck Truck - 6 Axles
for India: Truck with 6-Axle whose gross weight >45,400kgs & <=54,200kgs< /td>
7AxlesTruck Truck - 7 Axles
For India: Truck with 7-Axle whose gross weight >54,200kgs -
Bus
Icon Vehicle Type Description
2AxlesBus Bus - 2-Axles
3AxlesBus Bus - 3 Axles
4AxlesBus Bus - 4 Axles -
Recreational Vehicle
Icon Vehicle Type Description
2AxlesRv Motorhome (not applicable to India)
3AxlesRv Motorhome towing 1-axle trailer (not applicable to India)
4AxlesRv Motorhome towing 2-axle trailer (not applicable to India) -
Bike
Icon Vehicle Type Description
2AxlesMotorcycle Bike
Country covered:Bangladesh, India, Indonesia, Laos, Malaysia, Myanmar, Philipines, Singapore, Taiwan, Thailand, Vietnam
Africa
-
Car, Jeep, Van, SUV
Icon Vehicle Type Description 
2AxlesAuto Car, Jeep, Van, SUV 
3AxlesAuto Car, SUV towing 1-axle trailer 
4AxlesAuto Car, SUV towing 2-axle trailer -
Taxi
Icon Vehicle Type Description
2AxlesTaxi Taxi -
Pickup Truck, Light Commercial Vehicle
Icon Vehicle Type Description
2AxlesLCV Pickup truck, Light Commercial Vehicles -
Truck
Icon Vehicle Type Description
2AxlesTruck Truck - 2 Axles
3AxlesTruck Truck - 3 Axles
4AxlesTruck Truck - 4 Axles
5AxlesTruck Truck - 5 Axles
6AxlesTruck Truck - 6 Axles
7AxlesTruck Truck - 7 Axles -
Bus
Icon Vehicle Type Description
2AxlesBus Bus - 2-Axles
3AxlesBus Bus - 3 Axles
4AxlesBus Bus - 4 Axles -
Recreational Vehicle
Icon Vehicle Type Description
2AxlesRv Motorhome
3AxlesRv Motorhome towing 1-axle trailer
4AxlesRv Motorhome towing 2-axle trailer -
Bike
Icon Vehicle Type Description
2AxlesMotorcycle Bike
Country covered:South Africa, Morocco, Uganda, Nigeria, Kenya, Egypt, Tunisia, Côte d'Ivoire, Tanzania
Latin America
-
Car, SUV, Pickup truck
Icon Vehicle Type Description
2AxlesAuto Car, SUV or Pickup truck
3AxlesAuto Car, SUV or Pickup truck towing 1-axle trailer
4AxlesAuto Car, SUV or Pickup truck towing 2-axle trailer -
Truck
Icon Vehicle Type Description
2AxlesTruck Truck - 2 Axles
3AxlesTruck Truck - 3 Axles
4AxlesTruck Truck - 4 Axles
5AxlesTruck Truck - 5 Axles
6AxlesTruck Truck - 6 Axles
7AxlesTruck Truck - 7 Axles -
Bus
Icon Vehicle Type Description
2AxlesBus Bus - 2 Axles
3AxlesBus Bus - 3 Axles -
Recreational Vehicle
Icon Vehicle Type Description
2AxlesRv RV
3AxlesRv RV towing 1-axle trailer
4AxlesRv RV towing 2-axle trailer -
Motorcycle
Icon Vehicle Type Description
2AxlesMotorcycle Motorcycle
Country covered:Argentina, Bolivia, Brazil, Chile, Colombia, Ecuador, Falkland Islands, French Guiana, Guyana, Paraguay, Peru, Suriname, Uruguay, Venezuela