Para obtener información general sobre cómo funcionan los vehículos en Fleet Engine, consulta las siguientes guías en la sección de aspectos básicos de Fleet Engine:
En la documentación de esta sección, se describe cómo crear y administrar vehículos en Fleet Engine. Creas vehículos 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 utilizas para las asignaciones de vehículos y la planificación de rutas.
Usas un método de creación para crear un recurso de vehículo, ya sea con gRPC o REST. Para simplificar, los nombres de los campos de esta guía usan la notación de gRPC.
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 programadas y a pedido, debes crear y actualizar un vehículo con un mensaje de solicitud que incluya campos, resumidos de la siguiente manera:
- El elemento superior: Es una cadena asociada con el ID de tu proyecto de Google Cloud que se usa para completar el campo de nombre de la instancia del vehículo.
El ID del vehículo: Es una cadena única que se usa para completar el campo
namedel vehículo.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 hacen las siguientes suposiciones:
- En los ejemplos de gRPC, se supone 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. Son los campos que el servicio establece como resultado de otro método y no se pueden establecer directamente. Un campo importante de este tipo es el campo
name. Fleet Engine ignora cualquier valor proporcionado para el camponamedel vehículo según la orientación de la AIP de Google para los IDs especificados por el usuario. Si proporcionas valores para estos campos, Fleet Engine devolverá un error. - Campos obligatorios. Los vehículos creados en el servicio de viajes a pedido requieren que se configuren ciertos campos en el momento de la creación. Los vehículos creados en el servicio de tareas programadas no tienen campos obligatorios de recursos de vehículos.
- Campos opcionales. Ambos servicios tienen campos que puedes configurar durante la creación o después. Puedes encontrarlos en la guía de referencia correspondiente al servicio que utilizas.
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, en función de dos campos que configuras cuando creas el vehículo:
El elemento superior: Es una cadena asociada al 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 principal.El proyecto de Cloud al que haces referencia aquí también debe contener los roles de la 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.
ID del vehículo, que debe ser único para todos los vehículos de tu flota y ser una cadena Unicode válida. Es el ID de recurso del vehículo. Tanto los viajes a pedido como las paradas programadas usan este campo para asociar un viaje o una tarea con el vehículo que los 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 a 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 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 demás 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 solo información de depuración que Fleet Engine no conserva. Actualizarlos no extiende la vida útil de la entidad Vehicle.
Para mejorar las estadísticas del sistema, es mejor volver a usar la misma vinculación de ID de conductor y vehículo día tras 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.