Introduction
The Toll API is a Restful API capable of returning data and the values of the tolls on the route. With Toll API you can:
Toll
Posts
Service coverage and particularities
Toll API covers the calculation of tolls in the following countries: Argentina, Brazil, Chile, Colombia and Mexico. The operation and method of charging vary according to the count [...]
Building requests for the Toll API
Before you can start using the API, you will need to obtain the authentication token. The following headers will be required, where the word token must be replaced by the token obt [...]
List of parameters
Mandatory parameters The following parameters are required: Accepted coordinate formats The following formats are supported as input for the coordinates in the parameter points: Ob [...]
Example 1 – Independent endpoint
In this example, we have a simple route that passes through the Itaquaquecetuba tollbooth. We will use the independent endpoint to calculate the tolls. The parameter legs is an arr [...]
Example 2 – Simple tolls
In this and the next examples, we will use integration with the Trip API. In the request below, a route is requested between Campo Grande-MS and Parati-RJ with the toll values for [...]
Example 3 – Discounted tolls through automatic payment
Some toll plazas offer a percentage discount for users who use automatic payment methods, known as TAG or TelePeaje. In Brazil, this percentage is 5% off and is available to only a [...]
Example 4 – Tolls with hourly rates
Some toll plazas, especially in Argentina and Chile, have prices that vary according to the day, time or season of the year the route is being traveled. In Argentina, for example, [...]
Example 5 – Tolls with rates depending on origin and destination (Mexico)
This example is specific to routes in Mexico, where depending on the concessionaire the criteria for calculating the fare could be one of the options below: In the latter case, in [...]
Status Codes – Toll
Below is the table with the status codes for each endpoint available in the Toll API: Code Method Endpoint Description 200 POST https://api.maplink.global/toll/v1/calculations OK ( [...]
Error messages – Toll
The following table shows all the error messages that can be returned by the API in the response body: Error code Message Description VALIDATION_FAILED ou VALIDATION_ERROR { messag [...]
