¿Qué es el servicio Fleet Engine?

Fleet Engine es un servicio de backend que se integra con el sistema que usas para administrar los servicios de transporte para tus clientes. Interopera con una variedad de APIs y SDKs para mejorar la administración de mapas, rutas y ubicaciones.

Fleet Engine proporciona actualizaciones de rutas y estados para las entidades de vehículos modeladas en tu flota de vehículos del mundo real. A medida que tu sistema envía actualizaciones del progreso del vehículo a Fleet Engine, este usa la ubicación del vehículo en tiempo real y la información de ruta que proporciona el SDK de Driver para proporcionar informes precisos sobre los viajes del vehículo: ETAs, información del tráfico y disponibilidad del vehículo.

Fleet Engine

El servicio de Fleet Engine funciona con las siguientes ofertas de Mobility Service:

  • Viajes a pedido: En esta oferta, Fleet Engine modela el ciclo de vida de un viaje, desde el origen, pasando por las paradas, hasta el destino. En un ciclo de vida de viaje, un vehículo pasa por ubicaciones de partida, puntos de referencia intermedios y ubicaciones de destino como medio para completar un viaje reservado por una solicitud del consumidor. Consulta la documentación de Viajes a pedido para obtener detalles sobre los viajes a pedido.
  • Tareas programadas: En esta oferta, Fleet Engine modela el ciclo de vida de una tarea de entrega o servicio, en la que cada parada a lo largo de un viaje requiere que el conductor complete una o más tareas programadas. Las tareas pueden incluir entregar un paquete o completar una llamada de servicio. Consulta la documentación de Tareas programadas para obtener detalles sobre las tareas programadas.

Qué puedes hacer con Fleet Engine

Con los componentes de Fleet Engine, puedes hacer lo siguiente:

  • Habilitar el seguimiento de viajes del consumidor: Para los viajes a pedido, puedes usar las capacidades de experiencia del consumidor de Fleet Engine y, luego, integrar el SDK de Consumer en tus apps web o para dispositivos móviles. De esta manera, tus consumidores pueden usar la misma app para realizar una solicitud de viaje y hacer un seguimiento de su viaje.
  • Proporcionar información de paquetes en tiempo real a los clientes: Para las tareas programadas, puedes usar las capacidades de experiencia del consumidor de Fleet Engine y, luego, integrar el SDK de Consumer de JavaScript en tu app web. Esto puede proporcionar a tus consumidores actualizaciones casi en tiempo real sobre el estado de sus paquetes. El SDK proporciona filtros integrados y privacidad de los datos para que los consumidores solo vean la información pertinente a su pedido.
  • Diseñar soluciones para operadores de flotas: Para las tareas programadas, usa la biblioteca de seguimiento de flotas de JavaScript para que los operadores de tu flota puedan coordinar y administrar mejor las asignaciones de vehículos durante todo el día.
  • Mejorar la experiencia de tus conductores: El SDK de Driver es un kit de herramientas para apps para dispositivos móviles y un componente fundamental de Fleet Engine. Usa la funcionalidad de los vehículos. Con este SDK, tu app de conducción puede administrar las asignaciones de trabajo y habilitar las capacidades de navegación y ruta del conductor. En esencia, el SDK usa un objeto de escucha de eventos para enviar actualizaciones de ubicación a Fleet Engine cuando el conductor comienza a conducir. También envía señales a Fleet Engine sobre el estado del vehículo. Con este SDK, el conductor puede usar una sola app para administrar las asignaciones y navegar como lo haría con su versión para consumidores de Google Maps, pero sin tener que cambiar a otra app.

Más específicamente, puedes proporcionar lo siguiente con estas soluciones:

Viajes a pedido

  • La posición en tiempo real del vehículo del conductor ajustada a la ruta
  • La ruta real del conductor con información del tráfico en tiempo real
  • La hora estimada de llegada para las ubicaciones de partida y destino
  • Seguimiento de viajes de un solo destino, de varios destinos y consecutivos
  • Viajes compartidos para varios clientes en la misma ruta
  • Lista de todos los vehículos dentro de una región específica para encontrar las mejores coincidencias para los viajes solicitados

