↑
Toll

Exemplo – Cobrança por segmento

Este exemplo é específico para pistas onde a cobrança é realizada por segmento, ou seja, pela combinação de um pórtico de entrada e um de saída. Assim, o valor retornado será proporcional à quantidade de quilômetros rodados na pista.

Para esses casos, o campo type irá retornar as seguintes opções:

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

Os valores, valores condicionais e códigos de integração serão sempre retornados nos pórticos de saída, com uma referência ao pórtico de entrada correspondente, conforme os exemplos abaixo.

Nota: Caso a rota passe apenas pelo pórtico de saída, sem nenhum pórtico de entrada para referência, o valor e código de integração retornados serão os de segmento com maior valor possível.

Requisição

Na requisição sera necessario adicionar o parametro billing com valor FREE_FLOW para que os porticos sejam retornados. No exemplo abaixo, a rota passa por um portico de entra e por um portico de saIda, localizado na rodovia Presidente Dutra. no Brasil.

Requisição com Endpoint Independente

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

Requisição com a 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"
  }
}

Resposta

Assim como nos exemplos anteriores, em tollCosts temos o valor total dos pedágios em toda a rota. Em cada leg será retornado um objeto tollCalculation contendo um objeto tolls com os valores e informações de cada pedágio no trecho correspondente, e a legTotalCost que mostra o valor total de pedágios naquele trecho.

Dentro de cada objeto em tolls teremos as informações de cada pedágio, com as seguintes diferenças:

  • Para o pórtico de entrada, ENTRY_GANTRY, o valor retornado em price será sempre 0. Também não será retornado nenhum código de integração no campo serviceTypes.
  • Para o pórtico de saída, EXIT_GANTRY, será retornado normalmente os valores e códigos de integração. Esses dados não são referentes ao pórtico em si, mas sim ao segmento entre o pórtico de entrada e o de saída.

Será retornado também os seguintes campos:

  • entryGantryId – Id do pórtico de entrada correspondente;
  • entryGantryName – Nome do pórtico de entrada correspondente;
  • segmentId – Id referente ao segmento composto pelos pórticos de entrada e saída. Corresponde aos ids dos dois pórticos concatenados.

Resposta com Endpoint Independente

{
    "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
}

Resposta com a 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
}

Exemplo Brasil – Pórticos Rodovia Presidente Dutra

O exemplo abaixo é de uma rota que passa pela Rodovia Presidente Dutra, onde foram instalados pórticos de entrada e saída nas alças de acesso à pista principal. A rota acessa a pista principal pelo pórtico de entrada PFE001 e sai da rodovia passando pelo pórtico de saída PFS002.

Rota na Rodovia Presidente Dutra, entre os pórticos PFE001 e PFS002.

A requisição completa encontra-se abaixo:

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

A reposta será retornada conforme o exemplo abaixo:

{
    "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
}

Exemplo Chile – Pórticos Autopista Vespucio Oriente

O exemplo abaixo é de uma rota que passa pela Autopista Vespucio Oriente, no Chile. A cobrança nessa autopista também acontece por pórticos de entrada e saída. A rota abaixo acessa a autopista passando pelo pórtico de entrada Bilbao e sai da autopista pelo pórtico de saída Los Militares.

Rota na Autopista Vespucio Oriente, entre os pórticos Bilbao e Los Militares.

A requisição completa encontra-se abaixo:

{
    "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"
    }
}

A resposta completa pode ser conferida abaixo:

{
    "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
}

Exemplo México – Autopista Toluca – Naucalpan

Algumas autopistas no México operam com o sistema de cobrança fechado, onde o valor a ser pago é determinado pelo trecho percorrido. Esse controle é feito por pórticos ou cabines de pedágio, de entrada e de saída.

Sistema de cobrança fechado.

O exemplo abaixo é de uma rota na Autopista Toluca – Naucalpan, administrada pela concessionária Autovan, sentido Chamapa. A rota passa pelo pedágio de entrada em Ayotuxco e termina passando pelo pedágio de Chamapa. O valor a ser pago no pedágio de Chamapa é determinado por qual foi o pedágio de entrada anterior.

Rota na Autopista Toluca – Naucalpan, entre os pedágios de Ayotuxco e Chamapa.

A requisição completa para esse exemplo encontra-se abaixo:

{
    "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"
    }
}

A resposta completa encontra-se abaixo:

{
    "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
}