Calcular tarifas de pedágio

Desenvolvedores do Espaço Econômico Europeu (EEE)

Ao calcular um trajeto ou uma matriz de trajetos, talvez você queira considerar as taxas de pedágio no trajeto. Em algumas cidades, é possível calcular o valor estimado do pedágio para um trajeto na moeda adequada.

Para conferir a lista de locais com pedágio aceitos, consulte a referência de TollPass.

Como os pedágios são calculados

A API Routes calcula a taxa de pedágio estimada, considerando os descontos ou tags de pedágio disponíveis para o motorista ou veículo e os métodos de pagamento mais convenientes. Se não houver um preço de pedágio disponível para uma determinada rota, a API Routes vai indicar a existência de um pedágio com uma taxa desconhecida.

Para receber estimativas precisas de pedágio, inclua as seguintes informações no seu pedido:

  • O tipo de emissão do veículo usado no trajeto (VehicleEmissionType). Se nenhum tipo de emissão for informado, o pedágio de um veículo a gasolina será retornado.
  • Todos os pedágios que o veículo e o motorista têm usando tollPasses. A API usa os pedágios para determinar as taxas corretas e retorna os preços em dinheiro quando os pedágios na solicitação não são locais da rota.
  • Especifique "evitar pedágios", se necessário. Se você quiser evitar vias com pedágio sempre que possível, adicione avoidTolls como um RouteModifier.

Calcular pedágios usando um passe

Para calcular pedágios usando um passe, especifique os passes como parte da solicitação. Em seguida, a API retorna os preços dos passes.

  • Se você especificar um passe de pedágio inválido, ele será ignorado.
  • Se você especificar vários pedágios como uma matriz, a API tentará calcular o preço do trajeto para cada um deles.

O comportamento dos pedágios pode variar de acordo com a região.

  • As tarifas podem ser mais baixas com um passe de pedágio: em algumas regiões, um motorista ou veículo com um passe de pedágio paga um valor diferente daqueles que não têm um passe. Por exemplo, se você tiver um Tudo pronto! em Seattle, WA, EUA, você paga um pedágio menor do que se não tiver um passe.
  • Algumas vias podem exigir um passe de pedágio: algumas regiões, como a Indonésia, têm vias que exigem um passe de pedágio. Se você não especificar um passe de pedágio para uma rota em que ele é obrigatório, a API não vai retornar um preço de pedágio.

Calcular as taxas de pedágio de um trajeto

Para calcular os pedágios de um trajeto, siga estas etapas:

  • Defina a propriedade extraComputations como TOLLS.
  • Especifique o tipo de veículo e de pedágio usando a propriedade routeModifiers.
  • Para calcular os pedágios de uma rota inteira, solicite travelAdvisory na propriedade fields da solicitação e leia route.travelAdvisory.tollInfo para ver as informações de pedágio da rota inteira.
  • Para calcular as taxas de pedágio de trechos individuais de uma rota, solicite legs na propriedade fields da solicitação e leia route.legs[i].travelAdvisory.tollInfo para conferir as informações de pedágio de cada trecho.

Exemplo

O exemplo de solicitação a seguir mostra como pedir pedágios para um trajeto:

const requestWithTolls = {
  origin: 'Kirkland, WA',
  destination: 'University of Washington',
  travelMode: 'DRIVING',
  extraComputations: ['TOLLS'],
  routeModifiers: {
    vehicleInfo: {
      emissionType: 'GASOLINE',
    },
    tollPasses: ['US_WA_GOOD_TO_GO'],
  },
  fields: ['path', 'legs', 'distanceMeters', 'durationMillis', 'travelAdvisory'],
};