Introduction
The Trip API is a Restful API capable of calculating the best route between locations taking into account logistical rules, such as: vehicle specification, road speed preference, r [...]
Trip
Posts
Building requests for the Trip 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 Example: Optional parameters Below is an example with all the optional parameters:
Change return type of route coordinates
To reduce the size of the response and increase performance, especially on longer routes, you can use the pointsMode parameter to change how the coordinates should be returned. poi [...]
Storing routes with Route Storage
Route Storage is a new feature that can be used in conjunction with the Trip API to store fixed route solutions for longer. By default, routes are stored for 7 days. With Route Sto [...]
Calculating tolls on stretches with varying axles
In addition to allowing tolls to be calculated on the route, the Trip API allows different types of vehicles to be specified for specific sections of the route. Ideal for routes th [...]
Example 1 – Simple route
In this example, we have a simple route between two points using the calculation mode THE_FASTEST, which will return the fastest route. The generated route can be seen on the map b [...]
Example 2 – Route with multiple stops
In the example below, we’re going to generate a route with 10 intermediate stopping points, in addition to the origin and destination points. All points are declared in the p [...]
Example 3 – Route bypassing restricted areas
When there are restriction areas registered in the Restriction Zones API, you can use them as arguments in the restrictionZones parameter. The route will then deviate from these ar [...]
Example 4 – Route with data of cities and points
This feature is currently only available for routes located in Brazil. The request below asks for a route between Campo Grande – MS and Parati – RJ. We want Trip API to [...]
Example 5 – Route with points of interest
In this example, we have a route between Campo Grande – MS and Rio de Janeiro – RJ, where we want to identify all the checkpoints on the route. To do this, add the para [...]
Example 6 – Obtain detailed rotogram of the route
The Trip API can return, in addition to the complete route coordinates, a complete route diagram of the requested route. The rotogram consists of a series of textual instructions t [...]
