Architettura e componenti

L'implementazione del monitoraggio delle spedizioni prevede l'utilizzo di diversi componenti di Last Mile Fleet Solution, tra cui Fleet Engine, la libreria JavaScript Shipment Tracking e l'SDK Driver:

  • Fleet Engine è il servizio di backend Last Mile Fleet Solution. È responsabile della gestione delle attività e dello stato del veicolo. Gestisce l'interazione tra l'SDK Driver, la libreria di monitoraggio delle spedizioni JavaScript e il tuo servizio di backend, che può comunicare con Fleet Engine effettuando chiamate REST o gRPC.

  • Puoi integrare la libreria JavaScript Shipment Tracking Library nella tua app per consumatori. In questo modo potrai fornire ai tuoi clienti una visualizzazione della posizione del veicolo e dell'orario di arrivo stimato.

  • L'SDK Driver è una libreria da integrare nell'app del conducente. È responsabile dell'aggiornamento di Fleet Engine con la posizione del conducente, il percorso, la distanza rimanente e l'orario di arrivo stimato. Inoltre, si integra con l'SDK di navigazione, che fornisce istruzioni di navigazione passo passo per il conducente. Per ulteriori informazioni, consulta Navigazione con Google Maps.

Il seguente diagramma mostra la relazione tra questi componenti:

Architettura

Veicoli e attività per la consegna

La creazione di un'applicazione per il tracciamento delle spedizioni per predisporre e consegnare le spedizioni prevede:

  • Il veicolo per la consegna utilizzato per trasportare la spedizione.
  • Le attività di ritiro e consegna della spedizione

Veicoli per la consegna

I veicoli per le consegne trasportano le spedizioni da un deposito a una località di consegna e da un punto di ritiro al deposito. In alcuni casi, possono anche trasportare una spedizione direttamente dal punto di ritiro alla località di consegna.

Attività

A ogni veicolo sono assegnate attività. Queste possono includere attività di ritiro o consegna, pause richieste per i conducenti o fermate programmate presso punti di consegna o altri luoghi. Ogni attività deve avere un ID attività univoco, ma può condividere lo stesso ID monitoraggio. Le attività e l'ordine in cui sono pianificate vengono utilizzate per calcolare gli orari di arrivo stimati per ogni attività.

Le attività di spedizione sono correlate al ritiro o alla consegna della spedizione. Devi specificare un ID o un numero di riferimento quando crei un'attività di spedizione. Devi anche specificare un tempo di attesa per tenere conto del tempo aggiuntivo necessario per completare l'attività, cercare parcheggio o raggiungere a piedi il punto di consegna.

  • Crea un'attività di ritiro per ritirare una spedizione, specificando la località di ritiro e il numero di riferimento o l'ID.
  • Crea un'attività di consegna per consegnare una spedizione, specificando la località di consegna e il numero di riferimento o l'ID.

Puoi anche creare un'attività di non disponibilità per un periodo di tempo in cui il veicolo non sarà disponibile per ritiri o consegne e attività di fermate programmate per modellare le fermate che devono essere effettuate da un veicolo per le consegne. Tuttavia, non è possibile assegnare un parametro tracking_id a un'attività di non disponibilità o a un'interruzione pianificata. Di conseguenza, non è possibile eseguire direttamente il monitoraggio della spedizione per un'attività di non disponibilità o una fermata pianificata.

Flusso di esempio

Il seguente diagramma di sequenza mostra il tipico flusso di monitoraggio della spedizione.

Diagramma di flusso

Per iniziare a implementare il monitoraggio delle spedizioni, vedi Monitorare le spedizioni con la libreria JavaScript Shipment Tracking .