Tareas programadas

  • Actualizaciones de ubicación en tiempo real renderizadas en el mapa
  • ETAs ajustadas automáticamente que reflejan las circunstancias cambiantes, como el tráfico
  • Tareas completadas y paradas pendientes para proporcionar información sobre posibles problemas
  • La cantidad de paradas y la distancia para que los clientes tengan más confianza.

Cómo funciona Fleet Engine

En esta sección, se describe una descripción general de las operaciones de los sistemas de Fleet Engine para cada oferta de Mobility.

Viajes a pedido

En el siguiente diagrama, se muestran dos partes clave de los viajes a pedido: el comienzo del día cuando los conductores habilitan el uso compartido de la ubicación en Fleet Engine y una vista simplificada de la administración de viajes con los componentes de Fleet Engine. Para obtener una vista detallada del proceso de viaje, consulta ¿Qué es un viaje? en la documentación de Viajes a pedido.

Tareas programadas

En el siguiente diagrama, se muestra una matriz de un día laboral típico de envío para un solo conductor, junto con la forma en que se maneja su trabajo en el sistema de Fleet Engine con la biblioteca de seguimiento de flotas.

Nota: Tu sistema puede usar el seguimiento de envíos o el seguimiento de flotas. Con seguimiento de envíos, Fleet Engine filtra la información del envío y del conductor para que un cliente solo vea la información pertinente a su envío.

Arquitectura de Fleet Engine

En esta sección, se proporciona una arquitectura del sistema para las diferentes ofertas de Fleet Engine. Ambos servicios usan lo siguiente:

  • Un vehículo: Los viajes a pedido y las tareas programadas dependen de un vehículo como medio para modelar los vehículos del mundo real en tu empresa que se usan para llevar a cabo tus operaciones. En Fleet Engine, una entidad de vehículo recibe información de ubicación que proporciona su vehículo del mundo real asociado a través de la app para conductores integrada con el SDK de Driver. Los vehículos de Fleet Engine son entidades en gran medida paralelas entre los dos servicios, con algunas diferencias. Lee Introducción a los vehículos para comprender los vehículos en Fleet Engine.
  • El SDK de Driver: Para las tareas a pedido y programadas, el SDK de Driver es un componente fundamental. El SDK de Driver se integra con tu app para conductores y proporciona a Fleet Engine una transmisión de actualizaciones de ubicación junto con información de ruta en la que Fleet Engine se basa para informar el estado en tiempo real del viaje, junto con otra información, como la ETA y los datos del tráfico.
  • El SDK de Consumer: Un beneficio clave para las tareas a pedido y programadas es el SDK de Consumer, que se usa para informar al consumidor el estado de su viaje, la entrega de comida o la entrega de paquetes programada.

Viajes a pedido

Para obtener una explicación sobre los vehículos, los viajes y los SDKs, consulta la documentación relacionada con los viajes a pedido:

  1. Introducción a los vehículos
  2. Viajes a pedido
  3. SDK de Driver para viajes a pedido
  4. SDK de Consumer para viajes a pedido

Tareas programadas

Para obtener una explicación sobre los vehículos de entrega, las tareas y los SDKs, consulta la documentación relacionada con las tareas programadas:

  1. Introducción a los vehículos
  2. Tareas programadas
  3. SDK de Driver para tareas programadas
  4. SDK de Consumer para tareas programadas

Recursos

Viajes a pedido

Vehículo
Servicios REST: v1.providers.vehicles
gRPC: maps.fleetengine.v1.VehicleService
Nombre del recurso providers/{provider}/vehicles/{vehicle}
Viaje
Servicios REST: v1.providers.trips
gRPC: maps.fleetengine.v1.TripService
Nombre del recurso providers/{provider}/trips/{trip}

Tareas programadas

Vehículo de entrega
Recursos REST: providers.deliveryVehicles
gRPC: maps.delivery.v1
Nombre del recurso providers/{provider}/deliveryVehicles/{vehicle}
Tarea
Servicios REST: providers.tasks
gRPC: maps.fleetengine.delivery.v1.Task
Nombre del recurso providers/{provider}/tasks/{task}

