Versions Compared

Key

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

A Toll for Maps API trabalha com requisição do tipo POST de forma síncrona, enviando os parâmetros necessários e em body a rota para calcular o pedágio.

Construindo requisições para Toll for Maps API

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

https://api.maplink.global/toll/v1/directions?vehicleType=TRUCK_WITH_TWO_DOUBLE_AXLES&billing=FREE_FLOW

...

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

TRUCK_WITH_TWO_SINGLE_AXIS

MOTORCYCLE

TRUCK_WITH_TWO_DOUBLE_AXLES

CAR_WITH_THREE_SIMPLE_AXLES

TRUCK_WITH_THREE_DOUBLE_AXLES

CAR_WITH_FOUR_SIMPLE_AXLES

TRUCK_WITH_FOUR_DOUBLE_AXLES

BUS_WITH_TWO_DOUBLE_AXLES

TRUCK_WITH_FIVE_DOUBLE_AXLES

BUS_WITH_THREE_DOUBLE_AXLES

TRUCK_WITH_SIX_DOUBLE_AXLES

BUS_WITH_FOUR_DOUBLE_AXLES

TRUCK_WITH_SEVEN_DOUBLE_AXLES

BUS_WITH_FIVE_DOUBLE_AXLES

TRUCK_WITH_EIGHT_DOUBLE_AXLES

TRUCK_WITH_NINE_DOUBLE_AXLES

  • 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).

Info

Até a data deste documento, o sistema livre de passsagem em pedágio tem em São Paulo, as experiências com Free Flow em fase piloto e se aplicam nas rodovias:

  1. Engenheiro Constâncio Cintra (SP-360) - Concessão: Rota das Bandeiras

  2. Santos Dumont (SP-075) - Concessão: AB Colinas

  3. Governador Adhemar Pereira de Barros (SP-340) - Concessão: Renovias

  4. 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 a apenas para moradores das cidades vizinhas e veículos de Categoria 1.

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.

TRUCK_WITH_TEN_DOUBLE_AXLES

Info

Nota: 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.