Nesse exemplo, temos uma rota simples que passa pelo pedágio de Itaquaquecetuba. Iremos utilizar o endpoint independente para obter o cálculo dos pedágios.

Requisição

O parâmetro legs é um array de objetos onde cada objeto representa um trecho da rota. Em cada leg, devemos definir o parâmetro points, que contém as coordenadas que compõem a rota. No caso, teremos apenas uma leg que corresponde a rota inteira.

Em vehicleType definimos que queremos realizar a rota com um caminhão de dois eixos duplos, TRUCK_WITH_TWO_DOUBLE_AXLES. Em condition, informaremos billingType como NORMAL e period como NORMAL.

Caso utilize a Trip API, a resposta obtida na Trip poderá ser usada como requisição para a Toll API, bastando apenas adicionar o parâmetro vehicleType em cada leg. 

Nota: O endpoint independente só é recomendável caso você utilize roteirizadores de terceiros. Caso utilize a Trip API, é possível obter os pedágios na mesma requisição.

Abaixo a requisição completa:

{
    "legs": [
        {
            "points": [
                {
                    "latitude": -23.465395,
                    "longitude": -46.375007
                },
                {
                    "latitude": -23.465957,
                    "longitude": -46.371015
                },
                {
                    "latitude": -23.467154,
                    "longitude": -46.36559
                }
            ],
            "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES",
            "condition": {
                "period": "NORMAL",
                "billingType": "NORMAL"
            }
        }
    ]
}

Resposta

Na resposta, teremos os seguintes campos:

• totalCost – Valor total dos pedágios em toda rota;
• legs – Array de objetos onde cada objeto representa um trecho da rota. Cada leg da resposta corresponde a um leg da requisição. Em cada objeto será retornado os seguintes campos:
  • tolls – Objeto com os valores e informações de cada pedágio no trecho correspondente. Cada objeto retornado em tolls representa um pedágio e irá conter as seguintes informações:
    • name – Nome do pedágio;
    • address – Endereço do pedágio;
    • city – Cidade do pedágio;
    • state – Objeto contendo o nome do estado (name) e sua sigla (code);
    • country – País do pedágio;
    • concession – Concessionária responsável pelo pedágio;
    • coordinates – Coordenadas (latitude e longitude) do pedágio;
    • price – Valor por pedágio;
    • serviceTypes – Array com códigos para integração com sistemas de pagamento automático. Atualmente disponível apenas no Brasil;
  • legTotalCost – Valor total de pedágios para o trecho;
  • vehicleType – Tipo de veículo considerado para o trecho;
  • calculationDate – Data e hora considerados para o trecho, em formato timestamp;
  • condition – Se o parâmetro condition for usado na requisição, esse objeto será retornado contendo qual billingType e period foram considerados para o trecho.

A resposta completa pode ser conferida abaixo:

{
    "legs": [
        {
            "tolls": [
                {
                    "id": "17",
                    "name": "Pedágio - Itaquaquecetuba Leste",
                    "address": "SP 070 - Rod. Ayrton Senna - Km 32,9",
                    "city": "Itaquaquecetuba",
                    "state": {
                        "name": "São Paulo",
                        "code": "SP"
                    },
                    "country": "Brasil",
                    "concession": "Ecopistas",
                    "direction": "EAST",
                    "coordinates": {
                        "latitude": -23.4656821,
                        "longitude": -46.3727036
                    },
                    "serviceTypes": [
                        {
                            "serviceId": "80",
                            "name": "Via Facil"
                        },
                        {
                            "serviceId": "35350700329000103",
                            "name": "ANTTCODE"
                        }
                    ],
                    "price": 10.80
                }
            ],
            "legTotalCost": 10.80,
            "vehicleType": "TRUCK_WITH_TWO_DOUBLE_AXLES",
            "condition": {
                "billingType": "NORMAL",
                "period": "NORMAL"
            },
            "calculationDate": 1738852668146
        }
    ],
    "totalCost": 10.80
}