| Table of Contents |
|---|
Construindo requisições para Trip API
Para realizar a requisição para a API é necessário usar o método POST/calculagions:
| Code Block | ||
|---|---|---|
| ||
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.
...
A Toll for Maps API possui dois parâmetros que devem ser informados na url (query params). São os seguintes:
...
billing- Texto que indica o tipo de cobrança de pedágio. Os valores possíveis são:DEFAULT - É o valor padrão caso o parâmetro não seja informado e indica que o cálculo de cobrança convencional de pedágios será utilizado, ou seja, apenas nas praças de pedágio.
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 ou praças de pedágio) quanto o sistema convencional (praças de pedágio).
vehicleType- Tipo de veículo que se deseja obter o valor de pedágio. O valor default caso não seja informado é 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:
...
...
TRUCK_WITH_
...
TEN_DOUBLE_AXLES
...
| Info |
|---|
Nota: |
...
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 |
Exemplo de requisição com parâmetros opcionais:
| Code Block | ||
|---|---|---|
| ||
| {
"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"
}
],
"source": "MAPLINK"
} Só será processada resposta da Directions que contenha o |