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 información esencial 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 en tu operación en el mundo real. Los 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. 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 funciones de tareas programadas y on demand, debes emitir un mensaje de solicitud con campos que se resumen de la siguiente manera para crear y actualizar un vehículo:
- El elemento superior: Es una cadena asociada con el ID de tu proyecto de Google Cloud que se usa para propagar el campo de nombre de la instancia del vehículo.
El ID del vehículo: Es una cadena única que se usa para propagar el campo
namedel vehículo.Una instancia de vehículo con sus campos obligatorios Estos campos dependen de la función 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 que se usa 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 Configura Fleet Engine.
Campos de recursos de vehículos
Un recurso de vehículo tiene los siguientes tipos de campos:
- Campos de solo salida: Son campos que el servicio establece como un resultado de otro método y no se pueden configurar directamente. Un campo importante de este tipo es el campo
name. Fleet Engine ignora cualquier valor proporcionado para el camponamedel vehículo según las instrucciones de la AIP de Google para los IDs especificados por el usuario. Si proporcionas valores para estos campos, el motor de flotas muestra un error. - Campos obligatorios. Los vehículos creados en el servicio de viajes a pedido requieren que se configuren ciertos campos durante su 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 configurar durante la creación o después. Puedes encontrarlas en la guía de referencia correspondiente 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 configuras cuando lo creas:
El elemento superior: Es una cadena asociada con el ID de tu proyecto de Google Cloud del 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 superior.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.
El ID del vehículo, que debe ser único para todos los vehículos de tu flota y ser una cadena Unicode válida. Este es el ID de recurso del vehículo. Tanto los viajes a pedido como las paradas programadas usan esto 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 recursos como cadenas. Consulta Nombres de recursos en Fleet Engine para obtener más detalles.
Identificadores de entidades únicos
El formato y el valor de los identificadores de entidades únicos 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 volver a usarlo en días hábiles posteriores sin tener que crear uno nuevo. Cada vez que reutilizas un vehículo, Fleet Engine restablece su disponibilidad, y en ese momento, la cuenta regresiva de 7 días comienza de nuevo.
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 solo información de depuración que Fleet Engine no conserva. Actualizarlos no prolonga la vida útil de la entidad Vehicle.
Para mejorar las estadísticas del sistema, es mejor volver a usar la misma vinculación del ID del conductor y el vehículo todos los días. Para ello, usa el mismo ID de vehículo asociado con el conductor para las paradas programadas anteriores o los viajes a pedido.