Toll

Exemplo – Pedágios com tarifas por faixa de horário

Algumas praças de pedágio, principalmente na Argentina e no Chile, possuem valores condicionantes que variam conforme o dia, horário ou época do ano em que a rota está sendo realizada.

Por exemplo, na Argentina as concessionárias possuem tarifas especiais para horários de pico, finais de semana e feriados, ou épocas específicas do ano como baixa temporada e alta temporada.

Abaixo segue a tabela de tarifas da concessionária AUSA da Argentina, onde são disponibilizadas dois tipos de tarifas, uma para horário comum e outra para horário de pico.

Tabela com valores diferentes para hório comum e horário de pico

No Brasil, esse tipo de tarifa é mais raro, mas algumas concessionárias já cobram valores diferentes em finais de semana e feriados

Nesse exemplo temos um rota com um caminhão de 4 eixos que passará pelo pórtico de Sarmiento, na Argentina. Conforme a tabela acima, esse pórtico possui valores condicionantes para os horários de pico.

Requisição

Os seguintes parâmetros serão necessários para obter o valor correto segundo o horário e dia da semana:

  • vehicleType – Tipo de veículo a ser considerado, no exemplo será TRUCK_WITH_TWO_DOUBLE_AXLES;
  • calculationDate – Data e hora no forarmato timestamp. Nesse exemplo vamos usar a data de 06/02/2025 às 17:00 (GMT), que corresponde ao timestamp 1738861232000;
  • conditions – Objeto que indica quais valores devem ser considerados para pedágios onde existem valores condicionais, como nesse exemplo valor por faixa de horário e dia da semana:
    • period – Indica o período que deve ser considerado para retornar o valor exato do pedágio. Nesse caso, a rota será realizado em um dia comum, por isso o valor usado nesse exemplo será NORMAL.
    • billingType – Indica o tipo de cobrança que deve ser considerado. O valor a ser usado nesse exemplo será NORMAL.

Requisição com Endpoint independente

{
    "legs": [
        {
            "points": "zh~qEdpncJH[LQHGNGLCPAJBPHHFJNHN@N@XAREV[z@Yx@C@gClE",
            "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES",
            "calculationDate": 1738861232000,
            "condition": {
                "period": "NORMAL",
                "billingType": "NORMAL"
            }
        }
    ]
}

Requisição com a Trip API

{
  "calculationMode": "THE_FASTEST",
  "points": [
    {
      "latitude": -34.566702,
      "longitude": -58.406596,
      "siteId": "Point 1"
    },
    {
      "latitude": -34.566436,
      "longitude": -58.408582,
      "siteId": "Point 2"
    }
  ],
  "toll": {
    "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES",
    "calculationDate":1738861232000,
    "condition": {
            "period": "NORMAL",
            "billingType": "NORMAL"
        }
  }
}

O resultado pode ser visualizado no mapa abaixo:

Resposta

Como o horário se enquadra em horário de pico para o pedágio em questão, o valor retornado será 2348.84, conforme a tabela fornecida pela concessionária.

As respostas completas podem ser conferida abaixo.

Resposta com Endpoint independente

{
    "legs": [
        {
            "tolls": [
                {
                    "id": "1032",
                    "name": "Pórtico - Sarmiento",
                    "address": "Avenida Sarmiento, 4254",
                    "city": " ",
                    "state": {
                        "name": "Ciudad Autonoma de Buenos Aires",
                        "code": "Ciudad Autonoma de Buenos Aires"
                    },
                    "country": "Argentina",
                    "concession": "Ausa",
                    "direction": "WEST",
                    "coordinates": {
                        "latitude": -34.5671991,
                        "longitude": -58.4063059
                    },
                    "serviceTypes": [],
                    "price": 2348.84
                }
            ],
            "legTotalCost": 2348.84,
            "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES",
            "condition": {
                "billingType": "NORMAL",
                "period": "NORMAL"
            },
            "calculationDate": 1738861232000
        }
    ],
    "totalCost": 2348.84
}

Resposta com a Trip API

{
    "id": "67a4ef53361dc514265d9676",
    "clientId": "maplink",
    "totalDistance": 328,
    "totalNominalDuration": 28,
    "averageSpeed": 64.87,
    "tollCosts": 2348.84,
    "legs": [
        {
            "distance": 328,
            "nominalDuration": 28,
            "averageSpeed": 64.87,
            "points": "zh~qEdpncJH[LQHGNGLCPAJBPHHFJNHN@N@XAREV[z@Yx@C@gClE",
            "tollCalculation": {
                "tolls": [
                    {
                        "id": "1032",
                        "name": "Pórtico - Sarmiento",
                        "address": "Avenida Sarmiento, 4254",
                        "city": " ",
                        "state": {
                            "name": "Ciudad Autonoma de Buenos Aires",
                            "code": "Ciudad Autonoma de Buenos Aires"
                        },
                        "country": "Argentina",
                        "concession": "Ausa",
                        "direction": "WEST",
                        "coordinates": {
                            "latitude": -34.5671991,
                            "longitude": -58.4063059
                        },
                        "serviceTypes": [],
                        "price": 2348.84
                    }
                ],
                "legTotalCost": 2348.84,
                "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES",
                "calculationDate": 1738861232000,
                "condition": {
                    "billingType": "NORMAL",
                    "period": "NORMAL"
                }
            }
        }
    ],
    "crossedBorders": [],
    "source": "MAPLINK",
    "createdAt": 1738862419537,
    "expiryIn": 1739467219482
}