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. avoidTollscomoRouteModifierpara 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. En este ejemplo, hiciste lo siguiente:
Establece el campo de arreglo
extraComputationsenTOLLSpara habilitar el cálculo de la información de peaje.Especifica el tipo de vehículo y el tipo de pase de peaje con el campo
routeModifiersde 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 más económico.Usa la máscara de campo de respuesta para configurar el método y mostrar la información de peaje en la respuesta. En este ejemplo, la solicitud incluía las siguientes propiedades en la máscara del campo de respuesta:
routes.travelAdvisory.tollInfopara mostrar información de toda la ruta.routes.legs.travelAdvisory.tollInfopara mostrar información sobre cada etapa.
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",
"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'
Respuesta que contiene información sobre el peaje
La respuesta contiene información sobre los peajes en un objeto TollInfo (REST) o TollInfo (gRPC). En este ejemplo, se muestra la información de los peajes de toda la ruta y de cada tramo de la ruta.
{
"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 peaje:
Establece el campo de arreglo
extraComputationsenTOLLSpara habilitar el cálculo de la información de peaje.Especifica el tipo de vehículo y el tipo de pase de peaje con el campo
routeModifiersde los puntos de referencia origin 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.Usa la máscara de campo de respuesta para configurar el método y mostrar la información de peaje en la respuesta. Especifica
routes.travelAdvisory.tollInfopara mostrar información de toda la ruta.
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",
"extraComputations": ["TOLLS"]
}' \
-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ón | País/Región | Estado/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 |
| EE.UU. | Estados Unidos | Alabama |
| EE.UU. | Estados Unidos | Alaska |
| EE.UU. | Estados Unidos | California |
| EE.UU. | Estados Unidos | Colorado |
| EE.UU. | Estados Unidos | Delaware |
| EE.UU. | Estados Unidos | Florida |
| EE.UU. | Estados Unidos | Illinois |
| EE.UU. | Estados Unidos | Iowa |
| EE.UU. | Estados Unidos | Indiana |
| EE.UU. | Estados Unidos | Kansas |
| EE.UU. | Estados Unidos | Luisiana |
| EE.UU. | Estados Unidos | Maine |
| EE.UU. | Estados Unidos | Maryland |
| EE.UU. | Estados Unidos | Massachusetts |
| EE.UU. | Estados Unidos | Michigan |
| EE.UU. | Estados Unidos | Minesota |
| EE.UU. | Estados Unidos | Misuri |
| EE.UU. | Estados Unidos | Nuevo Hampshire |
| EE.UU. | Estados Unidos | Nueva Jersey |
| EE.UU. | Estados Unidos | Nueva York |
| EE.UU. | Estados Unidos | Carolina del Norte |
| EE.UU. | Estados Unidos | Ohio |
| EE.UU. | Estados Unidos | Pensilvania |
| EE.UU. | Estados Unidos | Rhode Island |
| EE.UU. | Estados Unidos | Carolina del Sur |
| EE.UU. | Estados Unidos | Texas |
| EE.UU. | Estados Unidos | Utah |
| EE.UU. | Estados Unidos | Virginia |
| EE.UU. | Estados Unidos | Washington |
| EE.UU. | Estados Unidos | Virginia Occidental |
Esta información se actualizará a medida que haya más datos sobre los peajes disponibles.