Exemplo – Pedágios com desconto por meio de pagamento automático
Algumas praças de pedágio oferecem uma porcentagem de desconto para usuários que utilizam meios de pagamento automático, conhecidos como TAG ou TelePeaje.
No Brasil essa porcentagem é de 5% de desconto e está disponível para apenas algumas concessionárias que oferecem o serviço. Essa porcentagem pode variar em outros países. Na Argentina, por exemplo, a concessionária Caminos del Río Uruguay oferece 15% de desconto para usuários que utilizam a tag, ou TelePeaje.
No exemplo a seguir, temos uma rota usando um caminhão de dois eixos simples que passa pelo pedágio de Parapuã, no Brasil, que oferece um desconto de 5%.
Requisição
Os seguintes parâmetros serão necessários para obter o valor já com o desconto por TAG aplicado:
vehicleType
– Tipo de veículo a ser considerado, no exemplo seráTRUCK_WITH_TWO_DOUBLE_AXLES
;conditions
– Objeto que indica quais valores devem ser considerados para pedágios onde existem valores condicionais, como nesse exemplo valor com desconto para veículos com TAG: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 deve serTAG
.
Requisição com Endpoint independente
{ "legs": [ { "points": "`fidCffqtHo@t@u@hAm@p@yCvEe@v@aBvBqAjBeA~A", "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES", "condition": { "period": "NORMAL", "billingType": "TAG" } } ] }
Requisição com Trip API
{ "calculationMode": "THE_FASTEST", "points": [ { "siteId": "Point 1", "latitude": -21.843015408682692, "longitude": -50.71983853381955 }, { "siteId": "Point 2", "latitude": -21.840092392777727, "longitude": -50.72374936513232 } ], "toll": { "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES", "condition": { "period": "NORMAL", "billingType": "TAG" } } }
Resposta
Resposta com Endpoint independente
{ "legs": [ { "tolls": [ { "id": "828", "name": "Pedágio - Parapuã", "address": "SP294, KM551+500", "city": "Parapuã", "state": { "name": "São Paulo", "code": "SP" }, "country": "Brasil", "concession": "Eixo-SP", "direction": "WEST", "coordinates": { "latitude": -21.840998367867602, "longitude": -50.722601401095574 }, "serviceTypes": [ { "serviceId": "791", "name": "Via Facil" }, { "serviceId": "35352945515000103", "name": "ANTTCODE" } ], "price": 19.76 } ], "legTotalCost": 19.76, "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES", "condition": { "billingType": "TAG", "period": "NORMAL" }, "calculationDate": 1738853654511 } ], "totalCost": 19.76 }
Resposta com Trip API
{ "id": "67a4ccd6361dc514265d966f", "clientId": "maplink", "totalDistance": 518, "totalNominalDuration": 37, "averageSpeed": 64.8, "tollCosts": 19.76, "legs": [ { "distance": 518, "nominalDuration": 37, "averageSpeed": 64.8, "points": "`fidCffqtHo@t@u@hAm@p@yCvEe@v@aBvBqAjBeA~A", "tollCalculation": { "tolls": [ { "id": "828", "name": "Pedágio - Parapuã", "address": "SP294, KM551+500", "city": "Parapuã", "state": { "name": "São Paulo", "code": "SP" }, "country": "Brasil", "concession": "Eixo-SP", "direction": "WEST", "coordinates": { "latitude": -21.840998367867602, "longitude": -50.722601401095574 }, "serviceTypes": [ { "serviceId": "791", "name": "Via Facil" }, { "serviceId": "35352945515000103", "name": "ANTTCODE" } ], "price": 19.76 } ], "legTotalCost": 19.76, "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES", "calculationDate": 1738853590334, "condition": { "billingType": "TAG", "period": "NORMAL" } } } ], "crossedBorders": [], "source": "MAPLINK", "createdAt": 1738853590348, "expiryIn": 1739458390249 }