TollGuru Logo

TollGuru Toll API

You can use TollGuru Toll API service to
  • 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 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.

  • Download OpenAPI Schema for this API
  • Download the Postman collection for this API

authentication

TollGuru uses developer specific API keys to authenticate requests. The authentication to the API is done through HTTP Basic Auth. Your API key serves as the basic auth username value. You do not need to provide a password. The TollGuru API key comes with privileges. Do not share API keys in publicly accessible areas such as GitHub or on client-side code in a browser. To get a TollGuru Toll API key

Registering for a new TollGuru developer API key at TollGuru developer portal.

Sign up for a trial account using your business email. Your trial access caps at 50 requests daily. 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:

x-api-key: DEVELOPER_KEY
Header Parameter Name Security Schema Type
x-api-key apiKey

our client libraries

You can use client libraries in Java, Python, Go, Node.js, PHP, Ruby, .NET to quickly integrate Toll API.
PHP Logo

PHP
Python Logo

Python
JS Logo

JS
Java Logo

Java
NodeJS Logo

NodeJS
GO Logo

GO
Ruby Logo

Ruby
.NET Logo

.NET

Origin, Destination and Waypoints

Use this API endpoint to calculate tolls and fuel expenses between origin, destination, and waypoints (if any). With this API endpoint, you can
  • 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

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

  • from object
    requiredThe starting point of the trip
      • One of:
  • to object
    requiredThe end point of the trip
      • One of:
  • serviceProvider string
    The map service provider to fetch routes from. Default: here
    Possible values:
    here gmaps
  • waypoints object
    Specify a range of intermediary locations, along your route between your origin and destination points
      • One of:
  • vehicle object
    Options to configure vehicle parameters
    • type string
      These vehicles are specific to US region. For more information about vehicle types, click here.
      Possible values:
      2AxlesAuto 3AxlesAuto 4AxlesAuto 2AxlesDualTire 3AxlesDualTire 4AxlesDualTire 2AxlesEV 3AxlesEV 4AxlesEV 2AxlesTNC 2AxlesTNCPool 2AxlesTaxi 2AxlesTaxiPool Carpool2 Carpool3 2AxlesTruck 3AxlesTruck 4AxlesTruck 5AxlesTruck 6AxlesTruck 7AxlesTruck 8AxlesTruck 9AxlesTruck 2AxlesBus 3AxlesBus 2AxlesMotorcycle 3AxlesMotorcycle 2AxlesRv 3AxlesRv 4AxlesRv
    • weight object
      The weight of the vehicle
      • value number
      • unit string
        Possible values:
        pound tonnes
    • height object
      The height of the vehicle
      • value number
      • unit string
        Possible values:
        meter feet
    • length object
      The length of the vehicle
      • value number
      • unit string
        Possible values:
        meter feet
    • axles number
      Number of axles on the vehicle
    • emissionClass string
      The emission class of the vehicle (only for Europe)
      Possible values:
      euro_0 euro_1 euro_2 euro_3 euro_4 euro_5 euro_6 euro_eev euro_15
  • allowFerry boolean
    A flag indicating whether or not to include ferry routes in the trip if available. By default, only land routes are provided.

