↑
Toll

Ejemplo – Facturación por tramos

Este ejemplo se aplica a carriles donde el peaje se cobra por tramo, es decir, combinando un peaje de entrada y uno de salida. Por lo tanto, el importe a devolver será proporcional a los kilómetros recorridos en el carril.

Para estos casos, el campo type devolverá las siguientes opciones:

  • ENTRY_GANTRY – Pórticos de entrada;
  • EXIT_GANTRY – Pórticos de saída.

Los valores, los valores condicionales y los códigos de integración siempre se devolverán en los pórticos de salida, con una referencia al pórtico de entrada correspondiente, como se muestra en los ejemplos siguientes.

Nota: Si la ruta solo pasa por el pórtico de salida, sin ningún pórtico de entrada como referencia, el valor y el código de integración que se devolverán serán los del tramo con el valor más alto posible.

Solicitud

En la solicitud, será necesario agregar el parámetro billing con el valor FREE_FLOW para que se devuelvan las puertas de enlace. En el siguiente ejemplo, la ruta pasa por una puerta de entrada y una de salida, ubicadas en la autopista Presidente Dutra, Brasil.

Solicitud con endpoint independiente

{
    "legs": [
        {
            "vehicleType": "CAR",
            "points": "`|_nChbjzGdDjK`AvApCrIp\\veAlQtj@jI~WxCjJbS`o@zAvEl@tBFb@x@nCVbArApE"
        }
    ],
    "billing": "FREE_FLOW"
}

Solicitud con Trip API

{
  "calculationMode": "THE_FASTEST",
  "points": [
    {
      "siteId": "PFE001",
      "latitude": -23.4337710259116,
      "longitude": -46.42357024290983
    },
    {
      "siteId": "PFS001",
      "latitude": -23.450549018021594,
      "longitude": -46.463470746954336
    }
  ],
  "toll": {
    "vehicleType": "CAR",
    "billing": "FREE_FLOW"
  }
}

Respuesta

Al igual que en los ejemplos anteriores, en tollCosts se muestra el valor total de los peajes de toda la ruta. En cada leg, se devolverá un objeto tollCalculation que contiene un objeto tolls con los valores y la información de cada peaje en el segmento correspondiente, y legTotalCost, que muestra el valor total de los peajes en ese tramo.

En cada objeto de tolls, tendremos información de cada peaje, con las siguientes diferencias:

  • Para el pórtico de entrada, ENTRY_GANTRY, el valor devuelto en price siempre será 0. Tampoco se devolverá ningún código de integración en el campo serviceTypes.
  • Para el pórtico de salida, EXIT_GANTRY, los valores y códigos de integración se devolverán normalmente. Estos datos no se refieren al pórtico en sí, sino al tramo comprendido entre los pórticos de entrada y salida.

También se devolverán los siguientes campos:

  • entryGantryId – ID del pórtico de entrada correspondiente;
  • entryGantryName – Nombre del pórtico de entrada correspondiente;
  • segmentId – ID del tramo compuesto por los pórticos de entrada y salida. Corresponde a los ID de los pórticos concatenados.

Respuesta con endpoint independiente

{
    "legs": [
        {
            "tolls": [
                {
                    "id": "3700",
                    "type": "ENTRY_GANTRY",
                    "name": "PFE001 - Jd. Maria Dirce (km 211)",
                    "address": "Jd. Maria Dirce (km 211)",
                    "city": "Guarulhos",
                    "state": {
                        "name": "SP",
                        "code": "SP"
                    },
                    "country": "Brasil",
                    "concession": "CCR RioSP",
                    "direction": "SOUTH",
                    "coordinates": {
                        "latitude": -23.43484679,
                        "longitude": -46.42587454
                    },
                    "serviceTypes": [],
                    "price": 0
                },
                {
                    "id": "3709",
                    "type": "EXIT_GANTRY",
                    "name": "PFS001 - Aeroporto (km 215)",
                    "address": "Aeroporto (km 215)",
                    "city": "Guarulhos",
                    "state": {
                        "name": "SP",
                        "code": "SP"
                    },
                    "country": "Brasil",
                    "concession": "CCR RioSP",
                    "direction": "SOUTHWEST",
                    "coordinates": {
                        "latitude": -23.45011179,
                        "longitude": -46.46236207
                    },
                    "serviceTypes": [
                        {
                            "serviceId": "1148",
                            "name": "Via Facil"
                        }
                    ],
                    "price": 1.54,
                    "segmentId": "37003709",
                    "entryGantryId": "3700",
                    "entryGantryName": "PFE001 - Jd. Maria Dirce (km 211)"
                }
            ],
            "legTotalCost": 1.54,
            "vehicleType": "CAR",
            "calculationDate": 1765906825592
        }
    ],
    "totalCost": 1.54
}

