El enrutamiento de vehículos grandes es un conjunto de propiedades que te permite optimizar las rutas de la flota para vehículos grandes especificando las dimensiones físicas, el peso y la cantidad de remolques. La API usa estos atributos para calcular rutas factibles que eviten caminos restringidos, puentes bajos o rutas con límite de peso.
Con el enrutamiento de vehículos grandes, puedes resolver desafíos de logística de la flota para vehículos pesados y grandes, por ejemplo:
- Evitar peligros en la ruta: Genera planes de ruta que alejen los vehículos de espacios libres bajos, caminos con restricción de peso y otros peligros físicos.
- Especificar información detallada del vehículo: Incorpora dimensiones precisas, peso total, cantidad de ejes y configuraciones de remolque en los planes de ruta de toda la flota.
- Mejorar la planificación de toda la flota: Crea planes de ruta eficientes para toda tu flota de camiones y, al mismo tiempo, asegúrate de que todas las asignaciones cumplan con las restricciones físicas de la ruta.
Limitaciones
Antes de comenzar, debes tener en cuenta las siguientes limitaciones y requisitos.
- Disponibilidad geográfica: El enrutamiento de vehículos grandes solo está disponible en los 48 estados contiguos de Estados Unidos.
- Advertencia y seguridad para el conductor: Los conductores no deben depender únicamente de las rutas que muestra esta API para que sean seguras o legales. No se garantiza que las rutas sean adecuadas para el vehículo, y seguirlas puede exponer a los conductores a peligros, como puentes bajos o caminos en los que se prohíben los vehículos grandes.
- Rutas de mejor esfuerzo: En algunos casos, la API no puede encontrar una ruta que cumpla por completo con las restricciones de viaje. En cambio, muestra una ruta de "mejor esfuerzo" que aún puede atravesar áreas restringidas.
- Funciones no admitidas: El enrutamiento de vehículos grandes no admite lo siguiente:
- Precios de peaje de camiones
- Límites de velocidad
- Enrutamiento para materiales peligrosos radiactivos
- Facturación: Google factura todas las solicitudes
optimizeToursde manera uniforme, independientemente de si las solicitudes configuran propiedades de enrutamiento de vehículos grandes. - Rutas de larga distancia: Las rutas de camiones de larga distancia que abarcan 500 kilómetros o más requieren más tiempo de procesamiento que las rutas más cortas y pueden mostrar datos de ruta de menor calidad. Para mantener la calidad de la ruta, limita las distancias entre los envíos, las ubicaciones de inicio y las ubicaciones de destino del vehículo. Si necesitas rutas largas, aumenta los plazos de solicitud para reducir la probabilidad de errores
DEADLINE_EXCEEDED.
Propiedades
Para usar las propiedades de enrutamiento de vehículos grandes, debes configurar un vehículo con sus dimensiones físicas y establecer su modo de enrutamiento en camión.
En la siguiente tabla, se enumeran las propiedades de nivel superior para configurar el enrutamiento de vehículos grandes:
| Propiedad | Tipo | Requisito | Descripción |
|---|---|---|---|
travelMode |
string | Obligatorio | Especifica el modo de viaje del vehículo. Para habilitar las propiedades de enrutamiento de vehículos grandes, establece este valor en TRUCK. |
routeModifiers |
objeto | Obligatorio | Contiene configuraciones específicas de la ruta, incluido vehicleInfo. |
vehicleInfo
El objeto vehicleInfo contiene las especificaciones físicas del
vehículo. Define este objeto dentro de la routeModifiers propiedad.
Es obligatorio proporcionar el objeto vehicleInfo si estableces
travelMode en TRUCK.
En la siguiente tabla, se enumeran las propiedades disponibles en el vehicleInfo
objeto:
| Propiedad | Tipo | Requisito | Descripción |
|---|---|---|---|
totalHeightMm |
integer | Obligatorio | Especifica la altura total del vehículo en milímetros. El valor debe ser un número entero positivo. |
totalWidthMm |
integer | Obligatorio | Especifica el ancho total del vehículo en milímetros. El valor debe ser un número entero positivo. |
totalWeightKg |
integer | Obligatorio | Especifica el peso total del vehículo en kilogramos. El valor debe ser un número entero positivo. |
totalLengthMm |
integer | Obligatorio | Especifica la longitud total del vehículo en milímetros. El valor debe ser un número entero positivo. |
trailerInfo |
array | Opcional | Contiene un array de especificaciones de remolque, que incluye la propiedad lengthMm para especificar la longitud de cada remolque individual en milímetros. |
totalAxleCount |
integer | Obligatorio | Especifica la cantidad total de ejes del vehículo. El valor debe ser un número entero mayor o igual que 2. |
Ejemplos
En esta sección, se abarcan dos tipos de ejemplos:
- Muestra de código que ilustra la estructura del enrutamiento de vehículos grandes
- Un ejemplo de solicitud que incluye la función.
Muestra de código
En el siguiente ejemplo, se muestra la estructura de las propiedades que se usan para el enrutamiento de vehículos grandes:
"vehicles": [ { "travelMode": "TRUCK", "routeModifiers": { "vehicleInfo": { "totalHeightMm": TOTAL_HEIGHT_MM, "totalWidthMm": TOTAL_WIDTH_MM, "totalWeightKg": TOTAL_WEIGHT_KG, "totalLengthMm": TOTAL_LENGTH_MM, "trailerInfo": [ { "lengthMm": TRAILER_LENGTH_MM } ], "totalAxleCount": TOTAL_AXLE_COUNT } } } ]
Ejemplo de solicitud
En el siguiente ejemplo, se muestra la estructura de una solicitud básica optimizeTours
que incorpora el enrutamiento de vehículos grandes:
{ "model": { "shipments": [ { "pickups": [ { "arrivalLocation": { "latitude": 40.953523, "longitude": -72.2277846 } } ], "deliveries": [ { "arrivalLocation": { "latitude": 40.9546673, "longitude": -72.2580151 } } ] } ], "vehicles": [ { "travelMode": "TRUCK", "routeModifiers": { "vehicleInfo": { "totalHeightMm": 4000, "totalWidthMm": 2500, "totalWeightKg": 9000, "totalLengthMm": 20000, "trailerInfo": [ { "lengthMm": 15000 } ], "totalAxleCount": 5 } }, "costPerKilometer": 1.0 } ] } }