Note: The independent endpoint is only recommended if you use third-party routers. If you use the Trip API, you can get the tolls in the same request.

In this example, we have a simple route that passes through the Tres Marías toll booth in Mexico. We will use the standalone endpoint to calculate the tolls.

The route was generated by Google’s Routes API and is in polyline format.

Request

Since the route was generated by a Google API, you will need to set the parameter source to GMAPS. If the route was generated by the Trip API, or some other service, you will not need to provide the parameter source.

In billing, we will define it as FREE_FLOW, to obtain the return of both tolls and gantries. If the value is DEFAULT, only conventional tolls will be returned.

The parameter legs is an array of objects where each object represents a section of the route. In each leg, we must define the parameter points , which contains the coordinates that make up the route. In this case, we will have only one leg that corresponds to the entire route. The route coordinates are in string format, encoded as polyline.

In each object contained in legs, we will need to inform the type of vehicle used for that section. In the parameter vehicleType, we will define that the route will be carried out with a truck with four double axles, for this we will use the value TRUCK_WITH_FOUR_DOUBLE_AXLES. In parameter condition, we will inform billingType as NORMAL and period as NORMAL.

Below is the full request:

{
    "source": "GMAPS",
    "billing": "FREE_FLOW",
    "legs": [
        {
            "vehicleType": "TRUCK_WITH_FOUR_DOUBLE_AXLES",
            "condition": {
                "period": "NORMAL",
                "billingType": "NORMAL"
            },
            "points": "gzwtBnkk|Q_EoAGqDyAKiIh@cID_HcGiA}H_@iLCcHd@wMhAqSTuGbAcO|Dak@vBcJ|FiJtZyTfJ{GrHkExD{BrBEbAZfAxAdLlRbO~WhFtGrJ|FfYzOvGdCfDWpFcCdPgGrFG~H~AtWjG~G~AnD?fB_@~CyBrJiMnTmYvJ}LlEuB~CSpJ\\hEeAvGoGnFsHhBiFbBqExCyChGuF~GaDrG{@rGgBtUuJdNiFtOwCzDp@zBdCzAzBjBnAjD`@vKQfCqA`CqE`AcFeA}DwBgEAcDbBmClCkC`@_Dm@iCqCkBaFJkFYwFmE}B{FcBaHTgDjBwCpMsH~EaB~LVrE~@zCvEnAbAfB^dF[nDh@hFpEjPhKbEhArIZ|Hs@tC~@vIrHdIhDlIj@nI@~DfAfB`BvAvD@pGo@`Qf@|F`Sjh@`InTzCnLhAtCrBdClExB~HTdOwExRuG|KsCvRuA~HeC`a@gVxJaFtCObI`@~FhA~CvCbBtFdCzFzDbCxBd@zDAzOOnCj@hFfDfMrJhLtF|g@xQfg@nQbTvHpFrBrD`CtCfDvIpOpOrMlb@b\\|NdLjInFxc@fLzKzF|KvGzIdGlCpD|JxZ`ElMnFtKtWnf@dTt`@jKrRxDhEli@na@dE|FdBpFnDxe@rAzPtBnF~EdE|KbDvj@tOvCzAvGrF|GhFpE|@|DUfHsAxE\\bG`CtFXlHi@bDf@hGbElJlGbJtB~JWzNcCpGiDrFaJ|EqHlKwJvUmThKmMhC}BhEsAlJ_DlFuE`J_JpB}EpFuTGwFiB_LFeElBuKWyFcDiLi@iK]qTbEcN|EkM|CoDxNsHrH{DtCoEl@{EqA_Zk@sG}A}HiOs_@m@uFnDqPjDaOGiND}MhBkEhEeDzCyCdAgCfDoKlGyIpAgF@{Fm@yLbAqFfF{KxAwJr@cK}CuSv@cKSiG_EyKwAuFWsLDaPt@eA|Ak@rCh@fApB?bBkDbI@rGdUxi@~HtMtA|E`Bhg@vDl`@lAfKdBlFbJxQxChLdGjZtL`[|BzSjZhm@hEhEdMnIhBpC`BlGtE~PxJbJdNzKfDtDdApC`ElMrSjYxQxV|AnFj@tHpBrc@gA~QRjE~AtHhAlFtAxCxAvAnCnAfPh@jFtA~CbCdBrCjAxEFxEC|Nd@xCnBbDnCzAbC`@vEB|DyBdD{Dx@A`Ar@b@xD\\xAvKx[lCrJ\\Vh@Slw@iGvc@mCNIDIhTmEfScG|CoAi@UeCGYs@rAcC`@o@UOwBd@yC|AoJvBv@vDHb@RhAcAX}@VkBf@"
        }
    ]
}