Respuesta con Trip API

{
    "id": "6941b7a2ad10b369362d622a",
    "clientId": "maplink",
    "totalDistance": 4480,
    "totalNominalDuration": 184,
    "averageSpeed": 75.15,
    "tollCosts": 1.54,
    "legs": [
        {
            "distance": 4479,
            "nominalDuration": 184,
            "averageSpeed": 75.15,
            "points": "`|_nChbjzGdDjK`AvApCrIp\\veAlQtj@jI~WxCjJbS`o@zAvEl@tBFb@x@nCVbArApE",
            "tollCalculation": {
                "tolls": [
                    {
                        "id": "3700",
                        "type": "ENTRY_GANTRY",
                        "name": "PFE001 - Jd. Maria Dirce (km 211)",
                        "address": "Jd. Maria Dirce (km 211)",
                        "city": "Guarulhos",
                        "state": {
                            "name": "SP",
                            "code": "SP"
                        },
                        "country": "Brasil",
                        "concession": "CCR RioSP",
                        "direction": "SOUTH",
                        "coordinates": {
                            "latitude": -23.43484679,
                            "longitude": -46.42587454
                        },
                        "serviceTypes": [],
                        "price": 0
                    },
                    {
                        "id": "3709",
                        "type": "EXIT_GANTRY",
                        "name": "PFS001 - Aeroporto (km 215)",
                        "address": "Aeroporto (km 215)",
                        "city": "Guarulhos",
                        "state": {
                            "name": "SP",
                            "code": "SP"
                        },
                        "country": "Brasil",
                        "concession": "CCR RioSP",
                        "direction": "SOUTHWEST",
                        "coordinates": {
                            "latitude": -23.45011179,
                            "longitude": -46.46236207
                        },
                        "serviceTypes": [
                            {
                                "serviceId": "1148",
                                "name": "Via Facil"
                            }
                        ],
                        "price": 1.54,
                        "segmentId": "37003709",
                        "entryGantryId": "3700",
                        "entryGantryName": "PFE001 - Jd. Maria Dirce (km 211)"
                    }
                ],
                "legTotalCost": 1.54,
                "vehicleType": "CAR",
                "calculationDate": 1765914530047
            },
            "arrivalSiteId": "PFS001",
            "departureSiteId": "PFE001"
        }
    ],
    "source": "MAPLINK",
    "createdAt": 1765914530046,
    "expiryIn": 1766519330046
}

Ejemplo Chile – Pórticos Autopista Vespucio Oriente

El siguiente ejemplo corresponde a una ruta que pasa por la Autopista Vespucio Oriente, en Chile. Los peajes en esta autopista también se cobran mediante pórticos de entrada y salida. La ruta a continuación accede a la autopista por el pórtico de entrada de Bilbao y sale por el pórtico de salida de Los Militares.

Ruta sobre la Autopista Vespucio Oriente, entre los pórticos de Bilbao y Los Militares.

La solicitud completa se puede encontrar a continuación:

