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. Creando veicoli nell'ambiente server di Fleet Engine, puoi riflettere i veicoli effettivi nella tua attività reale. I veicoli di Fleet Engine devono corrispondere anche a quelli utilizzati nel sistema di backend che utilizzi per l'assegnazione e il routing dei veicoli.

Utilizzi un metodo create 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

Attività pianificate

Richieste di veicoli

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

  1. Il valore principale: una stringa associata al tuo 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à del motore del parco veicoli che utilizzi.

Le informazioni nel corpo della richiesta variano in base alla natura della richiesta. Consulta i dettagli nelle rispettive guide.

Token di autenticazione e autorizzazione

Le richieste a Fleet Engine devono anche fornire 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 di richiesta HTTP, che deve contenere il campo Authorization con un valore Bearer <token>, dove <token> è un token web JSON emesso da te.

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

Campi della risorsa veicolo

Una risorsa veicolo ha i seguenti tipi di campi:

  • Campi di output solo. 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 name campo del veicolo in base alle indicazioni dell'AIP di 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 corse on demand richiedono l'impostazione di determinati campi al momento della creazione. I veicoli creati nel servizio di attività pianificate non hanno campi obbligatori per le risorse veicolo.
  • Campi facoltativi. Entrambi i servizi hanno campi che puoi impostare al momento della creazione o in un secondo momento. Puoi trovarli nella rispettiva guida di riferimento per il servizio che utilizzi.

Nome del veicolo (solo output)

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

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

    Il progetto Cloud a cui fai riferimento qui deve contenere anche i ruoli dell'account di servizio di Fleet Engine per il servizio che utilizzi. Per un elenco di questi account di servizio, consulta Account di servizio. 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 e deve essere una stringa Unicode valida. Si tratta dell'ID risorsa del veicolo. Sia le corse on demand sia le fermate programmate lo utilizzano 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, consulta la sezione Denominatione delle risorse in Fleet Engine.

Identificatori univoci delle entità

Il formato e il valore degli identificatori di entità univoci 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 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 riutilizzarlo nei giorni lavorativi successivi senza dover creare un nuovo veicolo. Ogni volta che riutilizzi un veicolo, Fleet Engine reimposta la relativa disponibilità, a quel punto il conto alla rovescia di 7 giorni ricomincia da capo.

L'approccio consigliato per mantenere un veicolo disponibile in Fleet Engine è aggiornarne la posizione a intervalli regolari. Anche gli aggiornamenti della maggior parte degli altri campi dell'entità Vehicle ne prolungheranno 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 puramente di debug che non vengono conservate da Fleet Engine. L'aggiornamento non estende la durata dell'entità Vehicle.

Per migliorare le analisi del sistema, è meglio riutilizzare la stessa associazione di ID conducente e veicolo ogni giorno. A tal fine, utilizza lo stesso ID veicolo associato al conducente per le fermate programmate precedenti o le corse on demand.

Passaggi successivi