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.

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.

Para que os pórticos serem retornados, é necessário informar o parâmetro "billing": "FREE_FLOW".

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
}

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.