This section guides you through the steps to construct a complete request for the routing API.
Each request is composed of multiple blocks, each defining a key aspect of the route calculation.
A standard request is a JSON object that includes at minimum:
{
"destinations": [ ... ],
"routingVehicleProfile": { ... }
}List of GPS coordinates (latitude / longitude) forming the route. The first point is the starting point, the last one is the destination, and any others are intermediate waypoints.
"destinations": [
{
"coordinateSat": {
"lon": 2.38261,
"lat": 48.85356
}
},
{
"coordinateSat": {
"lon": 4.35631,
"lat": 50.84531
}
}
]Defines the vehicle type, transport mode, and physical or legal characteristics used during routing.
This includes parameters like height, width, length, weight, and axle weight in centimeters.
Example:
{
"routingVehicleProfile": {
"transportMode": "CAR",
"routingVehicleFeature": {
"height": "190",
"width": "230",
"length": "1875",
"weight": "35",
"axleWeight": "10"
}
}Specifies route preferences such as avoiding tolls, ferries, or motorways.
Example:
"routingCriterias": ["AVOID_TOLLS", "AVOID_FERRIES"]Enables additional output features such as polyline geometry.
Example:
"options": ["POLYLINE"]{
"destinations": [
{
"coordinateSat": {
"lon": 2.38261,
"lat": 48.85356
}
},
{
"coordinateSat": {
"lon": 4.35631,
"lat": 50.84531
}
}
],
"options": [
"POLYLINE"
],
"routingCriterias": [
"AVOID_FERRIES",
"AVOID_TOLLS"
],
"routingVehicleProfile": {
"transportMode": "CAR",
"routingVehicleFeature": {
"height": "190",
"width": "230",
"length": "1875",
"weight": "35",
"axleWeight": "10"
}
}
}