Response

In the response, we will have the following fields:

• totalCost – Total toll value on the entire route;
• legs – Array of objects where each object represents a section of the route. Each leg of the response corresponds to a leg of the request. The following fields will be returned in each object:
  • tolls – Object with the values ​​and information for each toll in the corresponding section. Each object returned in tolls represents a toll and will contain the following information:
    • name – Toll name;
    • address – Toll address;
    • city – Toll city;
    • state – Object containing the name of the state (name) and its acronym (code);
    • country – Toll country;
    • concession – Concessionaire responsible for the toll;
    • coordinates – Coordinates (latitude and longitude) of the tollbooth;
    • price – Price per toll;
    • serviceTypes – Array with codes for integration with automatic payment systems. Currently only available in Brazil:
      • serviceId – Code for integration;
      • name – Description of the service code.
  • legTotalCost – Total toll value for the section;
  • vehicleType – Type of vehicle considered for the section;
  • calculationDate – Date and time considered for the section, in timestamp format;
  • condition – If the parameter condition is used in the request, this object will be returned containing which billingType and period were considered for the leg.

The full response can be found below:

{
    "legs": [
        {
            "tolls": [
                {
                    "id": "1910",
                    "name": "Pórtico - Cuicuilco",
                    "address": "Anillo Periférico Boulevard Adolfo López Mateos",
                    "city": "Ciudad de México",
                    "state": {
                        "name": "Ciudad de México",
                        "code": "Ciudad de México"
                    },
                    "country": "México",
                    "concession": " ",
                    "direction": "EAST",
                    "coordinates": {
                        "latitude": 19.302997,
                        "longitude": -99.176205
                    },
                    "serviceTypes": [],
                    "price": 0.00
                },
                {
                    "id": "1909",
                    "name": "Pórtico - Caminero (insurgentes)",
                    "address": "Anillo Periférico",
                    "city": "Ciudad de México",
                    "state": {
                        "name": "Ciudad de México",
                        "code": "Ciudad de México"
                    },
                    "country": "México",
                    "concession": " ",
                    "direction": "EAST",
                    "coordinates": {
                        "latitude": 19.301797,
                        "longitude": -99.166269
                    },
                    "serviceTypes": [],
                    "price": 0.00
                },
                {
                    "id": "2602",
                    "name": "Pórtico - Viaducto Tlalpan (V.E.T.)",
                    "address": "Ciudad de México - Cuernavaca",
                    "city": "Ciudad de México",
                    "state": {
                        "name": "Ciudad de México",
                        "code": "Ciudad de México"
                    },
                    "country": "México",
                    "concession": " ",
                    "direction": "SOUTH",
                    "coordinates": {
                        "latitude": 19.23586718,
                        "longitude": -99.14526105
                    },
                    "serviceTypes": [],
                    "price": 0.00
                },
                {
                    "id": "1878",
                    "name": "Caseta - Tres Marías",
                    "address": "Autopista México - Cuernavaca",
                    "city": "Tres Marías",
                    "state": {
                        "name": "Morelos",
                        "code": "Morelos"
                    },
                    "country": "México",
                    "concession": "CAPUFE",
                    "direction": "WEST",
                    "coordinates": {
                        "latitude": 19.05632,
                        "longitude": -99.241111
                    },
                    "serviceTypes": [],
                    "price": 111.00
                }
            ],
            "legTotalCost": 111.00,
            "vehicleType": "TRUCK_WITH_FOUR_DOUBLE_AXLES",
            "condition": {
                "billingType": "NORMAL",
                "period": "NORMAL"
            },
            "calculationDate": 1743709167209
        }
    ],
    "totalCost": 111.00
}