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

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
{
"legs": [
{
"points": "zh~qEdpncJH[LQHGNGLCPAJBPHHFJNHN@N@XAREV[z@Yx@C@gClE",
"vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES",
"calculationDate": 1738861232000,
"condition": {
"period": "NORMAL",
"billingType": "NORMAL"
}
}
]
}
{ "legs": [ { "points": "zh~qEdpncJH[LQHGNGLCPAJBPHHFJNHN@N@XAREV[z@Yx@C@gClE", "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES", "calculationDate": 1738861232000, "condition": { "period": "NORMAL", "billingType": "NORMAL" } } ] }
{
    "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

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
{
"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"
}
}
}
{ "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" } } }
{
  "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

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
{
"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
}
{ "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 }
{
    "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

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
{
"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
}
{ "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 }
{
    "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
}