Response Schema

  • status string
    Possible values:
    ok error
  • summary object
    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.
    • route array
      The list of points along the current route
      • location object
        The geographic coordinates for the given location
        • lat number
          The latitude of the coordinate
        • lng number
          The longitude of the coordinate
      • address string
        The 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)
    • countries array
      The list of countries that the current route spans
      • string string
    • currency string
      The currency unit used for calculations
    • vehicleType string
      The vehicle type used for calculations. For more information about vehicle types, click here.
      Possible values:
      2AxlesAuto 3AxlesAuto 4AxlesAuto 2AxlesDualTire 3AxlesDualTire 4AxlesDualTire 2AxlesEV 3AxlesEV 4AxlesEV 2AxlesTNC 2AxlesTNCPool 2AxlesTaxi 2AxlesTaxiPool Carpool2 Carpool3 2AxlesTruck 3AxlesTruck 4AxlesTruck 5AxlesTruck 6AxlesTruck 7AxlesTruck 8AxlesTruck 9AxlesTruck 2AxlesBus 3AxlesBus 2AxlesMotorcycle 3AxlesMotorcycle 2AxlesRv 3AxlesRv 4AxlesRv
    • vehicleDescription string
      The provided vehicle description
    • fuelPrice object
      Fuel price from request or the default fuel price (including currency)
      • value number
        The cost of fuel in a specified unit
      • currency string
        The currency in which the fuel cost is represented
      • units string
        Measurement unit for fuel cost
      • fuelUnit string
        Measurement unit for fuel
    • fuelEfficiency object
      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.
      • city number
        Fuel efficiency of the vehicle in cities
      • hwy number
        Fuel efficiency of the vehicle on highways
      • units string
        Default: kmpl
        Measurement units for efficiency values. If the fuel price is in liter, then we expect fuel efficiency to be in kmpl or l100, similarly, if it is in gallons, then we expect, efficiency in mpg.
        Possible values:
        mpg kmpl l100
      • fuelUnit string
        Measurement unit for fuel value
    • units object
      A summary of the measurement units used for calculations
      • currencyUnit string
        The currency unit specified in the request
      • fuelEfficiencyUnit string
        The fuel efficiency units specified in the request
      • fuelUnit string
        The fuel units specified in the request
    • departureTime string
      The 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)
    • share object
      Shareable parameters for this response
      • name string
      • prefix string
      • uuid string
      • timestamp string
      • client string
    • source string
      The map provider source used to get the list of possible routes
  • routes array
    A list of possible routes for the given trip
    • summary object
      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.
      • hasTolls boolean
        Value indicating whether there are any tolls along the current route
      • hasExpressTolls boolean
        Value indicating whether there are any express tolls along the current route
      • diffs object
        The difference in overall cost between the given trip and the cheapest and fastest trips
        • cheapest number
        • fastest number
      • url string
        URL for navigation for the current route through Google Maps
      • distance object
        The total distance of the current route
        • text string
          The display value for the distance
        • metric string
          The measurement unit for the distance
        • value number
          The actual distance value
      • duration object
        The estimated travel duration of the current route
        • text string
          The display value for the duration
        • value number
          The actual duration value
      • name string
        The name of the current route
      • note array
    • costs object
      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
      • tagAndCash number
        The minimum cost between tag and cash
      • minimumTollCost number
        The minimum total cost
      • fuel number
        The calculated cost for fuel
      • tag number
        The calculated toll cost for tags
      • cash number
        The calculated cost for cash
      • prepaidCard number
        The calculated cost for prepaid cards
      • licensePlate number
        The calculated license cost for plate
    • tolls array
      Array of Barrier (object) or TicketSystem1 (object) or TicketSystem2 (object) or TicketSystem3 (object)
    • directions array
      • position object
        • latitude number
        • longitude number
      • maneuver string
      • html_instructions string
      • distance number
      • duration number
      • note array
    • taxiCharges object
      Only visible when vehicle type is of type "Taxi".
      • taxiFare array
        • state string
        • start object
          • geometry object
            • coordinates array
              Example: [-75.360105,40.614533]
        • end object
          • geometry object
            • coordinates array
              Example: [-75.360105,40.614533]
        • distanceTravelled number
        • costPerUnitMile number
        • taxiFareForDistanceTravelled number
      • congestionSurcharge array
        Example: congestionSurcharge: [{"zone": "New York Congestion Zone 1", "charge": 2.5}]
        • Object object
          • zone string
          • charge number
      • airportCharges array
        Example: airportCharges: [{"name": "Hartsfield–Jackson Atlanta International Airport", "pickupCharge": 3.85, "dropOffCharge": 3.85, }]
        • Object object
          • name string
          • pickupCharge number
          • dropOffCharge number
      • taxiSummary object
        • totalTaxiCost number
        • totalTaxiFare number
        • totalDistanceTravelled number
        • totalExtraCharges number
        • tollCost number
        • currency string
        • distanceUnit string
    • polyline string
      A base64 encoded linestring representing the current route
    • vignettes array
      • type string
      • country string
      • countryCode string
      • rates array
        • duration string
        • vignetteCost number
        • currencyUnit string
      • countryCoordinates object
        • type string
        • coordinates array
          • number number
    • chargingPoints array
      Only visible when vehicle type is EV and region is US
      • id number
      • evStation object
        • contact object
          • phone string
        • brand string
        • connectorType string
        • powerFeedTypes array
          • totalNumberOfConnectors number
          • id number
          • name string
        • facilityType string
        • address string
        • position object
          • point object
            • type string
            • properties object
            • geometry object
              • type string
              • coordinates array
                • number number
        • pricingStructureType object
          • description string
        • accessTime string
        • otherInfo string
        • name string
  • meta object
    The metadata associated with the request
    • type string
      Type of user
    • client string
      Client accessing the API (e.g., "web", "mobile")
    • source string
      Mapping service, e.g., HERE Maps, Google Maps, etc.
    • userId string
      Unique identifier for the user (e.g., email)
    • customerId string
      Unique identifier for the customer
    • tx number
      Number of transactions done
post /origin-destination-waypoints
x-api-key
1
2
3
4
5
curl --request POST \
  --url https://apis.tollguru.com/toll/v2/origin-destination-waypoints \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>' \
  --data '{"from":{"address":"Walt Whitman Brg Philadelphia, PA 19148, USA"},"to":{"address":"Ocean City, NJ 08226 USA"},"serviceProvider":"here","waypoints":[{"address":"4 Clarks Landing Rd, Port Republic, NJ 08241, USA"}],"vehicle":{"type":"2AxlesAuto"}}'

