Introduzione: creare veicoli

Per informazioni generali su come funzionano i veicoli in Fleet Engine, consulta le seguenti guide nella sezione Nozioni di base di Fleet Engine:

La documentazione in questa sezione descrive come creare e gestire i veicoli in Fleet Engine. Crea i veicoli nell'ambiente server di Fleet Engine per rispecchiare i veicoli effettivi della tua attività nel mondo reale. I veicoli di Fleet Engine devono corrispondere anche a quelli utilizzati nel sistema di backend per le assegnazioni e il routing dei veicoli.

Utilizza un metodo di creazione per creare una risorsa veicolo, utilizzando gRPC o REST. Per semplicità, i nomi dei campi in questa guida utilizzano la notazione gRPC.

Viaggi on demand

CreateVehicleRequest (gRPC)
providers.vehicle.create (REST)
Risorsa Vehicle (REST, gRPC)

Attività pianificate

CreateDeliveryVehicleRequest (gRPC)
providers.deliveryVehicles.create (REST)
DeliveryVehicle (REST, gRPC)

Richieste di veicoli

Per le funzionalità di viaggi on demand e attività pianificate, crea e aggiorna un veicolo inviando un messaggio di richiesta con i campi, riassunti di seguito:

Il parent: una stringa associata all'ID progetto Google Cloud, utilizzata per popolare il campo name dell'istanza del veicolo.
L'ID del veicolo: una stringa univoca utilizzata per popolare il name campo del veicolo.

Nota: le stringhe ID veicolo hanno determinate limitazioni di caratteri. Evita gli ID con incremento automatico e assicurati che non contengano informazioni che consentono l'identificazione personale. Per i dettagli sulle limitazioni dei caratteri, consulta il campo ID veicolo per CreateVehicleRequest o CreateDeliveryVehicleRequest.
Un'istanza del veicolo con i relativi campi obbligatori. Questi campi dipendono dalla funzionalità di Fleet Engine che utilizzi.

Le informazioni nel corpo della richiesta variano in base alla natura della richiesta. Per i dettagli, consulta le rispettive guide.

Token di autenticazione e autorizzazione

Le richieste a Fleet Engine devono fornire anche le credenziali di accesso corrette. Gli esempi in questa guida si basano sulle seguenti ipotesi:

Gli esempi gRPC presuppongono l'utilizzo della libreria di autorizzazione per Java.
Gli esempi REST illustrano un'intestazione della richiesta HTTP, che deve contenere il campo Authorization con un valore Bearer <token> dove <token> è un token web JSON che emetti.

Per maggiori dettagli, consulta le guide alla configurazione di Fleet Engine.

Campi delle risorse veicolo

Una risorsa veicolo ha i seguenti tipi di campi:

Campi di solo output. Campi impostati dal servizio come output di un altro metodo e non possono essere impostati direttamente. Un campo importante di questo tipo è il campo name. Fleet Engine ignora qualsiasi valore fornito per il name campo del veicolo in base alle indicazioni di Google AIP per gli ID specificati dall'utente. Se fornisci valori per questi campi, Fleet Engine restituisce un errore.
Campi obbligatori. I veicoli creati nel servizio di viaggi on demand richiedono l'impostazione di determinati campi al momento della creazione. I veicoli creati nel servizio di attività pianificate non hanno campi di risorse veicolo obbligatori.
Campi facoltativi. Entrambi i servizi hanno campi che puoi impostare al momento della creazione o in un secondo momento. Questi sono disponibili nella rispettiva guida di riferimento per il servizio che utilizzi.

Nome del veicolo (solo output)

Il campo name è esattamente lo stesso per i servizi di viaggi on demand e attività pianificate. Fleet Engine definisce il campo quando crei il veicolo, in base a due campi che imposti al momento della creazione del veicolo:

Il parent: una stringa associata all'ID progetto Google Cloud nel formato providers/{provider}, dove {provider} è l'ID del progetto Cloud. Ogni veicolo creato per un determinato progetto avrà lo stesso percorso parent.

Il progetto Cloud a cui fai riferimento qui deve contenere anche i ruoli dell'account di servizio Fleet Engine per il servizio che utilizzi. Per un elenco di questi account di servizio, consulta Account di servizio per. Fleet Engine non supporta l'accesso da più progetti Google Cloud.
L'ID del veicolo, che deve essere univoco per tutti i veicoli del tuo parco risorse e una stringa Unicode valida. Questo è l'ID risorsa del veicolo. Sia i viaggi on demand sia le fermate pianificate lo utilizzano per associare un viaggio o un'attività al veicolo che lo completa.

Nei servizi basati su Google Cloud, tutte le API devono rappresentare le risorse come stringhe. Per maggiori dettagli, consulta Denominazione delle risorse in Fleet Engine.

Identificatori univoci delle entità

Il formato e il valore degli identificatori univoci delle entità utilizzati nelle chiamate alle risorse sono opachi per Fleet Engine. Assicurati che l'identificatore non contenga informazioni che consentono l'identificazione personale, come il numero di telefono dell'autista.

Riutilizzo dei veicoli

Dopo che un veicolo ha completato tutte le fermate di un determinato itinerario, rimane disponibile per il riutilizzo in Fleet Engine per 7 giorni, il che significa che puoi riutilizzare un veicolo nei giorni lavorativi successivi senza doverne creare uno nuovo. Ogni volta che riutilizzi un veicolo, Fleet Engine ne reimposta la disponibilità e il conto alla rovescia di 7 giorni ricomincia.

L'approccio consigliato per mantenere un veicolo disponibile in Fleet Engine è aggiornarne la posizione a intervalli regolari. Anche gli aggiornamenti alla maggior parte degli altri campi dell'entità Vehicle ne estenderanno la durata, a condizione che il nuovo valore del campo sia diverso da quello esistente.

NOTA: alcuni campi dell'entità Vehicle, come device_settings, sono informazioni di debug che non vengono mantenute da Fleet Engine. L'aggiornamento non estende la durata dell'entità Vehicle.

Per migliorare l'analisi del sistema, è consigliabile riutilizzare la stessa coppia ID autista-veicolo di giorno in giorno. Per farlo, utilizza lo stesso ID veicolo associato all'autista per le fermate pianificate o i viaggi on demand precedenti.