Introduzione: creare veicoli

Per informazioni generali sul funzionamento dei veicoli in Fleet Engine, consulta le seguenti guide nella sezione Elementi essenziali di Fleet Engine:

La documentazione in questa sezione descrive come creare e gestire i veicoli in Fleet Engine. Crea veicoli nell'ambiente server Fleet Engine per rispecchiare i veicoli reali della tua attività. I veicoli Fleet Engine devono corrispondere anche a quelli utilizzati nel sistema di backend che utilizzi per l'assegnazione e l'itinerario dei veicoli.

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

Viaggi on demand

Attività pianificate

Richieste di veicoli

Per le funzionalità di attività on demand e pianificate, crei e aggiorni un veicolo inviando un messaggio di richiesta con i campi, riepilogati come segue:

  1. Il genitore: una stringa associata all'ID progetto Google Cloud, utilizzata per compilare il campo del nome dell'istanza del veicolo.

  2. L'ID del veicolo: una stringa univoca utilizzata per compilare il campo name del veicolo.

  3. Un'istanza di 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 guide specifiche.

Token di autenticazione e autorizzazione

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

  • 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 di Bearer <token>, dove <token> è un token web JSON che emetti.

Per maggiori dettagli, consulta le guide Configurare Fleet Engine.

Campi delle risorse del 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 che non possono essere impostati direttamente. Un campo importante di questo tipo è il campo name. Fleet Engine ignora qualsiasi valore fornito per il campo name del veicolo in base alle indicazioni dell'API Google 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 viaggio on demand richiedono che determinati campi vengano impostati al momento della creazione. I veicoli creati nel servizio di attività pianificate non hanno campi di risorse del 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 guida di riferimento del servizio che utilizzi.

Nome del veicolo (solo output)

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

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

    Il progetto Cloud a cui fai riferimento qui deve contenere anche i ruoli del service account Fleet Engine per il servizio che utilizzi. Consulta Service account per un elenco di questi service account. Fleet Engine non supporta l'accesso da più progetti Google Cloud.

  • L'ID del veicolo, che deve essere univoco per tutti i veicoli della tua flotta ed essere una stringa Unicode valida. Questo è l'ID risorsa del veicolo. Sia le corse on demand sia le fermate programmate utilizzano questo campo per associare una corsa o un'attività al veicolo che la completa.

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

Identificatori univoci dell'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 (PII), come il numero di telefono del conducente.

Riutilizzo del veicolo

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 ripristina la disponibilità, a quel punto il conto alla rovescia di 7 giorni ricomincia.

L'approccio consigliato per mantenere un veicolo disponibile in Fleet Engine è aggiornare la sua 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 puramente 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 l'accoppiamento ID conducente-veicolo di giorno in giorno. Per farlo, utilizza lo stesso ID veicolo associato all'autista per le fermate programmate precedenti o per le corse on demand.

Passaggi successivi