Toll

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 ser TAG.

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
}