Calcular tarifas de pedágio de um trajeto

Ao computar uma rota ou uma matriz de rotas, considere as taxas de pedágio na rota. Para algumas cidades, você pode calcular o valor tarifa de pedágio para um trajeto na moeda apropriada.

Para encontrar os pedágios de uma matriz de trajeto, consulte Calcular as taxas de pedágio para uma matriz de trajetos

Para ver a lista de locais com pedágio, consulte a referência de TollPass (em inglês).

Como os pedágios são calculados

A API Routes calcula a taxa de pedágio estimada, considerando todos os descontos ou passes para pedágio disponíveis ao motorista ou veículo e às formas de pagamento mais convenientes. Se não houver preços de pedágio disponíveis para um trajeto, a API Routes indica a existência de um pedágio com uma taxa desconhecida.

Para receber estimativas de pedágio precisas, inclua as seguintes informações: na sua solicitação:

  • 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 é de retornados.
  • Todos os passes livres que o veículo e o motorista têm usando (TollPass). A API usa os passes livres para determinar taxas de pedágio precisas e retorna os preços em dinheiro. quando os passes de pedágio na solicitação não estão no local do trajeto.
  • Especifique como evitar pedágios, se necessário. Se você quer evitar vias com pedágio onde possível, adicione avoidTolls como um RouteModifier.

Calcular pedágios usando passes de pedágio

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

  • Se você especificar um cartão de pedágio inválido, ele vai ser ignorado.

  • Se você especificar vários pedágios como uma matriz, a API tentará calcula o preço da rota para cada cartão.

.

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

  • As tarifas podem ser mais baixas com tags de pedágio: em algumas regiões, um motorista ou veículo com tag de pedágio paga um pedágio diferente daquelas que não têm. Por exemplo, se você tiver um Pronto! de pedágio em Seattle, WA, EUA, o pedágio é menor do que se não tivesse passar.

  • Algumas vias podem exigir pedágio: algumas regiões, como a Indonésia, têm estradas que exigem uma tag de pedágio. Se você não especificar um pedágio para um rota em que uma tag de pedágio é necessária, a API não retorna um preço.

Calcular as taxas de pedágio de um trajeto

O exemplo a seguir usa computeRoutes para retornar informações de pedágio com uma estimativa quando uma tag de pedágio é usada. Neste exemplo, você:

  • Defina o campo de matriz extraComputations como TOLLS para ativar o cálculo de informações sobre pedágios.

  • Especifique o tipo de veículo e o tipo de tag de pedágio usando o routeModifiers da solicitação. O preço do pedágio retornado é baseado em o preço usado pelo tipo de veículo e cartão especificados. Se mais de um pass é especificado, o preço mais barato é retornado.

  • Use a máscara de campo de resposta para configurar o método a fim de retornar informações de pedágio na resposta. Neste exemplo, a solicitação incluiu as seguintes propriedades na máscara do campo de resposta:

    • routes.travelAdvisory.tollInfo para retornar informações da o trajeto inteiro.

    • routes.legs.travelAdvisory.tollInfo para retornar informações para cada trecho.

    .

Solicitação de informações sobre pedágios

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "extraComputations": ["TOLLS"],
  "routeModifiers":{
    "vehicleInfo":{
      "emissionType": "GASOLINE"
    },
    "tollPasses": [
      "US_MA_EZPASSMA",
      "US_WA_GOOD_TO_GO"
    ]
  }
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Resposta contendo informações sobre pedágio

A resposta contém informações sobre pedágios em um TollInfo (REST) ou TollInfo (gRPC). Neste exemplo, você retorna informações sobre pedágios para todo o trajeto e para cada trecho de ao longo do trajeto.

{
  "routes": [
    {
      "legs": [
        {
          "travelAdvisory": {
            "tollInfo": {
              "estimatedPrice": [
                {
                  "currencyCode": "USD",
                  "units": "4",
                  "nanos": 400000000
                }
              ]
            }
          }
        }
      ],
      "distanceMeters": 150338,
      "duration": "6650s",
      "travelAdvisory": {
        "tollInfo": {
          "estimatedPrice": [
            {
              "currencyCode": "USD",
              "units": "4",
              "nanos": 400000000
            }
          ]
        }
      }
    }
  ]
}