Para obtener información general sobre cómo funcionan los vehículos en Fleet Engine, consulta las siguientes guías en la sección Elementos esenciales de Fleet Engine:
En la documentación de esta sección, se describe cómo crear y administrar vehículos en Fleet Engine. Los vehículos se crean en el entorno del servidor de Fleet Engine para reflejar los vehículos reales de tu operación en el mundo real. Tus vehículos de Fleet Engine también deben corresponder a los que se usan en tu sistema de backend que usas para las asignaciones y el enrutamiento de vehículos.
Usas un método de creación para crear un recurso de vehículo, ya sea con gRPC o REST. Los nombres de los campos de esta guía usan la notación gRPC para simplificar.
Viajes a pedido
CreateVehicleRequest(gRPC)providers.vehicle.create(REST)- Recurso
Vehicle(REST, gRPC)
Tareas programadas
CreateDeliveryVehicleRequest(gRPC)providers.deliveryVehicles.create(REST)DeliveryVehicle(REST, gRPC)
Solicitudes de vehículos
Para las capacidades de tareas a pedido y programadas, creas y actualizas un vehículo emitiendo un mensaje de solicitud con campos, que se resumen de la siguiente manera:
- El elemento superior: Es una cadena asociada con el ID de tu proyecto de Google Cloud, que se usa para propagar el campo name de la instancia del vehículo.
El ID del vehículo: Es una cadena única que se usa para propagar el
namecampo del vehículo.Una instancia de vehículo con sus campos obligatorios. Estos campos dependen de la capacidad de Fleet Engine que uses.
La información del cuerpo de la solicitud varía según la naturaleza de la solicitud. Consulta esos detalles en sus respectivas guías.
Tokens de autenticación y autorización
Las solicitudes a Fleet Engine también deben proporcionar las credenciales de acceso correctas. En los ejemplos de esta guía, se incluyen los siguientes supuestos:
- Los ejemplos de gRPC suponen el uso de la biblioteca de autorización para Java.
- Los ejemplos de REST ilustran un encabezado de solicitud HTTP, que debe contener el
campo
Authorizationcon un valor deBearer <token>donde<token>es un token web JSON que emites.
Para obtener más detalles, consulta las guías de configuración de Fleet Engine.
Campos de recursos de vehículos
Un recurso de vehículo tiene los siguientes tipos de campos:
- Campos de solo salida. Campos que el servicio establece como resultado de otro método y que no se pueden establecer directamente. Un campo importante de este tipo es el campo
name. Fleet Engine ignora cualquier valor proporcionado para elnamecampo del vehículo según las instrucciones de Google AIP para los IDs especificados por el usuario. Si proporcionas valores para estos campos, Fleet Engine muestra un error. - Campos obligatorios. Los vehículos creados en el servicio de viajes a pedido requieren que se establezcan ciertos campos en la creación. Los vehículos creados en el servicio de tareas programadas no tienen campos de recursos de vehículos obligatorios.
- Campos opcionales. Ambos servicios tienen campos que puedes establecer en la creación o después. Estos se pueden encontrar en la guía de referencia respectiva del servicio que usas.
Nombre del vehículo (solo salida)
El campo name es exactamente el mismo para los viajes a pedido y los servicios de tareas programadas. Fleet Engine define el campo cuando creas el vehículo, según dos campos que estableces en la creación del vehículo:
El elemento superior: Es una cadena asociada con el ID de tu proyecto de Google Cloud con el formato
providers/{provider}, en el que{provider}es el ID de tu proyecto de Cloud. Cada vehículo que crees para un proyecto determinado tendrá la misma ruta de acceso superior.El proyecto de Cloud al que haces referencia aquí también debe contener los roles de cuenta de servicio de Fleet Engine para el servicio que usas. Consulta Cuentas de servicio para obtener una lista de esas cuentas de servicio. Fleet Engine no admite el acceso desde varios proyectos de Google Cloud.
El ID del vehículo, que debe ser único en todos los vehículos de tu flota y ser una cadena Unicode válida. Este es el ID de recurso del vehículo. Los viajes a pedido y las paradas programadas lo usan para asociar un viaje o una tarea con el vehículo que lo completa.
En los servicios basados en Google Cloud, todas las APIs deben representar los recursos como cadenas. Consulta Nombres de recursos en Fleet Engine para obtener más detalles.
Identificadores únicos de entidades
El formato y el valor de los identificadores únicos de entidades que se usan en las llamadas de recursos son opacos para Fleet Engine. Asegúrate de que el identificador no contenga información de identificación personal (PII), como el número de teléfono del conductor.
Reutilización de vehículos
Después de que un vehículo completa todas las paradas de un itinerario determinado, permanece disponible para su reutilización en Fleet Engine durante 7 días, lo que significa que puedes reutilizar un vehículo en los días hábiles posteriores sin tener que crear uno nuevo. Cada vez que reutilizas un vehículo, Fleet Engine restablece su disponibilidad, momento en el que comienza de nuevo la cuenta regresiva de 7 días.
El enfoque recomendado para mantener un vehículo disponible en Fleet Engine es actualizar su ubicación a intervalos regulares. Las actualizaciones de la mayoría de los otros campos de la entidad Vehicle también extenderán su vida útil, siempre que el valor del campo nuevo sea diferente del existente.
NOTA: Algunos campos de la entidad Vehicle, como device_settings, son información de depuración pura que Fleet Engine no conserva. Actualizarlos no extiende la vida útil de la entidad Vehicle.
Para mejorar el análisis del sistema, es mejor reutilizar el mismo par de ID de conductor y vehículo día a día. Para ello, usa el mismo ID de vehículo asociado con el conductor para las paradas programadas anteriores o los viajes a pedido.