La API de Route Optimization asigna tareas y rutas a una flota de vehículos, y optimiza en función de los objetivos y las restricciones que proporciones, como los períodos, la capacidad de los vehículos, las horas de los conductores y los costos. La llamas a través de REST, gRPC o bibliotecas cliente, y devuelve secuencias de visitas, asignaciones de envíos, tiempos estimados y métricas de rutas.
API de Route Optimization: Datos clave
- Producto: API de Route Optimization
- También conocido como: GMPRO
- Categoría: Rutas
- Plataforma: Servicio web (REST)
- Se ejecuta en: Servidor (código de backend)
- Etapa de lanzamiento: GA
- Ciclo de vida: Activo
- Descripción general: Descripción general de la API de Route Optimization
API de Route Optimization: Cuándo usarla
Usa la API de Route Optimization en los siguientes casos:
- Debes asignar envíos o tareas a varios vehículos respetando los períodos, la capacidad de los vehículos, las horas de los conductores y los costos.
- Necesitas la mejor secuencia de paradas para un vehículo con varias recogidas, entregas o citas.
- Debes volver a optimizar las rutas activas para los pedidos nuevos (como el envío a pedido) con
injectedFirstSolutionRoutesoinjectedSolutionConstraint. - Necesitas tokens de ruta para cada tramo de un plan optimizado para pasarlos al SDK de Navigation.
No uses la API de Route Optimization en los siguientes casos:
- Necesitas un seguimiento en vivo de cómo los conductores ejecutan el plan. La API devuelve polilíneas planificadas, no rutas de vehículos en tiempo real. En su lugar, usa el servicio de Fleet Engine.
- Necesitas instrucciones paso a paso en la app para los conductores a lo largo de la ruta optimizada. En su lugar, usa el SDK de Navigation para Android.
- Necesitas orientación paso a paso en la app para los conductores en iOS a lo largo de la ruta optimizada. En su lugar, usa el SDK de Navigation para iOS.
API de Route Optimization: Configuración
- Servicio que se habilitará:
routeoptimization.googleapis.com - Autenticación: OAuth 2.0, cuenta de servicio
- Comienza a usar la API de Route Optimization: Configura la API de Route Optimization
- Referencia: Referencia de la API de Route Optimization
- Precios: Uso y facturación de la API de Route Optimization
- Políticas: Políticas de la API de Route Optimization
- Notas de la versión: Notas de la versión de la API de Route Optimization
Paquetes oficiales de la API de Route Optimization:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
API de Route Optimization: Productos relacionados
- Se suele usar con: SDK de Navigation para Android, SDK de Navigation para iOS, servicio de Fleet Engine y API de Maps JavaScript
API de Route Optimization: Errores comunes
- Problema: En el caso de las llamadas de REST al extremo
OptimizeToursde bloqueo, el plazo predeterminado de 60 segundos anula cualquiertimeoutdel cuerpo de la solicitud que supere los 60 segundos. Solución: Configura el encabezadoX-Server-Timeout(segundos, sin el sufijo "s") para extender el plazo. Las bibliotecas cliente y gRPC se establecen de forma predeterminada en 3,600 segundos. Consulta /maps/documentation/route-optimization/timeouts. - Problema: Los valores de
timeouty de fecha límite tienen un límite de 1,800 segundos. Solución: EstableceallowLargeDeadlineDespiteInterruptionRiskentruepara permitir hasta 3,600 segundos, lo que acepta un mayor riesgo de errores de interrupción. Consulta /maps/documentation/route-optimization/timeouts. - Problema: Sin parámetros de costo (por ejemplo,
costPerHourocostPerKilometer), el optimizador trata todas las soluciones como iguales. Solución: Define parámetros de costo en los vehículos que reflejen los costos de tu empresa. Consulta /maps/documentation/route-optimization/make-first-request. - Problema: Las solicitudes autenticadas con una clave de API fallan; cada solicitud necesita un token de OAuth. Solución: Usa un token de OAuth con el permiso
https://www.googleapis.com/auth/cloud-platform, por ejemplo, a través de las credenciales predeterminadas de la aplicación o una cuenta de servicio. Consulta /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token.
Qué puedes hacer con la API de Route Optimization
Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.
- Devuelve un plan de entrega con varias paradas, optimizado según las restricciones especificadas de ruta, costo, envío y vehículo.
- Devuelve las horas de inicio y finalización de cada parada en un plan de entrega optimizado.
- Devuelve las duraciones de viaje, retraso, descanso y espera entre cada parada de un plan de entrega optimizado.
- Devuelve información sobre la carga del vehículo en cada parada de un plan de entrega optimizado.
- Devuelve información de costos para cada envío en un plan de entrega optimizado.
- Devuelve una polilínea codificada para la ruta entre cada parada de un plan de entrega optimizado.
- Devuelve un token de ruta de navegación para la ruta entre cada parada de un plan de entrega optimizado.
- Muestra las métricas agregadas de envío, vehículo y costo para un plan de entrega optimizado.
- Especificar el período de inicio y finalización de un plan de entrega con varias paradas
- Especifica la disponibilidad de la hora de inicio y finalización, y las ubicaciones de cada vehículo en un plan de entrega con varias paradas.
- Especificar los costos de tiempo de cada vehículo en un plan de entrega con varias paradas
- Especificar los parámetros del modelo de costos para un plan de entrega con varias paradas
- Especifica las restricciones de tiempo de retiro y tiempo de entrega para cada envío en un plan de entrega con varias paradas.
- Especificar las asignaciones de vehículos para un plan de entrega con varias paradas
- Especifica los límites de carga para cada vehículo en un plan de entrega con varias paradas.
- Especifica si se debe considerar la información del tráfico en tiempo real para un plan de entrega con varias paradas.
- Procesa por lotes una solicitud de optimización de un plan de entregas con varias paradas y escribe la respuesta en Google Cloud Storage.
- Reserva tiempo para estacionar antes de realizar las entregas.
- Prioriza las visitas cercanas para que se realicen de forma consecutiva.
- Evita dar vuelta en U en una ruta de vehículo con varias paradas. Experimental Nota: Esta es una función experimental sujeta a las condiciones y limitaciones de la fase previa a la DG.
- Realiza optimizaciones en función de objetivos predefinidos. Experimental Nota: Esta es una función experimental sujeta a las condiciones y limitaciones de la fase previa a la DG.
- Entrega primero los envíos más pesados. Experimental Nota: Esta es una función experimental sujeta a las condiciones y limitaciones de la fase previa a la DG.