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:

1. Simple charging, depending only on the type of vehicle and number of axles.
2. Variable according to the origin and destination of the route to be taken.

In the latter case, in addition to the toll plaza details, the API will return in the response all the available fares for their respective sections.

In the following example, we have a route with a two-axle truck that passes through the Ruiz tollbooth in Mexico.

{
    "calculationMode": "THE_FASTEST",
    "points": [
        {
            "siteId": "p1",
            "latitude": 21.952688,
            "longitude": -105.116793
        },
        {
            "siteId": "p2",
            "latitude": 21.950404,
            "longitude": -105.114812
        }
    ],
    "toll": {
        "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES"
    }
}

The response will be returned in JSON format.

As in the previous examples, tollCosts shows the total value of tolls on the entire route. In each leg an object tollCalculation will be returned containing an object tolls with the values and information of each toll on the corresponding stretch, and legTotalCost which shows the total value of tolls on that stretch.

Inside each object at tolls we will have the information for each toll, with the following differences:

• price – Normal toll value (in this case it will be the same as the first option Origin – Destination);
• conditions – Array with all the toll’s conditional values. In the case of this example, we have the following information:
  • billingsType – Type of toll collection. Possible values: [NORMAL, TAG];
  • routes – Stretch of origin and destination defined by the concessionaire responsible for the toll plaza. In this example we will have 3 options: Entronque San Blas - Rosamorada, Estación Yago - Rosamorada e Entronque San Blas - Estación Ruiz
  • value – Value of the toll in local currency.

The full response is below:

{
    "id": "63dbfdd4e52c9c19635a68bd",
    "clientId": "maplink",
    "totalDistance": 326,
    "totalNominalDuration": 14,
    "averageSpeed": 79.98,
    "tollCosts": 300.00,
    "legs": [
        {
            "distance": 326,
            "nominalDuration": 14,
            "averageSpeed": 79.98,
            "points": "cs~dCdsq`S`DgCFGHGrGsF",
            "tollCalculation": {
                "tolls": [
                    {
                        "id": "2296",
                        "name": "Peaje - Ruíz",
                        "address": "",
                        "city": "Ruiz",
                        "state": {
                            "name": "Nayarit",
                            "code": "Nayarit"
                        },
                        "country": "México",
                        "concession": "Tepic - Villa Unión",
                        "direction": "SOUTH",
                        "coordinates": {
                            "latitude": 21.951853461673615,
                            "longitude": -105.11594373835344
                        },
                        "serviceTypes": [],
                        "price": 220.00,
                        "conditions": [
                            {
                                "billingsType": [
                                    "NORMAL"
                                ],
                                "routes": [
                                    "Entronque San Blas - Rosamorada"
                                ],
                                "value": 220.00
                            },
                            {
                                "billingsType": [
                                    "NORMAL"
                                ],
                                "routes": [
                                    "Estación Yago - Rosamorada"
                                ],
                                "value": 170.00
                            },
                            {
                                "billingsType": [
                                    "NORMAL"
                                ],
                                "routes": [
                                    "Entronque San Blas - Estación Ruiz"
                                ],
                                "value": 160.00
                            }
                        ]
                    }
                ],
                "legTotalCost": 220.00
            }
        }
    ],
    "crossedBorders": [],
    "source": "MAPLINK"
}