Para obtener información general sobre cómo funcionan los vehículos en Fleet Engine, consulta la guías de 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 los vehículos reales en tu operación real. Tu flota de motor los vehículos también deben corresponder a los usados en tu sistema backend que usar para las asignaciones de vehículos y la planificación de rutas.
Debes usar un método de creación para crear un recurso de vehículo, ya sea con gRPC o REST. Los nombres de los campos en esta guía usan la notación de gRPC para simplificar.
Viajes on demand
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, puedes crear y actualizar un vehículo con la emisión de un mensaje de solicitud con campos, que se resumen de la siguiente manera:
- El superior: Es una cadena asociada con el ID de tu proyecto de Google Cloud, que para propagar el campo de nombre de la instancia del vehículo.
El ID del vehículo: Una cadena única que se usa para propagar el archivo
namecampo del vehículo.Una instancia de vehículo con sus campos obligatorios. Estos campos dependen del la capacidad de Fleet Engine que uses.
La información que se incluye en el cuerpo de la solicitud varía según su naturaleza. 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. Los ejemplos de esta guía tienen las siguientes suposiciones:
- 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 una El 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. Los campos que el servicio establece como una salida del
otro método y no se pueden configurar directamente. Un campo importante de esto
tipo es el campo
name. Fleet Engine ignora cualquier valor proporcionado para el Camponamedel vehículo, según las indicaciones de la AIP de Google para especificado por el usuario IDs. Si proporcionas valores para estos campos, Fleet Engine devuelve un error. - Campos obligatorios: Los vehículos creados en el servicio de viajes a pedido requieren que ciertos campos se configuren en el momento de su creación. Vehículos creados en el horario programado servicio de tareas no tiene campos obligatorios de recursos de vehículos.
- Campos opcionales. Ambos servicios tienen campos que puedes configurar al crearlos. o después. Estos se pueden encontrar en la guía de referencia respectiva de la servicio que usas.
Nombre del vehículo (solo salida)
El campo name es exactamente igual para los viajes a pedido y para las tareas programadas.
de Google Cloud. Fleet Engine define el campo cuando creas el vehículo, en función de
dos campos que configuraste al momento de crear el vehículo:
El superior: Es una cadena asociada con el ID de tu proyecto de Google Cloud de formulario
providers/{provider}, en el que{provider}es el ID de tu instancia en un proyecto final. Cada vehículo que crees para un proyecto determinado tendrá el mismo ruta de acceso superior.El proyecto de Cloud al que hagas referencia aquí también debe contener el directorio de Fleet Engine roles de cuenta de servicio para el servicio que usas. Consulta Cuentas de servicio para 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 y sea una cadena Unicode válida. Este es el ID de recurso de la vehículo. Tanto los viajes on demand 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 los recursos como cadenas. Consulta Asignación de nombres de recursos en Fleet Engine para obtener más detalles.
Identificadores de entidad única
El formato y el valor de los identificadores de entidades únicos que se usan en las llamadas a recursos son opaco a 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 del vehículo
Una vez que un vehículo completa todas las paradas de un itinerario determinado, permanece disponible para volver a utilizarlo en Fleet Engine durante 7 días, lo que significa que puedes reutilizar un vehículo en días hábiles posteriores sin la necesidad de crear uno nuevo. Cada vez que volver a usar un vehículo, Fleet Engine restablece su disponibilidad. A partir de ese momento, La cuenta regresiva de 7 días comenzará de nuevo.
El enfoque recomendado para mantener disponible un vehículo en Fleet Engine es
actualizar su ubicación a intervalos regulares. Las actualizaciones de la mayoría de los otros campos del
La entidad Vehicle también extenderá su vida útil, siempre que se cumpla el siguiente valor del campo nuevo:
diferente del existente.
NOTA: Algunos campos de la entidad Vehicle, como device_settings, son puramente depurados.
que no persiste en Fleet Engine. Actualizarlos no
extender la vida útil de la entidad Vehicle
Para mejorar las estadísticas del sistema, se recomienda volver a usar el mismo ID de vehículo y conductor la vinculación diaria. Para ello, usa el mismo ID de vehículo asociado con al conductor para las paradas programadas anteriores o los viajes on demand.