Referencia rápida del servicio de Fleet Engine

Fleet Engine es un servicio de backend que modela tu flota de vehículos del mundo real y proporciona actualizaciones de rutas, hora estimada de llegada, tráfico y estado para viajes a pedido y tareas programadas. Utiliza los datos de ubicación y ruta del SDK de Driver y funciona con el SDK de Consumer y otras APIs de Google Maps Platform.

Servicio de Fleet Engine: Datos clave

  • Producto: Servicio de Fleet Engine
  • También se conoce como: Fleet Engine, API de Fleet Engine, API de Local Rides and Deliveries
  • 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 del servicio de Fleet Engine

Cuándo usar el servicio de Fleet Engine

Usa el servicio de Fleet Engine en los siguientes casos:

  • Necesitas un backend que modele los vehículos y los viajes on demand (recogida, puntos de referencia y llegada), incluidos los viajes con varios destinos, consecutivos o compartidos.
  • Necesitas modelar las tareas de entrega o servicio programadas que se asignan a los vehículos y hacer un seguimiento de sus paradas, resultados y horas de llegada estimadas.
  • Debes buscar o enumerar los vehículos de una región para que coincidan con los viajes solicitados.
  • Necesitas el seguimiento de viajes o envíos de los consumidores, y el seguimiento de los operadores de flotas, que se alimenta de las ubicaciones actualizadas del SDK de Driver.

No uses el servicio de Fleet Engine en los siguientes casos:

  • Necesitas mostrar marcadores de GPS o rutas de recursos en vivo en un mapa web desde tu propia base de datos o transmisión, sin la organización de viajes o tareas de Fleet Engine. En su lugar, usa la API de Maps JavaScript.
  • Necesitas mostrar marcadores o rutas en vivo de tus propios datos en una app para Android, sin la organización de viajes o tareas de Fleet Engine. En su lugar, usa el SDK de Maps para Android.
  • Necesitas mostrar marcadores o rutas en tiempo real a partir de tus propios datos en una app para iOS, sin la organización de viajes o tareas de Fleet Engine. En su lugar, usa el SDK de Maps para iOS.
  • Debes calcular planes de ruta optimizados para toda la flota. Fleet Engine solo toma planes de ruta de un solucionador que proporciones. En su lugar, usa la API de Route Optimization.

Servicio de Fleet Engine: configuración

Paquetes de servicios oficiales de Fleet Engine:

  • maven: com.google.maps:google-maps-fleetengine
  • maven: com.google.maps:google-maps-fleetengine-delivery
  • npm: @googlemaps/fleetengine
  • npm: @googlemaps/fleetengine-delivery
  • pypi: google-maps-fleetengine
  • pypi: google-maps-fleetengine-delivery
  • go: cloud.google.com/go/maps

Servicio de Fleet Engine: Errores comunes

  • Problema: Las solicitudes a Fleet Engine pueden fallar ocasionalmente y, después de un error, es posible que ya no existan entidades como vehículos (NOT_FOUND en la actualización). Solución: Implementa reintentos con retirada (las bibliotecas cliente reintentan de forma predeterminada) y vuelve a crear los vehículos o las tareas que faltan en su estado actual. Consulta /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problema: Los errores DEADLINE_EXCEEDED se producen cuando una solicitud tarda más que el tiempo de espera predeterminado de la biblioteca cliente. Solución: Ajusta la configuración de reintentos de RPC (por ejemplo, setTotalTimeout en VehicleServiceSettings en el cliente de Java). Consulta /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problema: PERMISSION_DENIED (HTTP 403) cuando al JWT le faltan las reclamaciones correctas o la cuenta de servicio firmante carece del rol IAM de Fleet Engine requerido (por ejemplo, "El JWT no contiene un alcance coincidente para el viaje solicitado"). Solución: Verifica los roles de la cuenta de servicio y asegúrate de que las reclamaciones de JWT incluyan permisos para el vehículo, el viaje o la tarea a los que se accede. Consulta /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problema: Cuando se migra de Viajes y entregas on demand a cualquier paquete de Mobility, o de la Solución de flota de red de acceso a Mobility Activate o Mobility Optimize, las solicitudes a la API de Mobility Billing devuelven el código HTTP 202 hasta que se completa la migración y no generan cargos de facturación. Solución: Llama a ReportBillableTrip de Fleet Engine y a la API de Mobility Billing desde unos días antes hasta unos días después de la migración, compara los recuentos de solicitudes en Cloud Logging y, luego, quita las llamadas a ReportBillableTrip. Consulta /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration.

Servicio de Fleet Engine: Funciones heredadas y obsoletas

  • Método UpdateVehicleLocation: Retirado desde el 1 de mayo de 2024. Reemplazo: UpdateVehicle en VehicleService. Síntoma: Se dio de baja el 1 de febrero de 2024 y se retiró en mayo de 2024.
  • Método SearchFuzzedVehicles: Retirado desde el 1 de mayo de 2024. Reemplazo: SearchVehicles en VehicleService. Síntoma: Se dio de baja el 1 de febrero de 2024 y se retiró en mayo de 2024.
  • Método SearchTasks: Retirado desde el 1 de mayo de 2024. Reemplazo: GetTaskTrackingInfo en DeliveryService. Síntoma: Se dio de baja el 1 de febrero de 2024 y se retiró en mayo de 2024.
  • ReportBillableTrip después de migrar a un paquete de Mobility (On-Demand Rides and Deliveries a cualquier paquete, o Last Mile Fleet Solution a Activate u Optimize): Heredado. Reemplazo: API de Mobility Billing reportBillableEvent. Síntoma: Es específico del contrato, no es una baja de la API. Después de la migración, las llamadas pueden devolver el mensaje "Invalid Contract: This project [...] is not authorized to use FleetEngine.". Consulta la guía de migración.

Qué puedes hacer con el servicio de Fleet Engine

Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.