Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Construindo requisições para

...

Toll API

Para realizar a requisição para a API é necessário usar o método POST/calculagionsdirections:

Code Block
languagejson
https://api.maplink.global/toll/v1/calculations

os seguintes headers são necessários

Code Block
--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 resolver o problema logístico.

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 com points e vehicleType para serem calculados os pedágios.

...

points: Coordenadas da polilinha:

  • latitude: coordenada da latitude em graus decimais.

  • longitude: coordenada da longitude em graus decimais.

...

directions?vehicleType=TRUCK_WITH_TWO_DOUBLE_AXLES

onde vehicleType é o tipo de veículo que se deseja obter o valor de pedágio. O valor default caso não seja infomado é CAR.

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:

Code Block
languagejson
{
    "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"
        }
    ]
}

Info

Nota: A maneira mais prática de processar a Toll e obter o resultado da Trip API e adicionar o "vehicleType" em cada leg.

Parâmetros Opcionais:

  • source: Texto que indica qual o mapa base a ser usado de referência para o pedágio. Valores possíveis são [ DEFAULT, OSM, MAPLINK ]. Até a data deste texto, 12/04/2021, o DEFAULT e NULL utiliza o mapa Tom Tom; MAPLINK e OSM utilizam o mapa OSM.

Info

Nota: Utilizar em source o valor MAPLINK pois é o compatível com o mapa padrão da Trip.

Exemplo de requisição com parâmetros opcionais:

...

languagejson

...

Os seguintes headers são necessários

Code Block
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer token'

Onde Token é o access token obtido na autenticação.

Em body é enviada a resposta obtida pela Google Maps Directions API.

Info

Nota 1: Só será processada resposta da Directions que contenha o "travel_mode": "DRIVING". Os tipos de "travel_mode" transit|walking|bicycling não são suportados para processar o pedágio.