Calcular tarifas de peaje

Desarrolladores del Espacio Económico Europeo (EEE)

Cuando calculas una ruta o una matriz de rutas, es posible que desees tener en cuenta las tarifas de peaje de la ruta. En algunas ciudades, puedes calcular la tarifa de peaje estimada para una ruta en la moneda correspondiente.

Para obtener la lista de ubicaciones de peaje admitidas, consulta la referencia de TollPass.

Cómo se calculan los peajes

La API de Routes calcula la tarifa de peaje estimada, teniendo en cuenta los descuentos o pases de peaje disponibles para el conductor o el vehículo, y los métodos de pago más convenientes. Si no hay un precio de peaje disponible para una ruta determinada, la API de Routes indica la existencia de un peaje con una tarifa desconocida.

Para obtener estimaciones precisas de peajes, asegúrate de incluir la siguiente información en tu solicitud:

  • El tipo de emisión del vehículo que se usa para la ruta (VehicleEmissionType). Si no se proporciona un tipo de emisión, se devuelve el peaje para un vehículo a gasolina.
  • Todos los pases de peaje que tienen el vehículo y el conductor con tollPasses La API usa los pases de peaje para determinar las tarifas de peaje exactas y muestra los precios en efectivo cuando los pases de peaje de la solicitud no son locales para la ruta.
  • Especifica que se eviten los peajes, si es necesario. Si quieres evitar las rutas con peaje siempre que sea posible, agrega avoidTolls como un RouteModifier.

Cómo calcular peajes con un pase de peaje

Para calcular los peajes con un pase de peaje, debes especificar los pases de peaje como parte de la solicitud. Luego, la API devuelve los precios de los pases.

  • Si especificas un pase de peaje no válido, se ignorará el pase.
  • Si especificas varios pases de peaje como un array, la API intentará calcular el precio de la ruta para cada pase.

El comportamiento de los pases de peaje puede variar según la región.

  • Las tarifas pueden ser más bajas con un pase de peaje: En algunas regiones, un conductor o un vehículo con un pase de peaje paga un peaje diferente al de quienes no tienen un pase. Por ejemplo, si tienes un Good To Go! peaje en Seattle, Washington, EE.UU., pagas un peaje más bajo que si no tienes un pase.
  • Es posible que algunas rutas requieran un pase de peaje: Algunas regiones, como Indonesia, tienen rutas que requieren un pase de peaje. Si no especificas un pase de peaje para una ruta en la que se requiere uno, la API no devolverá un precio de peaje.

Calcula los peajes de una ruta

Para calcular las tarifas de peaje de una ruta, sigue estos pasos:

  • Establece la propiedad extraComputations en TOLLS.
  • Especifica el tipo de vehículo y el tipo de pase de peaje con la propiedad routeModifiers.
  • Para calcular las tarifas de peaje de toda una ruta, solicita travelAdvisory en la propiedad fields de la solicitud y, luego, lee route.travelAdvisory.tollInfo para ver la información de peaje de toda la ruta.
  • Para calcular las tarifas de peaje de los tramos individuales de una ruta, solicita legs en la propiedad fields de la solicitud y consulta la información de peaje de cada tramo leyendo route.legs[i].travelAdvisory.tollInfo.

Ejemplo

En la siguiente solicitud de ejemplo, se muestra cómo solicitar las tarifas de peaje para una ruta:

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'],
};