{
    "calculationMode": "THE_FASTEST",
    "points": [
        {
            "siteId": "Entrada",
            "latitude": -33.43082390803889, 
            "longitude":-70.57453931798061
        },
        {
            "siteId": "Salida",
            "latitude": -33.41139939529261, 
            "longitude": -70.5802398377345
        }
    ],
    "toll": {
        "vehicleType": "CAR",
        "billing": "FREE_FLOW"
    }
}

La respuesta completa se puede encontrar a continuación:

{
    "id": "6941a837ad10b369362d5acb",
    "clientId": "maplink",
    "totalDistance": 2611,
    "totalNominalDuration": 174,
    "averageSpeed": 50.40,
    "tollCosts": 222.00,
    "legs": [
        {
            "distance": 2610,
            "nominalDuration": 174,
            "averageSpeed": 50.4,
            "points": "rm`kExawmL]LWDYDmAJeA@]B[DkGbAg@Hi@Pa@Vu@j@}EtE{NhNgBrAwMfJ}BxAmAn@eGdCmMrEoHrBSFe@@e@Ae@IQGc@UWWKQcA{B_BwESk@s@}Aw@yAgBsD",
            "tollCalculation": {
                "tolls": [
                    {
                        "id": "3570",
                        "type": "ENTRY_GANTRY",
                        "name": "Pórtico - Entrada - Bilbao",
                        "address": "Autopista Vespucio Oriente",
                        "city": " ",
                        "state": {
                            "name": " ",
                            "code": " "
                        },
                        "country": "Chile",
                        "concession": "Autopista Vespucio Oriente",
                        "direction": "NORTH",
                        "coordinates": {
                            "latitude": -33.43067656,
                            "longitude": -70.57460313
                        },
                        "serviceTypes": [],
                        "price": 0
                    },
                    {
                        "id": "3566",
                        "type": "EXIT_GANTRY",
                        "name": "Pórtico - Salida 1: Los Militares",
                        "address": "Los Militares",
                        "city": " ",
                        "state": {
                            "name": " ",
                            "code": " "
                        },
                        "country": "Chile",
                        "concession": "Autopista Vespucio Oriente",
                        "direction": "NORTHEAST",
                        "coordinates": {
                            "latitude": -33.41151269,
                            "longitude": -70.58041115
                        },
                        "serviceTypes": [],
                        "price": 222.00,
                        "segmentId": "35703566",
                        "entryGantryId": "3570",
                        "entryGantryName": "Pórtico - Entrada - Bilbao"
                    }
                ],
                "legTotalCost": 222.00,
                "vehicleType": "CAR",
                "calculationDate": 1765910583099
            },
            "arrivalSiteId": "Salida",
            "departureSiteId": "Entrada"
        }
    ],
    "source": "MAPLINK",
    "createdAt": 1765910583096,
    "expiryIn": 1766515383096
}

Ejemplo México – Autopista Toluca – Naucalpan

Algunas autopistas en México operan con un sistema cerrado, donde el monto a pagar se determina según la distancia recorrida. Este control se realiza mediante pórticos o casetas de peaje en la entrada y la salida.

Sistema de facturación cerrado.

El siguiente ejemplo corresponde a una ruta en la autopista Toluca-Naucalpan, operada por la concesionaria Autovan, con dirección a Chamapa. La ruta pasa por la caseta de peaje de Ayotuxco y termina en la caseta de Chamapa. El importe a pagar en la caseta de Chamapa se determina según la entrada anterior a la caseta.

Ruta sobre la Autopista Toluca – Naucalpan, entre las casetas de Ayotuxco y Chamapa.

La solicitud completa para este ejemplo se encuentra a continuación:

{
    "calculationMode": "THE_FASTEST",
    "points": [
        {
            "siteId": "Entrada",
            "latitude": 19.399862645037803,
            "longitude": -99.38104539680072
        },
        {
            "siteId": "Salida",
            "latitude": 19.43470773197662, 
            "longitude": -99.30359266871034
        }
    ],
    "toll": {
        "vehicleType": "CAR",
        "billing": "FREE_FLOW"
    }
}

La respuesta completa está a continuación:

