Referencia rápida de la API de Route Optimization

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 injectedFirstSolutionRoutes o injectedSolutionConstraint.
  • 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

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: Errores comunes

  • Problema: En el caso de las llamadas de REST al extremo OptimizeTours de bloqueo, el plazo predeterminado de 60 segundos anula cualquier timeout del cuerpo de la solicitud que supere los 60 segundos. Solución: Configura el encabezado X-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 timeout y de fecha límite tienen un límite de 1,800 segundos. Solución: Establece allowLargeDeadlineDespiteInterruptionRisk en true para 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, costPerHour o costPerKilometer), 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.