Request

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "from": {
    "address": "Walt Whitman Brg Philadelphia, PA 19148, USA"
  },
  "to": {
    "address": "Ocean City, NJ 08226 USA"
  },
  "serviceProvider": "here",
  "waypoints": [
    {
      "address": "4 Clarks Landing Rd, Port Republic, NJ 08241, USA"
    }
  ],
  "vehicle": {
    "type": "2AxlesAuto"
  }
}

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
{
  "status": "OK",
  "summary": {
    "route": [
      {
        "location": {
          "lat": 39.90723,
          "lng": -75.14147
        },
        "address": "Walt Whitman Brg, Philadelphia, PA 19148, United States"
      },
      {
        "location": {
          "lat": 39.52122,
          "lng": -74.48604
        },
        "address": "4 Clarks Landing Rd, Port Republic, NJ 08241-9741, United States"
      },
      {
        "location": {
          "lat": 39.27952,
          "lng": -74.57579
        },
        "address": "834 Asbury Ave, Ocean City, NJ 08226-3657, United States"
      }
    ],
    "countries": [
      "USA"
    ],
    "currency": "USD",
    "vehicleType": "2AxlesAuto",
    "vehicleDescription": "Car, SUV or Pickup truck without 4 tires on rear axle",
    "fuelPrice": {
      "value": 3.9,
      "currency": "USD",
      "units": "USD/gallon",
      "fuelUnit": "gallon"
    },
    "fuelEfficiency": {
      "city": 23.4,
      "hwy": 30,
      "units": "MPG",
      "fuelUnit": "gallon"
    },
    "units": {
      "currencyUnit": "USD",
      "fuelEfficiencyUnit": "MPG",
      "fuelUnit": "gallon"
    },
    "departureTime": "2024-04-25T11:40:46.986004501Z",
    "share": {
      "name": "4 clarks landing rd, port republic, nj 08241-9741, united states-834 asbury ave, ocean city, nj 08226-3657, united states",
      "prefix": "4+clarks+landing+rd%2C+port+republic%2C+nj+08241-9741%2C+united+states-834+asbury+ave%2C+ocean+city%2C+nj+08226-3657%2C+united+states",
      "uuid": "6c1e86c3-9912-42d5-803d-3a2135b1aa2b",
      "timestamp": "2024-04-25T11:40:46.986016481Z",
      "client": "api"
    },
    "source": "HERE"
  },
  "routes": [
    {
      "summary": {
        "hasTolls": true,
        "hasExpressTolls": false,
        "diffs": {
          "cheapest": 0,
          "fastest": 0
        },
        "url": "https://www.google.com/maps/?saddr=39.907230,-75.141470&daddr=39.868230,-75.102130+to:39.771330,-75.048950+to:39.521090,-74.486166+to:39.521090,-74.486166+to:39.508370,-74.513150+to:39.504790,-74.521460+to:39.279402,-74.575553+to:39.279520,-74.575790&via=1,2,3,5,6,7",
        "distance": {
          "text": "73 mi",
          "metric": "118 km",
          "value": 118649
        },
        "duration": {
          "text": "1 h 23 min",
          "value": 5013
        },
        "name": "Garden State Pkwy"
      },
      "costs": {
        "tagAndCash": 6.79,
        "minimumTollCost": 6.79,
        "fuel": 9.81,
        "tag": 6.79,
        "cash": 6.9,
        "prepaidCard": 6.79,
        "licensePlate": null
      },
      "tolls": [
        {
          "id": 112001300,
          "lat": 39.513676,
          "lng": -74.686696,
          "name": "AEH : Egg Harbor Mainline Barrier",
          "road": "Atlantic City Expy",
          "state": "NJ",
          "country": "USA",
          "type": "barrier",
          "tagCost": 4.7,
          "tagPriCost": 4.7,
          "cashCost": 4.7,
          "prepaidCardCost": 4.7,
          "currency": "USD",
          "tagPrimaryNames": [
            "E-ZPass",
            "E-ZPass DE",
            "Uni",
            "I-Pass",
            "E-ZPass Skyway",
            "E-ZPass IN",
            "RiverLink",
            "E-ZPass ME",
            "E-ZPass MD",
            "E-ZPass MA",
            "MnPass",
            "E-ZPass NH",
            "E-ZPass NJ",
            "E-ZPass NY",
            "E-ZPass NC",
            "E-ZPass OH",
            "E-ZPass PA",
            "E-ZPass RI",
            "E-ZPass VA",
            "E-ZPass WV",
            "E-Zpass Flex"
          ],
          "prepaidCardNames": [],
          "tagPrimary": [
            "E-ZPass",
            "E-ZPass DE",
            "Uni",
            "I-Pass",
            "E-ZPass Skyway",
            "E-ZPass IN",
            "RiverLink",
            "E-ZPass ME",
            "E-ZPass MD",
            "E-ZPass MA",
            "MnPass",
            "E-ZPass NH",
            "E-ZPass NJ",
            "E-ZPass NY",
            "E-ZPass NC",
            "E-ZPass OH",
            "E-ZPass PA",
            "E-ZPass RI",
            "E-ZPass VA",
            "E-ZPass WV",
            "E-Zpass Flex"
          ],
          "tagSecondary": [],
          "licensePlateNames": [
            "Tolls by Mail"
          ],
          "discountCarDetails": "Monthly Volume Discount: E-ZPass NJ must be used 30 times in 35-day period.",
          "discountCarType": "All vehicles",
          "arrival": {
            "distance": 61550.9,
            "time": "2024-04-25T12:18:52Z"
          },
          "timestamp_formatted": "2024-04-25T12:18:52Z",
          "timestamp_localized": "2024-04-25T08:18:52-04:00",
          "point": {
            "type": "Feature",
            "geometry": {
              "type": "Point",
              "coordinates": [
                -74.686696,
                39.513676
              ]
            }
          },
          "tagRequested": "tagPriCost",
          "tollAgencyNames": [
            "Atlantic City Expressway"
          ],
          "tollAgencyAbbr": [
            "ACE"
          ],
          "tagSecCost": null,
          "licensePlateCost": null,
          "height": null
        },
        {
          "id": 112106000,
          "lat": 39.3230070016561,
          "lng": -74.6161949840383,
          "name": "Somers Point",
          "road": "Garden State Parkway",
          "state": "NJ",
          "country": "USA",
          "type": "barrier",
          "tagCost": 2.09,
          "tagPriCost": 2.09,
          "tagSecCost": 2.09,
          "cashCost": 2.2,
          "prepaidCardCost": 2.09,
          "currency": "USD",
          "tagPrimaryNames": [
            "E-ZPass NJ"
          ],
          "prepaidCardNames": [],
          "tagPrimary": [
            "E-ZPass NJ"
          ],
          "tagSecondary": [
            "E-ZPass",
            "E-ZPass DE",
            "Uni",
            "I-Pass",
            "E-ZPass Skyway",
            "E-ZPass IN",
            "RiverLink",
            "E-ZPass ME",
            "E-ZPass MD",
            "E-ZPass MA",
            "MnPass",
            "E-ZPass NH",
            "E-ZPass NY",
            "E-ZPass NC",
            "E-ZPass OH",
            "E-ZPass PA",
            "E-ZPass RI",
            "E-ZPass VA",
            "E-ZPass WV",
            "E-Zpass Flex"
          ],
          "licensePlateNames": [
            "Tolls by Mail"
          ],
          "discountCarDetails": "Other discounts: 65+ Senior citizens receive a 10% discount on the off-peak rate as Senior Citizen Discount. Vehicles with fuel efficiency 45 MPG and meeting California Super Ultra Low Emission Vehicle (SULEV) standard receive a 10% discount on the off-peak rate as Green Pass Discount. Must have NJ E-ZPass.",
          "discountCarType": "Cars",
          "arrival": {
            "distance": 112409.03,
            "time": "2024-04-25T12:58:33Z"
          },
          "timestamp_formatted": "2024-04-25T12:58:33Z",
          "timestamp_localized": "2024-04-25T08:58:33-04:00",
          "point": {
            "type": "Feature",
            "geometry": {
              "type": "Point",
              "coordinates": [
                -74.6161949840383,
                39.3230070016561
              ]
            }
          },
          "tagRequested": "tagPriCost",
          "tollAgencyNames": [
            "Garden State Parkway"
          ],
          "tollAgencyAbbr": [
            "GSP"
          ],
          "licensePlateCost": null,
          "height": null
        }
      ],
      "polyline": "ekqrFbasiM\\sDb@oEBUB[Dg@F]Z_Dj@cGT_CHaA\\aD@YTaCXoC|@cJ^eEj@oFZsDXoCf@iFDc@LsATaC^yDTuBL_BLuAn@wGJ_AHs@^cEv@gJd@wEFo@Fg@Dk@LiAD]TuBJw@NcAHe@Lq@R_ALg@H[La@Ne@Xw@`@_ARc@R_@Vc@Xc@`@k@`@i@V[d@g@h@g@r@o@NM|@s@b@]`@Y\\Up@c@TOz@i@x@g@j@]|@g@j@[d@Wj@Yt@]t@]t@]ZMXK^Mv@]r@[l@WnAg@pBu@rBu@jC_Az@Yx@Wn@SrAc@f@O^KRGf@Oh@Od@Mt@S`AWnA[tA]fBc@x@Qz@QnAW`ASp@Mv@O~@Qn@Mv@Mf@IdAQrBY|ASvBW`AKp@IzAO~AQr@K|AMtBMdBKp@En@ExAIp@E`@CTA\\CRAvAK`DS`F[bAIhAIrCSf@ElAM~BSbCQdAGr@Er@E~@I^CZCfCKn@Ap@?bA@j@@fGV`ABTAZC^CVC^G\\GNCl@O`AWZIn@Q^MXI`@K^Id@M\\Gz@Kr@IZE^EjAOXE^GfDg@fAQXEdASVGHCVGr@Sp@ObDu@rD}@~EiAfBc@zBi@hCo@zA_@r@QvD}@VGl@M~Bk@d@M\\I`AWf@K`@KjEgAjBa@tCo@|@Sn@OfAWj@O~@UhBc@rJ{BtKeCbCm@jG{AbBa@j@MbFiAzCs@zCs@hHcB|EkAnAWlA[fBe@r@Uf@OhDmAb@Qd@SdBu@vAo@b@Ql@Yn@_@j@]tBoAvAy@bCiBtBaBtAmAj@g@~@y@\\[b@c@f@g@v@y@hAmAxAgBt@}@t@aAt@eARY\\g@NS\\c@~AcC~A}BT[xAuB|D{Fh@y@d@u@p@iA~@_Bt@sAt@wA`AoBv@_Bt@_Bl@uAt@gBvBoFbBcE`D_InAwCl@oAv@}ArBeEp@sAv@qA|@eBf@{@rAuBbAcBjAiBp@cAdBaCbAuAdByBfAqAtA_BxAaBdEiEz@y@b@_@h@g@n@k@vAmAf@a@hA}@vAcA`Aq@bCaBfC{AjDqBtBkAxA{@xA{@fDmBhEcC\\STOHEbCuA|BqAnBiAjEeC`B_AjDiBnDaB~BcAnDuAbA_@lC}@zC}@lCu@~Bi@xBe@zAYbBY|AUtDc@nDa@nBSn@Ej@Ep@Er@CbAEpBG`BCzAEfBAjFEfG@jGD~FA|HEtJ?dCAxBCf@?lA?`DA|A?|@@hFDb@?t@?rCEx@Ar@?XAZCPAVCb@Gt@Ov@SPGXKn@Yh@WZSXS\\Y`Ay@dCaClDeDh@g@d@a@n@i@f@a@h@a@f@_@bAs@v@i@fAs@`CwA~BqATMnGkDnBkA|AiA`Aw@~@_AvA{ApA}A~@oAfAcB`AcBx@cBjCiGfBkEdAeCZw@nA_Dt@eBr@aBx@kBz@kBrAqCnB{D`AmBp@oAx@{A|AoCnAwBjB}CpB{ClAeBpAkBp@cAnAgBfAwAxBqClBaC~AkBpAyAbCkC~CgDfEcEfCcCrEqE|DwDxMkMvFwFzByBvAuApAsAvA{AtB{BvAwAbIaIZ[XWdEyDxAsAbByAr@q@l@i@dB}Al@k@l@k@bBaBtBsB~B}BdE_EjDiDrAoAfCeCjCgCfFcFfBcBhBkB|CcDhAoA~@eAzAgB~@iAlBaCrAeBjA_BlAeB|@qAjAgB`A{AjAkBd@w@fB{CjAsBxCkFnFsJnC}Ex@yA~@_BvA_C^o@p@mA^s@dBaD|@gBx@kBv@oB~BcHp@sBJ]Pi@dAcDrAiELc@tBaIP}@XwAH]VwA^mB`@cC^gCrA}KVmBj@sEt@iGt@eGr@_Gf@cEt@eGh@gEf@eEf@eEbAiIh@cEdA{Hz@yF|@wFpA}HbA}FzA}HhBcJtCoMfBuHj@{BZmALg@Lg@hAkE`AsDhAyDtA}Ej@eBPm@Ro@~FuR`P}h@fBuFpAyDjBmFfBwE\\cAb@iAnA_Dr@eBz@qBjAiChAcC|@oBtAuChBmDbBcDjBiDpBmDfAiBlB}ClB{CfAcBvB}C`B_CxAqBlBgCbC}ChAuAvAcBxAeBbAmAhBoBzDeElDuDnCsCvSoT`CiCnGyGrBqB~CaDn@m@nDyE~AkBrA{AtAyArGcHRSHIXWbGoGnWoXjHyHd^m_@hCoC|JoKp@q@nBuBp@s@v@{@|AaBdEkEnFyFdDmD\\_@lRcS|_@ia@nH}HjBqBrAsApAuArA{ArAyAlAyAnAwApBeCrBmCvEoG`DuEvAyBdBqC|AcCn@cAd@u@Xc@rC{EbHmLpDgGzEoIT_@T_@rEsHbCwDxBgDx@mArCiEv@mAl@aAtC{E|AgCj@aAnFkJnBgDb@s@fGwJ|@_BVg@hBeDXe@hEmH`@s@T_@dBmCp@cArB_DNWxEmHdBmC`IuMxE_Ib@s@|GcLvHgMdI_NvFiJxG}K`HkLrDeG|HyMbDyFTa@T_@dDuFl@aAdA_BbA}ApB{CjAiB~@yAdAcBhB{Cr@mAt@qAjAuB|FaKzIoO~DcHhCoEbD_GlMuUTa@Xe@Tc@\\o@\\o@Zi@p@mAr@oAx@yAt@oAz@uAjAiBl@_At@kAf@y@p@gAv@mA~@_Bv@sA~AoCf@{@j@cAl@iAv@wAz@yAdD{FzGqLbBwC`FuIlAwBZk@xAkCtEcIpFqJfD}FrDoGbAiB~@cB~BcElAsBl@eAh@_Ad@w@f@y@n@eA|@wA`@o@h@w@h@w@r@aAx@gA|@kAhAuApCkDpBeCdGqHdFoGjMyOtIoK\\c@Z_@jEoFpHgJdAqAt@}@lLwNxKaNfGsHp@{@dKmMjEoF|EaGxJyL|GoIjIcKlB_CxAkBdAuAp@_Ax@kA|@sAt@kAv@oAt@oAn@gAh@cAfAoBfAqB`CoEfHuMlDuGpK}RfDmG`HmMtGyLrFeKhDgGjC}EdCuElA{BpBwDh@aAj@cA`@s@b@u@P[Xg@f@{@f@{@dAeB|AeClCeExCgF~B_EvCcFv@sAz@sAz@sA|@qAxB}CvDyFn@aAb@q@d@u@~BsDbBmCdBoCbA}A|AoCfCmEVa@`BqCXa@l@cAnAsBn@gAl@aAR[JOLSHMLSJOLSPWNULQPW`@k@`AuA`B_C~AaC`CmDnB}C|AgChBuC`BiC|IqNpWya@tc@}r@dVw_@~Xyc@~BuDR[PYV_@PWRYZc@PWNSRWPSZ_@|@eA^c@XYVWv@w@b@c@XWVURQ^]h@e@j@c@XUVSTQROTQPMROZUPMXSNKNKTOd@[j@]r@a@v@c@TMRKRKZOVMTKTKVMPITKTKZMVKTIRKRINGz@]^O^Kx@WRGRGRGRGXITGZIZI\\Ib@Kb@MRCXGZGTEZGl@Kh@I^Gj@I`@Gn@Ib@G`@Ej@Gd@Eh@Eh@Ev@Gv@Gh@Ef@E`DUvAKvAKbQqA|D[ZCVCVCVEVCRCTCZEXEh@Il@Ib@I^Gt@Op@MREPEJCPEVGfAWfBMZC\\Cd@B`@B`@Db@Ff@HjEt@ZENCJGLQHOK[_A}C[aAM_@cBeFuAeEyCcJY{@aCwHk@iBoA{D_@mAyBcH_@iAw@cC[aAa@oAoAaEWw@gBsF_@iASm@iF_PoHuUiDoKoGaSqDkLi@cBaDmK{A_FEMOg@i@cB}@qC{@oCa@qAWu@kB}FY}@a@mAY{@uC{IoD_LaF}NoDeKa@mAeA}CwGqRYy@kBqFOe@u@wBOa@s@uBa@mAq@qB}@kC{@aCSi@[_A]aAm@cBe@sACIWs@Ww@i@aBe@wAcAwCISa@iAi@yAOc@Sm@Ws@Oa@K[GOEMM_@GQGSKWGSm@eBgAaD}AwEWw@_AmCa@kAc@sAqAuDqBaGsA_EcA}C[y@c@oAYy@m@gBQi@_@eAsA}DeA}CgA}CcA{C[}@Ww@iBkFcAuCoAeDmBoFqBiG}@eCcBeFCIgAcDWw@k@_Bu@wBiAeDg@wAc@qAWq@Sg@Ue@OYMSSW[a@[_@u@aA}@gAUYg@o@gAqAqAaBsCkDwBkC{AiBqAaBiB{B[a@QW}@eB}DsLyAoE}A{EcCoHc@uAsA_EwH{UuAeEgAeDy@cCSm@g@{A{@oCyAyEYaAg@_BWw@m@mBe@uA[_AUm@_AoCs@uBsBeGu@{By@_CQg@KUYq@]q@OSQSq@i@cBeAa@UkAk@oBaAqAq@cD_BwLeGgG}Ci@WsBeAsAq@_@SYMWY_@c@k@q@i@{@Ug@Uk@k@}B]}Ag@aCaAoEAMKk@Ec@CeACcBBk@Bi@DYLeAP_B^yDPeBJkACgAEsBEe@CQOgAc@aC{@yEq@kDEUa@}BGg@Ca@Bi@Fk@NiAJ}@N{@Fc@Fo@@o@Ac@Aa@EY[qCAMa@eE]kD_@mD{@cI_ANYBY?Aj@e@d@CD??BEd@e@Bk@X?VE`AMz@bI^lD\\jD`@dE@LZpCDX@`@@b@An@Gn@Gb@Oz@K|@OhAGj@Ch@B`@Ff@`@|BDTp@jDz@xEb@`CNfABPDd@DrB@fAKjAQdB_@xDQ~AMdAEXCh@Cj@BbBBdADb@Jj@BL`AnEf@`C\\|Aj@|BTj@Tf@h@z@j@p@^b@VXVL`@RrAp@rBdAh@VfGzCvLdG`D~ArAp@nB`AjAj@^TdBdAp@h@PRNR\\p@Xp@JTPh@x@~Bt@zBrBdGr@tB~@nCTl@Z~@d@tAl@lBVv@d@~AX`AxAxEz@nCi@?oAJ}APoBRiALm@Fa@?[EYKUQSWM[I[E[Aa@@_@DYLa@LWRWXSXOBARGp@MvBWj@Kl@KbAGrCUtAOvAQ|HeAvLeB`AMrASl@I`CW`DYfBM~BMjBIhAC|AAjA@r@@lBHvBLh@DtANdALfAPj@Jr@NrAZd@Jt@RjBh@|@ZtAf@dAb@l@VnAl@lBdAfAl@x@d@fAp@lBnAfBnA~DvCrAbA\\V\\TvBfBd@\\vFbE~C|B`Ap@h@\\j@Z`Af@f@V^R~@b@pB|@n@X~Ah@dIxBtKvCd@L|@VfAZ`G|AtNxDnA\\`@LfAZ~Bt@rAb@xBx@d@PhDnARHdDpA|ChAzDtA~CjAv@X|@Zj@PhA\\dAV~@Tb@Jl@LbAPnARrBVH@nAHx@FjAH|DV`CN~@HdAJrBXbCf@rAZtBl@n@Vj@RfBt@pBz@f@Tl@VVLFBPHx@\\h@TbGjCvD`BrAj@nAh@t@V|@XdAXzA\\dBX^Fb@FXBv@Fd@BbAD`BDfA@`@?p@@zA@hA@z@@h@?v@B^@f@?fDD~A@jA@tCDnCFvBN~BPnD^lC\\nC`@`Dn@rCn@rA\\rBl@zBp@rBr@bE`BbDxApAn@tAr@dB`AtBlAtA~@jAv@`CbBtGfFfDnCzAnArB~AnEfDbExCfEnC|ClBhBfAnBjAjB`AzFxCvG|C^PVLXNVJlCjAxClAt@XfFfBxAf@bA\\xAd@`Bf@nCv@nEjAbCr@dBd@hBf@pCt@|Bj@jB`@jBf@f@Nb@N~@\\tBbAb@T|@h@jAr@|BzAn@`@PJhAp@nAv@zCnB|@j@RLlJ|FzClBXP|@j@|@l@d@\\z@n@n@f@j@d@z@t@p@j@z@x@r@p@~A~AlApAfAlAn@t@p@x@h@n@h@p@z@hAf@p@`@j@v@fAzAvBpGfJz@nAb@p@f@r@~@pAp@~@l@x@j@t@f@n@j@r@n@v@n@t@j@l@h@h@h@h@~@z@d@b@XV`@\\h@b@d@^`@Zf@^x@l@v@h@r@d@n@`@nAx@~@n@`Ap@bGhE`BjAtEhDbAt@r@f@t@f@j@^t@d@~@j@d@Xj@Zp@^n@Z`@Rh@Vz@`@r@Zj@Tz@\\|@\\n@Tx@Xh@Pt@Tr@Rt@Rx@R|@Rx@Pt@Np@LbFz@xEx@~B^d@HZFVDj@J`AR`ATp@Pr@R`AZx@Vl@RjBr@tAl@z@`@`Af@|BnAl@^^Th@\\h@^t@h@p@f@f@`@f@`@f@b@j@h@vAtAtAxAvAzA~AdBjHzHfErEjCtC~A`BdAbAl@h@v@p@l@f@f@`@t@j@`Ar@pA|@p@b@p@`@n@^p@^n@\\|@b@fAf@dAd@d@Rn@Vh@Rh@P~@Zz@X~@X`Bf@lA^vBr@d@Pj@Tl@Vr@Zr@\\v@b@~@j@z@j@x@l@dKdIn@f@d@^r@j@rB~AbAv@n@f@r@h@h@^b@Xf@Zj@\\bAl@`@Th@X~@d@\\PZNTJPHXLRHVJVJb@Pp@Vl@Tl@TXJTHZJ|DnAd@Nf@LfA\\x@VVHtDhAb@Nn@Tv@Zp@Xx@`@z@d@l@\\l@^j@^l@b@h@`@`@\\j@f@|@z@l@l@l@p@z@`An@t@t@|@lDjEhBxBhBzBvBjC^b@zBpCjAtAb@bAJ\\F`@Dj@?t@CdAC`A?`@B\\FZJZNRRRTJTDTAVCXMb@g@|@mAZo@x@wANU~AsCvAcCn@gAhAmBn@mAh@_ATa@NW^q@`@s@v@sADIHMl@eAb@u@pGyK@CDG\\m@t@qAb@u@Va@`@q@nBeD`@s@`A_Bl@aAj@gAP[b@eAFQPk@Rs@T_@LYFO^{@\\u@r@mAn@gAb@s@`AyAn@aADGFW\\e@TYLO^a@VWRSRSZY`@]POVSd@]TOTM`@WXONITMNINILGLGNGTITIPGVIt@UlA[nA[p@QXIPGl@Ql@SlAa@x@W`@SRKTMPKLItA}@v@i@TOpBuAjA_Al@e@t@q@p@q@l@u@r@aAzAyBv@kAt@iAf@s@b@k@f@m@h@k@f@i@x@u@t@k@nA{@nA{@|A_AhBaAzAw@p@a@fDyBpBsAzAiAz@i@hEqC`CeBlBuA`DeCvAcAdLaIbBoAtDmCdD_Ct@k@z@m@tB{A~@o@l@_@r@]r@Yp@Sz@Sx@Mx@Gt@Cp@?n@@R@Z@lAFpADj@@t@C`@Cl@In@Qd@Qd@U`@W\\YZ[VYTYXo@bAwA`@m@z@mAp@aAf@q@V]`@m@T[bAwAr@cAx@kA|@oAf@m@jAwAoBmC"
    }
  ],
  "meta": {
    "userId": "example@tollguru.com",
    "customerId": "cus_Gxf4fIF58h6ltA",
    "tx": 5,
    "type": "api",
    "client": "api",
    "source": "here"
  }
}

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

  • from object
    requiredThe starting point of the trip
      • One of:
  • to object
    requiredThe end point of the trip
      • One of:
  • vehicle object
    requiredOptions to configure vehicle parameters
    • type string
      requiredThese vehicles are specific to US region. For more information about vehicle types, click here.
      Possible values:
      2AxlesTruck 3AxlesTruck 4AxlesTruck 5AxlesTruck 6AxlesTruck 7AxlesTruck 8AxlesTruck 9AxlesTruck
    • height object
      The height of the vehicle
      • value number
      • unit string
        Possible values:
        meter feet
    • length object
      The length of the vehicle (same unit as height)
      • value number
      • unit string
        Possible values:
        meter feet
    • weight object
      The weight of the vehicle
      • value number
      • unit string
        Possible values:
        pound tonnes
    • axles number
      Number of axles on the vehicle
    • emissionClass string
      The emission class of the vehicle (only for Europe)
      Possible values:
      euro_0 euro_1 euro_2 euro_3 euro_4 euro_5 euro_6 euro_eev euro_15
  • waypoints object
    Specify a range of intermediary locations, along your route between your origin and destination points
      • One of:
  • serviceProvider string
    The 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: here
    Possible values:
    here gmaps tollguru
  • departureTime string
    The 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)
  • fuelOptions object
    The fuel options for the specified vehicle
    • fuelCost object
      Options to specify the cost of fuel
      • value number
        The cost of fuel in a specified unit
      • units string
        Measurement unit for fuel cost
      • currency string
        The 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.)
      • fuelUnit string
        Measurement unit for fuel cost
    • fuelEfficiency object
      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.
      • city number
        Fuel efficiency of the vehicle in cities
      • hwy number
        Fuel efficiency of the vehicle on highways
      • units string
        Default: kmpl
        Measurement units for efficiency values. If the fuel price is in liter, then we expect fuel efficiency to be in kmpl or l100, similarly, if it is in gallons, then we expect, efficiency in mpg.
        Possible values:
        mpg kmpl l100
  • units object
    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
    • currency string
      Set currency for calculations
      Possible values:
      USD CAD MXN INR AUD GBP NOK SEK DKK PEN COP ARS CLF CLP SOL
  • truck object
    Truck routing only
    • truckType string
      Specifies the vehicle type
    • trailersCount number
      Specifies number of trailers pulled by a vehicle. The provided value must be between 0 and 4.
    • shippedHazardousGoods string
      List of hazardous materials in the vehicle. The names correspond to HAZMAT classes 1 to 9. For example, explosive is Class 1 and so on.
    • limitedWeight number
      Vehicle weight including trailers and shipped goods
    • weightPerAxle number
      Vehicle weight per axle
    • height number
    • width number
    • length number
    • tunnelCategory string
      Specifies the tunnel category to restrict certain route links. The route will pass only through tunnels of a less strict category
      Possible values:
      B C D E
    • truckRestrictionPenalty string
      Specifies the penalty type on violated truck restrictions.
      Possible values:
      strict soft
  • driver object
    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
    • wage number
      Default: 30
      Driver wage per hour
    • rounding number
      Default: 30
      How is the driver time is rounded (to 30 minutes, an hour, etc.)?
    • valueOfTime number
      Default: 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.
  • state_mileage boolean
    A flag indicating whether or not to include state mileage calculations in the response
  • hos object
    Parameters for Hours of Service calculations for trucks
    • dutyHoursBeforeEndOfWorkDay number
      The remaining total duty hours before the work day ends
    • dutyHoursBeforeRestBreak number
      The remaining total duty hours before the next rest break
    • drivingHoursBeforeEndOfWorkDay number
      The remaining driving hours before the work day ends
    • timeRemaining number
      The remaining driving time after a shift
    • rule string
      The FMCSA HOS rule to follow
      Possible values:
      "60" "70"
  • getPathPolygon boolean
    A flag indicating whether or not to include path polygon in the response
  • getVehicleStops boolean
    A flag indicating whether or not to include vehicle stops in the response
  • optimizeWaypoints boolean
    A 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
  • allowFerry boolean
    A flag indicating whether or not to include ferry routes in the trip if available. By default, only land routes are provided.