{
    "id": "6941b467ad10b369362d6093",
    "clientId": "maplink",
    "totalDistance": 12516,
    "totalNominalDuration": 567,
    "averageSpeed": 62.55,
    "tollCosts": 68.00,
    "legs": [
        {
            "distance": 12515,
            "nominalDuration": 567,
            "averageSpeed": 62.55,
            "points": "c`luBpjq}QEUyA{DQi@i@wBA}EEqAIqAIq@Io@Kg@Oi@[_A[}@Sc@We@_@k@kCuDwBiCgBaBg@c@k@_@kAk@k@Wo@UaBc@mGoAaNaCqB_@iB_@aD_AgBs@mCoAiAk@oAk@}@]{@ScASuAOuAGyDOaAKsAYyAc@}@e@m@_@o@e@e@e@i@m@{@yA[o@Wu@W}@Ka@K{@KgAA}A@s@JsERsGDgEOkBIo@YuAe@uA}@yBsCuGo@cBw@}Cw@oDu@cEq@oDw@mDe@aCm@}CYcA]aA[{@_A_BqEsHWq@_@uAeA_Fs@gCe@aC]iAm@}A_@g@_BiBYY[W_@Ua@Sc@OeA]e@KoAUoAMg@Ci@AmA?k@?wEMwEAk@Ci@I_@EcBc@WIy@a@i@[i@_@g@c@y@_A]e@Yi@_@q@Ws@Ww@Qu@YsBYcEi@uEe@_FGeACwA?_AFaAF_@N_AJ_@JYXu@Ra@Zg@Ze@`AgAb@a@t@q@\\U^U`@S^S`@O`@MfAWfAOdAIfAAfADb@Dl@HpAV`HxBdBd@^Hb@Hb@Fb@Bd@Bb@@b@Ad@Ab@Cb@Gb@Gd@Ib@M^M`Aa@`Ae@^Uz@o@t@u@\\c@R]Va@R_@Pa@Na@^gA|AiL~@qJZeDNaEBcA@aCDkKJgBRgBNq@Lq@Po@d@_BjAaDjBsE`@kA^iAToAHc@Fe@HmA@kAAkACc@IeAKc@W_A[cAQ_@k@iAs@oAaCqCoA}A{BeCaAqAa@q@u@aBSi@iAqD{@}Be@gAUg@Ye@]i@g@k@k@i@}@u@q@a@{@a@q@Uk@Qw@Oy@O{BUmFe@kAOuHq@yCYmD[_BU_C_@gDa@",
            "tollCalculation": {
                "tolls": [
                    {
                        "id": "2723",
                        "type": "ENTRY_GANTRY",
                        "name": "Caseta - Ayotuxco",
                        "address": "Autopista Toluca - Naucalpan  KM 25+092",
                        "city": " ",
                        "state": {
                            "name": "Estado de México",
                            "code": "Estado de México"
                        },
                        "country": "México",
                        "concession": "Autovan",
                        "direction": "NORTHEAST",
                        "coordinates": {
                            "latitude": 19.39990472,
                            "longitude": -99.38092579
                        },
                        "serviceTypes": [],
                        "price": 0
                    },
                    {
                        "id": "1963",
                        "type": "EXIT_GANTRY",
                        "name": "Caseta - Chamapa",
                        "address": "Autopista Toluca - Naucalpan",
                        "city": "Ciudad de México",
                        "state": {
                            "name": "Estado de México",
                            "code": "Estado de México"
                        },
                        "country": "México",
                        "concession": "Autovan",
                        "direction": "NORTH",
                        "coordinates": {
                            "latitude": 19.4345158,
                            "longitude": -99.3035731
                        },
                        "serviceTypes": [],
                        "price": 68.00,
                        "segmentId": "27231963",
                        "entryGantryId": "2723",
                        "entryGantryName": "Caseta - Ayotuxco"
                    }
                ],
                "legTotalCost": 68.00,
                "vehicleType": "CAR",
                "calculationDate": 1765913703702
            },
            "arrivalSiteId": "Salida",
            "departureSiteId": "Entrada"
        }
    ],
    "source": "MAPLINK",
    "createdAt": 1765913703701,
    "expiryIn": 1766518503701
}

