En este momento, la API de Routes está en vista previa (versión previa a la DG). Es posible que los productos y las funciones de la fase previa a la DG tengan asistencia limitada, y que los cambios en esos productos y funciones no sean compatibles con otras versiones de la fase previa a la DG. Las ofertas de la fase previa a la DG están cubiertas por las Condiciones específicas del servicio de Google Maps Platform. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Calcular tarifas de peaje

Cuando procesas una ruta o una matriz, es posible que debas considerar las tarifas de las rutas con peaje. En el caso de algunas ciudades, puedes calcular la tarifa estimada de una ruta en la moneda correspondiente.

Consulta la lista de peajes admitidos a continuación.

Cómo se calculan los peajes

La API de Routes calcula la tarifa de peaje estimada teniendo en cuenta cualquier descuento o pase de precio de peajes disponible para el conductor o el vehículo, y las formas 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 calcular con precisión la información de los peajes, la API de Routes te da la opción de especificar lo siguiente:

  • El tipo de emisión del vehículo que se usó para la ruta (VehicleEmissionType). Si no se proporciona un tipo de emisión, se muestra el peaje de un vehículo a gasolina.
  • Todos los pases de peajes que se apliquen al conductor o el vehículo (TollPass). Si no se especifican peajes, la API muestra el precio en efectivo.
  • avoidTolls como RouteModifier para evitar las rutas con peaje

Cálculo de los peajes cuando se utiliza un peaje

En algunas regiones, un conductor o vehículo con un pase de peaje paga un peaje diferente al de los que no tienen un pase. Por ejemplo, si tienes un peaje listo para pagar. En Seattle, Washington, EE.UU., pagas una tarifa más baja que si no tuvieras un pase.

Algunas regiones, como Indonesia, tienen rutas que requieren un peaje. Si no se especifica un pase de peaje para una ruta, no se muestra el precio.

Si especificas un peaje como parte de la solicitud, la API intenta mostrar el precio del pase:

  • Si especificas un pase de peaje no válido, este se ignorará.

  • Puedes especificar varios pases de peajes como un arreglo. La API intenta calcular el precio de los pases para cada ruta.

Calcular tarifas de peaje para una ruta

En el siguiente ejemplo, se usa el método computeRoutes para mostrar información de peaje con un precio estimado cuando se utiliza un pase de peaje.

Especifica el tipo de vehículo y el tipo de pase de peaje mediante el campo routeModifiers de la solicitud. El precio del peaje que se muestra se basa en el precio que usa el pase y el tipo de vehículo especificados. Si se especifica más de un pase, se muestra el precio menos costoso.

Solicitud de información sobre peajes

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "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'

Respuesta que contiene información sobre el peaje

La respuesta contiene información sobre peajes en un objeto TollInfo (REST) o TollInfo (gRPC).

Para configurar el método a fin de que muestre la información de los peajes, usa la máscara de campo de respuesta. Configura el campo routes.travelAdvisory.tollInfo para que muestre la información de toda la ruta y routes.legs.travelAdvisory.tollInfo si deseas mostrar la información de cada etapa.

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

Calcular tarifas de peaje para una matriz de ruta

En el siguiente ejemplo, se usa el método computeRouteMatrix para mostrar información de peajes en una ruta con un precio estimado cuando se utiliza un pase de peaje.

Especifica el tipo de vehículo y el tipo de pase de peaje mediante el campo routeModifiers de la solicitud. El precio del peaje que se muestra se basa en el precio que usa el pase y el tipo de vehículo especificados. Si se especifica más de un pase, se muestra el precio menos costoso.

Solicitud de información sobre un peaje de la matriz de rutas

curl -X POST -d '{
"origins": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.340173523716736,
          "longitude":-71.05997968330408
        }
      }
    },
    "routeModifiers": {
      "vehicleInfo":{
        "emissionType": "GASOLINE"
      },
      "tollPasses": [
        "US_MA_EZPASSMA",
        "US_WA_GOOD_TO_GO"
      ]
    }
  }
],
"destinations": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.075698891472804,
          "longitude": -72.59806562080408
        }
      }
    }
  }
],
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE"
}'
-H 'Content-Type: application/json'
-H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: originIndex,destinationIndex,travel_advisory.tollInfo,duration,distanceMeters,status' 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

Respuesta para información de peaje de la matriz de ruta

La respuesta contiene información sobre peajes en un objeto TollInfo (REST) o TollInfo (gRPC).

A fin de configurar el método para que muestre información de peaje, usa la máscara de campo de respuesta a fin de configurar el campo travelAdvisory.tollInfo en la máscara.

[
  {
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {},
    "distanceMeters": 150338,
    "duration": "5382s",
    "travelAdvisory": {
      "tollInfo": {
        "estimatedPrice": [
          {
            "currencyCode": "USD",
            "units": "4",
            "nanos": 400000000
           }
        ]
      }
    }
  }
]

Ubicaciones de peajes admitidas

Actualmente, la información de los peajes está disponible para las siguientes ubicaciones:

Código de regiónPaís/RegiónEstado/ciudad/ruta con peaje
AR Argentina Buenos Aires
AU Australia Brisbane
AU Australia Sídney
BR Brasil A nivel nacional
ID Indonesia A nivel nacional
IN India A nivel nacional
MX México Ciudad de México
US Estados Unidos Alabama
US Estados Unidos Alaska
US Estados Unidos California
US Estados Unidos Colorado
US Estados Unidos Delaware
US Estados Unidos Florida
US Estados Unidos Illinois
US Estados Unidos Iowa
US Estados Unidos Indiana
US Estados Unidos Kansas
US Estados Unidos Luisiana
US Estados Unidos Maine
US Estados Unidos Maryland
US Estados Unidos Massachusetts
US Estados Unidos Michigan
US Estados Unidos Minesota
US Estados Unidos Misuri
US Estados Unidos Nuevo Hampshire
US Estados Unidos Nueva Jersey
US Estados Unidos Nueva York
US Estados Unidos Carolina del Norte
US Estados Unidos Ohio
US Estados Unidos Pensilvania
US Estados Unidos Rhode Island
US Estados Unidos Carolina del Sur
US Estados Unidos Texas
US Estados Unidos Utah
US Estados Unidos Virginia
US Estados Unidos Washington
US Estados Unidos Virginia Occidental

Esta información se actualizará a medida que haya más datos sobre los peajes disponibles.