Introduzione: creare veicoli

Per informazioni generali su come funzionano i veicoli in Fleet Engine, consulta la seguenti guide nella sezione Essenziali di Fleet Engine:

La documentazione in questa sezione descrive come creare e gestire i veicoli in Fleet Engine. Crei veicoli nell'ambiente server di Fleet Engine per rappresenta i veicoli veri e propri nelle operazioni reali. Il tuo Fleet Engine i veicoli devono corrispondere anche a quelli usati nel tuo sistema di backend da utilizzare per le assegnazioni dei veicoli e i percorsi.

Puoi utilizzare un metodo "create" per creare una risorsa del 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

Sia per le attività on demand che per quelle pianificate, puoi creare e aggiornare un tramite l'invio di un messaggio di richiesta completo di campi, riepilogati come segue:

  1. Parent: 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 la capacità di Fleet Engine che utilizzi.

Le informazioni nel corpo della richiesta variano a seconda della natura della richiesta. Consulta: i dettagli nelle rispettive guide.

Token di autenticazione e autorizzazione

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

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

Per ulteriori dettagli, consulta le guide Configurare Fleet Engine.

Campi delle risorse per i veicoli

Una risorsa veicolo include i seguenti tipi di campi:

  • Campi solo di output: Campi impostati dal servizio come output e non può essere impostato direttamente. Un campo importante è il campo name. Fleet Engine ignora qualsiasi valore fornito per Campo name del veicolo in base alle indicazioni fornite dall'AIP di Google per lo specificato dall'utente ID. Se fornisci valori per questi campi, Fleet Engine restituisce un errore.
  • Campi obbligatori. Per i veicoli creati nel servizio di viaggio on demand è necessario alcuni campi devono essere impostati al momento della creazione. Veicoli creati nella programmazione non hanno campi obbligatori per le risorse del veicolo.
  • Campi facoltativi. Entrambi i servizi hanno campi che puoi impostare al momento della creazione o successivamente. Sono disponibili nella rispettiva guida di riferimento per servizio che utilizzi.

Nome veicolo (solo output)

Il campo name è esattamente lo stesso per i viaggi on demand e per le attività programmate i servizi di machine learning. Fleet Engine definisce il campo quando crei il veicolo, in base a due campi che hai impostato durante la creazione del veicolo:

  • Parent: una stringa associata al tuo ID progetto Google Cloud del modulo providers/{provider} dove {provider} è l'ID della tua progetto. Ogni veicolo che crei per un determinato progetto avrà lo stesso percorso padre.

    Il progetto Cloud a cui fai riferimento qui deve contenere anche Fleet Engine i ruoli dell'account di servizio per il servizio che utilizzi. Vedi Account di servizio per un elenco di questi 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 presenti nella tua parco risorse ed essere una stringa Unicode valida. Questo è l'ID risorsa per veicolo. Sia le corse on demand che le fermate programmate utilizzano questa opzione per associare un un percorso o un'attività con il veicolo che l'ha completato.

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

Identificatori di entità univoci

Il formato e il valore degli identificatori di entità univoci utilizzati nelle chiamate alle risorse sono opaco a Fleet Engine. Assicurati che l'identificatore non contenga informazioni che consentono l'identificazione personale (PII), come il numero di telefono del conducente.

Riutilizzo di veicoli

Dopo che un veicolo ha completato tutte le fermate per un determinato itinerario, rimane disponibile. per il riutilizzo in Fleet Engine per 7 giorni, il che significa che puoi riutilizzare un veicolo giorni lavorativi successivi senza doverne creare uno nuovo. Ogni volta che riutilizzare un veicolo, Fleet Engine reimposta la sua disponibilità, a quel punto Il conto alla rovescia di 7 giorni inizia da capo.

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

NOTA: alcuni campi sull'entità Vehicle come device_settings sono puramente di debug che non sono rese persistenti da Fleet Engine. L'aggiornamento delle prolungare la vita dell'entità Vehicle.

Per una migliore analisi del sistema, è preferibile riutilizzare lo stesso ID veicolo-conducente dall'associazione da un giorno all'altro. Per farlo, utilizza lo stesso ID veicolo associato il conducente per le precedenti fermate programmate o i viaggi on demand.

Passaggi successivi