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
- Servicio que se habilitará:
fleetengine.googleapis.com - Autenticación: Cuenta de servicio, JSON Web Token (JWT), OAuth 2.0
- Atribución de uso: Función beta opcional: Establece el encabezado HTTP
X-Goog-Maps-Experience-IDen el ID de transacción de Mobility (o un ID relacionado, como un ID de sesión) en las llamadas a los servicios del paquete de Mobility. Separa varios IDs con comas. Pasa los IDs relacionados enrelated_idscuando informes la transacción. - Primeros pasos: Configura el servicio de Fleet Engine
- Referencia: Referencia del servicio de Fleet Engine
- Políticas: Políticas del servicio de Fleet Engine
- Notas de la versión: Notas de la versión del servicio de Fleet Engine
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: productos relacionados
- Se suele usar con: SDK de Driver para Android, SDK de Driver para iOS, SDK de Consumer para Android, SDK de Consumer para iOS, SDK de Consumer para JavaScript y API de Route Optimization
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_FOUNDen 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_EXCEEDEDse 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,setTotalTimeoutenVehicleServiceSettingsen 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
ReportBillableTripde 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 aReportBillableTrip. 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:UpdateVehicleenVehicleService. 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:SearchVehiclesenVehicleService. 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:GetTaskTrackingInfoenDeliveryService. Síntoma: Se dio de baja el 1 de febrero de 2024 y se retiró en mayo de 2024. ReportBillableTripdespué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 BillingreportBillableEvent. 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.
- Informa el uso de viajes facturables de Fleet Engine.
- Crea y devuelve un viaje nuevo de Fleet Engine.
- Devuelve información sobre un viaje de Fleet Engine.
- Muestra una lista de todos los viajes de Fleet Engine para un vehículo específico.
- Actualiza los datos de un viaje de Fleet Engine.
- Crea una instancia de un vehículo nuevo en Fleet Engine asociado con un proveedor de viajes compartidos o entregas a pedido.
- Devuelve un vehículo del servicio de Fleet Engine.
- Devuelve una lista paginada de vehículos en Fleet Engine asociados con un proveedor que coinciden con los criterios especificados.
- Devuelve una lista de vehículos en Fleet Engine que coinciden con los criterios especificados.
- Actualiza los datos de un vehículo en Fleet Engine.
- Actualiza los atributos de un vehículo en Fleet Engine.
- Devuelve información del viaje de un vehículo desde el servicio de Fleet Engine.