Ejemplo Brasil – Pórticos Autopista Presidente Dutra

El ejemplo a continuación corresponde a una ruta que atraviesa la Autopista Presidente Dutra, donde se han instalado pórticos de entrada y salida en las rampas de acceso al carril principal. La ruta accede al carril principal por el pórtico de entrada PFE001 y sale de la autopista por el pórtico de salida PFS002.

Ruta sobre la Autopista Presidente Dutra, entre los põrticos PFE001 y PFS002.

La solicitud completa se puede encontrar a continuación:

{
  "points": [
    {
      "siteId": "PFE001",
      "latitude": -23.4337710259116,
      "longitude": -46.42357024290983
    },
    {
      "siteId": "PFS002",
      "latitude": -23.496393062325655,
      "longitude": -46.55864556656767
    }
  ],
  "toll": {
    "vehicleType": "CAR",
    "billing": "FREE_FLOW"
  }
}

La respuesta se devolverá como en el siguiente ejemplo:

{
    "id": "693c7582ad10b369362c6eb4",
    "clientId": "maplink",
    "totalDistance": 15549,
    "totalNominalDuration": 638,
    "averageSpeed": 67.68,
    "tollCosts": 3.09,
    "legs": [
        {
            "distance": 15548,
            "nominalDuration": 638,
            "averageSpeed": 67.68,
            "points": "`|_nChbjzGdDjK`AvApCrIp\\veAlQtj@jI~WxCjJbS`o@zAvEl@tB`HnTvLb`@hC|HbOne@nD~KfHhU|Olj@hAhEjAtErBnIzCpL`D`M|E|QbIb[nA`FfBlIpBzJvDpQpBxIhB~GnAtDdCxGzAtDl@rApCpFrZhj@hJnPjd@hy@jRx]~MpUlL`R`I|LJf@dDhFxCzERb@N^D\\@\\A^C\\CNG\\MZ_@t@",
            "tollCalculation": {
                "tolls": [
                    {
                        "id": "3700",
                        "type": "ENTRY_GANTRY",
                        "name": "PFE001 - Jd. Maria Dirce (km 211)",
                        "address": "Jd. Maria Dirce (km 211)",
                        "city": "Guarulhos",
                        "state": {
                            "name": "SP",
                            "code": "SP"
                        },
                        "country": "Brasil",
                        "concession": "CCR RioSP",
                        "direction": "SOUTH",
                        "coordinates": {
                            "latitude": -23.43484679,
                            "longitude": -46.42587454
                        },
                        "serviceTypes": [],
                        "price": 0
                    },
                    {
                        "id": "3710",
                        "type": "EXIT_GANTRY",
                        "name": "PFS002 - Av. Aricanduva (km 226)",
                        "address": "Av. Aricanduva (km 226)",
                        "city": "Guarulhos",
                        "state": {
                            "name": "SP",
                            "code": "SP"
                        },
                        "country": "Brasil",
                        "concession": "CCR RioSP",
                        "direction": "SOUTHWEST",
                        "coordinates": {
                            "latitude": -23.49667945,
                            "longitude": -46.55789037
                        },
                        "serviceTypes": [
                            {
                                "serviceId": "1149",
                                "name": "Via Facil"
                            }
                        ],
                        "price": 3.09,
                        "segmentId": "37003710",
                        "entryGantryId": "3700",
                        "entryGantryName": "PFE001 - Jd. Maria Dirce (km 211)"
                    }
                ],
                "legTotalCost": 3.09,
                "vehicleType": "CAR",
                "calculationDate": 1765569922581
            },
            "arrivalSiteId": "PFS002",
            "departureSiteId": "PFE001"
        }
    ],
    "source": "MAPLINK",
    "createdAt": 1765569922581,
    "expiryIn": 1766174722581
}