Tollguru Toll API

Use this guide to seamlessly integrate Tollguru Toll API into your product

Sign up to get a FREE API key

Tollguru mapping service is designed for real America - where both costs and times figure in route decisions. Tollguru shows you cheaper routes not shown by any other mapping applications such as Google maps, Apple maps, Waze, HERE maps, Mapquest, OpenStreetMap, Scout GPS, Garmin, etc. Our routes consider two vectors - time and cost. Other mapping and navigation softwares optimize just for time.
Why should that matter to you? Let's take an example.
Say you have to dispatch a 5-axle semi from Englewood, NJ to Scarsdale, NY in upstate New York. Navigation softwares would show you three routes, most likely, all going over the George Washington Bridge (GWB) ($90 one-way toll with E-ZPass NY).
TollGuru would show the cheapest route over Tappan Zee/ Cuomo Bridge, the fastest route over GWB and some other logical routes. If you drive on the cheapest route (over Tappan Zee), you would take about 16 minutes more (than driving over GWB) but save $69 (if paying with NY E-ZPass). Since the cheapest route does not figure in top five fatest routes, it is never shown as an option. Use Tollguru trip calculators (on the web, Android or Apple phones) or integrate Tollguru API and save $69 in an hour long trip!

If you are not familiar with how toll roads charge tolls in the North America and India, read on.

Here is a brief introduction of tolling in North America

Toll agencies charge three types of tolls:

First, barrier system. If you pass through the mainline or ramp toll location, you pay toll as if it is a barrier (or a pike). Before the advent of electronic tolling, travelers stopped to pay the pike attendant. If the traffic was light, you stopped to ask the attendant about his son in your local high school team. But now at most locations you don’t even realize that you passed through a barrier toll plaza. Overhead electronic toll collection gantries collect toll at the barrier locations. The gantry reads RFID based transponders installed in your windshield and through a sophisticated IT system deducts tolls based on vehicle characteristics and your profile. For example, toll agencies in Texas and Florida charge barrier tolls based on number of axles. If you are a veteran, if you travel more often, the agency may offer a discount.

Barrier tolls in USA, Canada & Mexico
Ticket based tolls in USA, Canada & Mexico

Second, ticket system. You pay toll as if you traveled on a subway. You pay tolls based on where you got on (your entry) and where you got off (your exit location). For example, entire length of New Jersey Turnpike) including Pearl Harbor Extension, Pennsylvania Turnpike between Warrendale Main Line Barrier and Neshaminy Falls Main Line Barrier on East-West Main Line and between Mid-County and Wyoming Valley interchanges on Northeast Extension, New York State Thruway between New York Route 17 and Buffalo (including Berkshire Section) and between Buffalo and Pennsylvania State Line (Erie Section), Kansas Turnpike, Ohio Turnpike, Central Florida GreeneWay, Maine Turnpike, Indiana Toll Road between Portage Toll Plaza and Eastpoint Toll Plaza, Florida's Turnpike between Lantana Toll Plaza and Leesburg Toll Plaza and Turner Turnpike and Will Rogers Turnpike in Oklahoma are ticket systems.

Third, distance-based system. You pay toll calculated on how far you traveled on the toll road. For example, ETR-407 north of Toronto charges distance-based tolls. Tolls on 407 ETR and Highway 407 are based on vehicle type (light vehicle, heavy single-unit vehicle and heavy multiple unit vehicle), time-of-day (higher during peak traffic), day-of-week (higher on weekdays), direction of travel, distance between interchanges, payment types (transponder and camera charges (license plate toll)), and zones.

Distance based tolls in USA, Canada & Mexico - ETR 407

Now that is the theory. In practice, things get interesting.

Now that is the theory. In practice, things get interesting. One agency may use a mix of payment systems. For example, Indiana turnpike and Pennsylvania turnpike tolls are barrier tolls as well as ticket-based tolls. But you are not here to patronize one toll agency. All that you are interested in is traveling to your destination.
Say you want to travel from Brampton (north of Toronto) to Boston. Depending on your route, you may travel on ETR-407 (distance-based), New York Thruway (ticket-system) and Mass Pike (barrier system). Tolls on ETR-407 change based on time of day of your travel.

Tollguru REST API takes care of all such pesky details. It adds up all the barrier tolls, ticket-based tolls and distance-based tolls on the user routes and returns total toll for the routes for the payment methods you specify. Tollguru REST API also returns your estimated fuel expenses. If you want the fuel costs to be accurate you will need to specify fuel price you paid at the pump and vehicle fuel efficiency (city fuel efficiency and highway fuel efficiency). If you do not specify fuel cost and/or fuel efficiency, REST API will return average values. With Tollguru Toll API taking care of complex toll calculations and intracies of toll payments, you can concentrate on your product: trucking freight operations, transportation modeling, mode choice decision analytics, connected vehicles, rideshare services, billing, or anything where you want to use toll and fuel cost information.

Tollguru POST request is pretty flexible

Tollguru Toll Exchange REST API offers arrays of options to POST request, each tailored for seamless information exchange with broad spectrum of third party applications. It accepts following parameters:

  • Specify origin and destination: the Toll API will return Google routes and tolls and fuel expenses for each of the routes.
  • We understand Google Route polyline. If you have the route polyline, you can just pass it in the REQUEST. You will receive toll information for the route.
  • Specify an array of geo-coordinates, such as from a GPS device or a smartphone (but not the route), you can pass the array in the REQUEST to get tolls for the route closest matching to the geo-coordinates.
  • Search for tolls on a route using departure time. Departure time is optional parameter (uses current time by default). However, you can use departure time to receive tolls from variable toll facilities where tolls change based on the time-of-the-day or the day-of-the-week. The departure time needs to be in future since Tollguru returns routes under traffic conditions.
  • Calculate tolls for vehicles based on number of axles (cars, SUV, pick-up, truck, motorcycle, bus, motorhome / RV, limousine), or weight and height for large commercial trucks. For example, you will pay rates of tolls for same number of axles based on your vehicle height on the New Jersey Turnpike. Similarly, you will pay a different toll rate based on weight on Penn Turnpike.
  • Calculate total cost for the route after considering driver wages. If you specify driver wages, Tollguru will show you the cheapest route after considering driver wages.
  • Choose your optimal route based on your values of time. If you are willing to spend $2.00 to save 15 minutes (but not a penny more), Tollguru will consider your value of time to show you optimal routes.
  • Calculate tolls based on your transponder. Tollguru shows tolls for all the transponders accepted including discount tolls. In addition, you will see volume discounts offered at each toll location.

Interested to know more about Tollguru Toll API's exciting features and why it is best fit to your needs? Learn here.

Tollguru is excited to help your business scale new heights. Get your FREE API key today to start using Tollguru Toll API.

TollGuru is not affiliated with any tolling agency. All product and company names and logos are trademarks™ or registered® trademarks of their respective holders. Their use does not imply any affiliation with or endorsement. Toll rates are for planning purposes and maybe inaccurate. While toll calculations are available for a variety of vehicles, including commercial vehicles, routing for vehicles other than 2-axle cars and motorcycles should be verified by independent means. In no way should routing be considered safe or legal on its own.