Nombres de recursos en Fleet Engine

En Fleet Engine, como en todos los servicios basados en Google Cloud, los recursos tienen identificadores únicos llamados names, que se proporcionan en formato de cadena. Parte de ese nombre de recurso es un ID de recurso, que proporcionas cuando emites una solicitud de creación. Sin embargo, los recursos de Fleet Engine no tienen un campo de ID, sino un campo de nombre de solo salida, que incluye el ID de recurso.

Fleet Engine usa nombres de recursos relativos. Estos constan de IDs de colección y IDs de recurso, estructurados de una manera que indica su jerarquía.

  • Un ID de colección: Una colección contiene recursos u otras colecciones.

Viajes a pedido

Tres colecciones: providers, vehicles, y trips.

Tareas programadas

Tres colecciones: providers, deliveryVehicles, y tasks.

Un ID de recurso: Los identificadores de recursos en la documentación de referencia se indican con llaves en el campo de nombre. Estas son variables para los IDs que proporcionas cuando emites una solicitud de creación.

Viajes a pedido

  • {provider}: El ID de tu proyecto de Cloud. Se crea una vez por proyecto.
  • {vehicle}: Tu recurso de vehículo, que se usa para cada creación de vehículo y, por lo general, se vuelve a usar para el mismo par de conductor y vehículo.
  • {trip}: Tu recurso de viaje, que se usa para cada viaje y, por lo general, no se vuelve a usar.

Tareas programadas

  • {provider}: El ID de tu proyecto de Cloud. Se crea una vez por proyecto.
  • {vehicle}: Tu recurso de vehículo de entrega, que se usa para cada creación de vehículo y, por lo general, se vuelve a usar para el mismo par de conductor y vehículo.
  • {task}: Tu recurso de tarea, que se usa para cada tarea y, por lo general, no se vuelve a usar.

Consulta Nombres de recursos en la documentación de las APIs de Cloud de Google para obtener más detalles.

Registros de Google Cloud para Fleet Engine

Fleet Engine ofrece un servicio de registro básico que te permite guardar sus solicitudes de API y cargas útiles de respuesta. Con estos registros, puedes depurar tu integración, crear métricas de supervisión y analizar patrones de tráfico.

Consulta Cloud Logging para obtener más detalles.

Cómo usar Fleet Engine

1 Configura tu proyecto de Cloud.

En este paso, creas una variedad de roles de cuenta de servicio, además de habilitar las APIs relacionadas.

Las APIs y los SDKs de Fleet Engine requieren el uso de tokens web JSON (JWTs) que se firmaron con cuentas de servicio creadas desde Cloud Console. Sigue instrucciones en Crea tu proyecto de Fleet Engine. Para comprender mejor estos roles, lee los roles de cuenta de servicio.

2 Verifica tu configuración Después de crear cuentas de servicio, verifica que la configuración esté completa y que puedas crear un vehículo. Este paso garantiza que hayas abordado los problemas de autorización comunes que pueden surgir durante la configuración del proyecto. Sigue las instrucciones en Cómo verificar tu configuración.
3 Crea tu primer viaje Esto implica crear un solo vehículo con un conjunto de coordenadas que representan paradas a lo largo de un viaje a pedido o tareas programadas. Consulta el contenido general de Viajes a pedido o Tareas programadas para obtener más información.
4 Prueba tu integración Los servicios y componentes de Fleet Engine requieren datos en tiempo real de una flota de vehículos. El diseño, el desarrollo y la implementación de apps para una flota de conductores pueden llevar tiempo. Por este motivo, es mejor usar primero datos simulados para explorar tu integración antes de realizar una implementación a gran escala. Consulta Configura Fleet Engine para obtener más detalles.

¿Qué sigue?

  1. Comprende los vehículos de Fleet Engine.
  2. Obtén información sobre los viajes a pedido o las tareas programadas.
  3. Configura Fleet Engine.