Response Schema

  • status string
    Possible values: okerror
  • summary object
    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.
    • route array
      The list of points along the current route
      • location object
        The geographic coordinates for the given location
        • lat number
          The latitude of the coordinate
        • lng number
          The longitude of the coordinate
      • address string
        The 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)
    • countries array
      The list of countries that the current route spans
      • string string
    • currency string
      The currency unit used for calculations
    • vehicleType string
      The vehicle type used for calculations. For more information about vehicle types, click here
      Possible values:
      2AxlesAuto 3AxlesAuto 4AxlesAuto 2AxlesDualTire 3AxlesDualTire 4AxlesDualTire 2AxlesEV 3AxlesEV 4AxlesEV 2AxlesTNC 2AxlesTNCPool 2AxlesTaxi 2AxlesTaxiPool Carpool2 Carpool3 2AxlesTruck 3AxlesTruck 4AxlesTruck 5AxlesTruck 6AxlesTruck 7AxlesTruck 8AxlesTruck 9AxlesTruck 2AxlesBus 3AxlesBus 2AxlesMotorcycle 3AxlesMotorcycle 2AxlesRv 3AxlesRv 4AxlesRv
    • vehicleDescription string
      The provided vehicle description
    • fuelPrice object
      Fuel price from request or the default fuel price (including currency)
      • value number
        The cost of fuel in a specified unit
      • currency string
        The currency in which the fuel cost is represented
      • units string
        Measurement unit for fuel cost
      • fuelUnit string
        Measurement unit for fuel
    • fuelEfficiency object
      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.
      • city number
        Fuel efficiency of the vehicle in cities
      • hwy number
        Fuel efficiency of the vehicle on highways
      • units string
        Measurement units for efficiency values
      • fuelUnit string
        Measurement unit for fuel value
    • units object
      A summary of the measurement units used for calculations
      • currencyUnit string
        The currency unit specified in the request
      • fuelEfficiencyUnit string
        The fuel efficiency units specified in the request
      • fuelUnit string
        The fuel units specified in the request
    • departureTime string
      The 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)
    • share object
      Shareable parameters for this response
      • name string
      • prefix string
      • uuid string
      • timestamp string
      • client string
    • source string
      The map provider source used to get the list of possible routes
  • routes array
    A list of possible routes for the given trip
    • summary object
      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.
      • hasTolls boolean
        Value indicating whether there are any tolls along the current route
      • hasExpressTolls boolean
        Value indicating whether there are any express tolls along the current route
      • diffs object
        The difference in overall cost between the given trip and the cheapest and fastest trips
        • cheapest number
        • fastest number
      • url string
        URL for navigation for the current route through Google Maps
      • distance object
        The total distance of the current route
        • text string
          The display value for the distance
        • metric string
          The measurement unit for the distance
        • value number
          The actual distance value
      • duration object
        The estimated travel duration of the current route
        • text string
          The display value for the duration
        • value number
          The actual duration value
      • name string
        The name of the current route
      • note array
    • costs object
      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
      • tagAndCash number
        The minimum cost between tag and cash
      • minimumTollCost number
        The minimum total cost
      • fuel number
        The calculated cost for fuel
      • tag number
        The calculated toll cost for tags
      • cash number
        The calculated cost for cash
      • prepaidCard number
        The calculated cost for prepaid cards
      • licensePlate number
        The calculated license cost for plate
    • tolls array
      Array of Barrier (object) or TicketSystem1 (object) or TicketSystem2 (object) or TicketSystem3 (object)
    • directions array
      • position object
        • latitude number
        • longitude number
      • maneuver string
      • html_instructions string
      • distance number
      • duration number
      • note array
    • hos array
      • summary object
        • total_drive_duration object
          • text string
          • value number
        • total_break_duration object
          • text string
          • value number
        • total_duration object
          • text string
          • value number
        • total_distance object
          • text string
          • metric string
          • value number
      • breakpoints array
      • stops array
        • additionalServices string
        • amenities string
        • businessesName string
        • city string
        • contactName string
        • fax string
        • fuelLanes number
        • highway string
        • latitude number
        • longitude number
        • parkingSpots string
        • paymentMethods string
        • phone1 string
        • phone2 string
        • phone3 string
        • postalCode string
        • restIndex string
        • showers number
        • state string
        • stopId number
        • streetAddress string
        • truckServiceBays number
        • type string
        • webAddress string
      • data object
        • instruction string
        • duration object
          • text string
          • value number
        • distance object
          • text string
          • metric string
          • value number
    • territoryMileage array
      • territory object
        • name string
        • code string
        • type string
      • distance object
        • text string
        • metric number
        • value number
      • trafficTime string
    • polyline string
      A base64 encoded linestring representing the current route
    • vehicleStops array
      Details of vehicle stops located along the route.
      • stops array
        List of vehicle stops located along the route.
        • stopId number
          Unique identifier for the vehicle stop.
        • lat number
          Latitude of the vehicle stop location.
        • lng number
          Longitude of the vehicle stop location.
        • distance object
          Distance from the start of the route.
          • text string
          • metric string
          • value number
        • geometry object
          Geometry details of the vehicle stop location.
          • coordinates array
            Coordinates of the vehicle stop location in [longitude, latitude] format, e.g., [-87.010376, 41.448527].
            • number number
          • type string
            Geometry type.
            Possible values:
            Point
        • stopType string
          Type of the vehicle stop (e.g., 'fuel').
        • stopName string
          Name of the vehicle stop.
        • address string
          Address of the vehicle stop.
        • city string
          City where the vehicle stop is located.
        • stateProvince string
          State or Province where the vehicle stop is located.
        • country string
          Country where the vehicle stop is located.
        • postalCode string
          Postal code of the vehicle stop location.
        • stopCompanyName string
          Name of the company operating the vehicle stop.
        • interstate string
          Interstate highway where the vehicle stop is located.
        • phone string
          Phone number of the vehicle stop.
        • fax string
          Fax number of the vehicle stop.
        • totalParkingSpaces number
          Total number of parking spaces available at the vehicle stop.
        • primeParkingSpaces number
          Number of prime parking spaces available at the vehicle stop.
        • dieselLanes number
          Number of diesel lanes available at the vehicle stop.
        • defLanes number
          Number of DEF (Diesel Exhaust Fluid) lanes available at the vehicle stop.
        • showerCount number
          Number of showers available at the vehicle stop.
        • hasCatScale boolean
          Indicates if the vehicle stop has a CAT Scale.
        • amenities string
          Amenities available at the vehicle stop.
        • restaurants string
          Types of restaurants available at the vehicle stop.
        • metaData object
          Meta data related to fuel prices and currency.
          • fuelRegularPrice number
            Price of regular fuel.
          • fuelMidgradePrice number
            Price of midgrade fuel.
          • fuelPremiumPrice number
            Price of premium fuel.
          • fuelDieselPrice number
            Price of diesel fuel.
          • currency string
            Currency used for the fuel prices.
      • start object
        Details about the starting point of the segment of the route.