Construindo requisições para Toll API
Para realizar a requisição para a API é necessário usar o método POST/calculations:
https://api.maplink.global/toll/v1/calculations
os seguintes headers são necessários
--header 'Content-Type: application/json' \ --header 'Authorization: Bearer token'
Onde Token é o access token obtido na autenticação.
Em body são enviados todos os parâmetros para calcular o pedágio da rota.
Body e Parâmetros da Request
A lista dos parâmetros estão descritos separados pelos grupos que eles pertencem.
Parâmetros Obrigatórios:
legs: Array compointsevehicleTypepara serem calculados os pedágios.points: Coordenadas da polilinha:latitude: coordenada da latitude em graus decimais.longitude: coordenada da longitude em graus decimais.
vehicleType: Texto que define o tipo de veículo a ser considerado para calcular o pedágio. Os valores possíveis são: [ CAR, MOTORCYCLE, CAR_WITH_THREE_SIMPLE_AXLES, CAR_WITH_FOUR_SIMPLE_AXLES, BUS_WITH_TWO_DOUBLE_AXLES, BUS_WITH_THREE_DOUBLE_AXLES, BUS_WITH_FOUR_DOUBLE_AXLES, BUS_WITH_FIVE_DOUBLE_AXLES, TRUCK_WITH_TWO_SINGLE_AXIS, TRUCK_WITH_TWO_DOUBLE_AXLES, TRUCK_WITH_THREE_DOUBLE_AXLES, TRUCK_WITH_FOUR_DOUBLE_AXLES, TRUCK_WITH_FIVE_DOUBLE_AXLES, TRUCK_WITH_SIX_DOUBLE_AXLES, TRUCK_WITH_SEVEN_DOUBLE_AXLES, TRUCK_WITH_EIGHT_DOUBLE_AXLES, TRUCK_WITH_NINE_DOUBLE_AXLES ]
Exemplo de Request com parâmetros obrigatórios:
{
"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"
}
]
}
Nota: A maneira mais prática de processar a Toll é obter o resultado da Trip API e adicionar o "vehicleType" em cada leg.
Parâmetros Opcionais:
billing: Texto que indica o tipo de cobrança de pedágio. Valores possíveis são [ DEFAULT, FREE_FLOW]. O DEFAULT é o valor padrão e indica para ser utilizado o cálculo de cobrança convencional de pedágios, ou seja, apenas nas praças de pedágio. O FREE_FLOW indica que será calculado os valores de pedágios em trechos de rodovias que possuam tanto o sistema de livre de passagem (onde existir pórticos e praças de pedágio) quanto o sistema convencional (praças de pedágio).
Até a data deste documento, o sistema livre de passagem em pedágio tem em São Paulo, as experiências com Free Flow em fase piloto e se aplicam nas rodovias:
Engenheiro Constâncio Cintra (SP-360) - Concessão: Rota das Bandeiras
Santos Dumont (SP-075) - Concessão: AB Colinas
Governador Adhemar Pereira de Barros (SP-340) - Concessão: Renovias
Prof. Zeferino Vaz (SP-332) - Concessão: Rota das Bandeiras .
O uso é mediante cadastro dos usuários portadores de TAG diretamente com as concessionárias. Apenas a SP-340 que permite o cadastro para qualquer usuário e veículo da rodovia. Enquanto nas outras é disponível apenas para moradores das cidades vizinhas e veículos de Categoria 1.
source: Texto que indica qual o mapa base a ser usado de referência para o pedágio. Utilizar emsourceo valor MAPLINK pois é o compatível com o mapa padrão da Trip API.
Exemplo de requisição com parâmetros opcionais:
{
"billing": "FREE_FLOW",
"legs": [
{
"vehicleType": "TRUCK_WITH_TWO_SINGLE_AXIS",
"points": [
{
"latitude": -22.810771042965545,
"longitude": -47.11138517225861
},
{
"latitude": -22.808350968991387,
"longitude": -47.11609310990462
}
]
}
],
"source": "MAPLINK"
}