Panoramica del monitoraggio del parco risorse

La libreria di monitoraggio del parco risorse JavaScript funziona per i seguenti casi d'uso:

• Corse on demand
• Attività pianificate

Questa guida spiega come utilizzare questa libreria per entrambi i servizi.

Utilizzando la libreria di monitoraggio del parco risorse JavaScript, puoi offrire agli operatori del parco risorse la possibilità di visualizzare le posizioni dei veicoli del loro parco risorse quasi in tempo reale. Se il percorso di un veicolo è noto, il componente della visualizzazione mappa anima il veicolo mentre si muove lungo il percorso previsto.

Che cos'è il monitoraggio della flotta?

Il monitoraggio del parco risorse è una funzionalità di Fleet Engine progettata per gli operatori del parco risorse. Fornisce interfacce che modellano e seguono i dati del parco risorse in Fleet Engine e fornisce classi che utilizzi per creare una visualizzazione della mappa basata sul web dettagliata delle informazioni sul percorso per i gestori del parco risorse. Ad esempio:

• Consenti agli operatori di corse on demand di monitorare l'avanzamento delle corse su più veicoli.
• Consentire agli operatori delle spedizioni programmate di visualizzare l'avanzamento quasi in tempo reale delle spedizioni della flotta su una mappa basata sul web.

Integra la libreria nella tua app web e imposta i profili dei ruoli appropriati all'interno di Fleet Engine per supportare la condivisione dei percorsi con il consumatore. Per saperne di più sui ruoli in Fleet Engine, consulta Ruoli dei service account.

Perché utilizzare il monitoraggio del parco risorse?

Quando integri il monitoraggio del parco risorse nelle operazioni del parco risorse, ottieni un'esperienza di monitoraggio dei veicoli completa, con aggiornamenti della posizione quasi in tempo reale. Puoi visualizzare sulla mappa la posizione di uno o tutti i veicoli della flotta, inclusi i dettagli delle fermate o dei waypoint, per capire il rendimento della tua flotta.

Cosa puoi fare con il monitoraggio del parco risorse?

Con le informazioni della libreria di monitoraggio del parco risorse, puoi creare visualizzazioni dettagliate delle operazioni del parco risorse con le seguenti funzionalità:

• Personalizza l'interfaccia utente della mappa di monitoraggio del parco risorse in base alle tue esigenze.

• Visualizza la posizione attuale di uno, più o tutti i veicoli mentre percorrono i loro itinerari, con le posizioni aggiornate periodicamente.

• Calcola gli ETA per il percorso o la consegna, nonché la distanza rimanente.

• Visualizzare l'avanzamento del veicolo, inclusi i percorsi completati o lo stato delle attività.

Componenti

La tabella seguente descrive i componenti utilizzati nel monitoraggio del parco risorse e le relative funzioni.

Corse on demand

Componente	Descrizione
Visualizzazione mappa della condivisione del percorso	La visualizzazione mappa della condivisione del percorso mostra la posizione dei veicoli e i relativi percorsi. Se Fleet Engine conosce il percorso di un veicolo, il componente della visualizzazione mappa anima il veicolo mentre si sposta lungo il percorso previsto.
Fornitore di servizi di localizzazione del veicolo	Il provider di posizione del veicolo mostra i dati sulla posizione di un singolo veicolo. Contiene informazioni sulla posizione del veicolo, sui suoi waypoint e sulle corse assegnate al veicolo. Di seguito sono riportate le regole di visibilità per i veicoli e i relativi indicatori dei waypoint: Veicolo: un veicolo è visibile non appena viene creato in Fleet Engine ed è visibile quando vehicle_state è Online. Ciò significa che un veicolo può essere visibile anche quando non è assegnata alcuna corsa corrente. Indicatori dei waypoint: i waypoint pianificati del veicolo vengono visualizzati sulla mappa come indicatori di partenza, intermedi e di destinazione.
Opzioni di personalizzazione	Le opzioni del provider di posizione del veicolo ti consentono di fornire personalizzazioni di polilinee e indicatori. Puoi colorare e applicare stili alle polilinee per visualizzare una serie di scenari reali per il veicolo, ad esempio i percorsi effettuati e il traffico. Puoi personalizzare gli indicatori per scopi diversi. Puoi anche aggiungere la gestione dei clic a polilinee e indicatori.
Listener di eventi del veicolo	Il listener di eventi consente all'operatore di ottenere informazioni sulle corse completate da un veicolo.
Fornitore di servizi di localizzazione della flotta di veicoli	Il provider di località del parco veicoli mostra i dati sulla posizione di più veicoli per le consegne. Quando monitori un parco veicoli, imposti i limiti geografici e hai anche la possibilità di filtrare in base agli ID veicolo.

Attività pianificate

Componente	Descrizione
Visualizzazione mappa della condivisione del percorso	La visualizzazione mappa della condivisione del percorso mostra la posizione dei veicoli e delle attività di consegna. Se Fleet Engine conosce il percorso di un veicolo, il componente della visualizzazione mappa anima il veicolo mentre si sposta lungo il percorso previsto.
Provider di posizione del veicolo di consegna	Il provider di posizione del veicolo di consegna mostra i dati sulla posizione di un singolo veicolo di consegna. Contiene informazioni sulla posizione del veicolo, sulle sue fermate e sulle attività completate dal veicolo di consegna. Di seguito sono riportate le regole di visibilità per i veicoli per le consegne, le fermate e le relative attività: Veicolo: un veicolo per le consegne è visibile non appena viene creato in Fleet Engine ed è visibile lungo tutto il percorso, indipendentemente dalle sue attività. Fermate: le fermate pianificate del veicolo vengono mostrate sulla mappa come indicatori di fermata del veicolo. Gli indicatori delle attività completate vengono visualizzati con uno stile diverso rispetto alle fermate pianificate di un veicolo. Attività: la posizione dei risultati delle attività viene visualizzata con gli indicatori dei risultati delle attività. Le attività con un risultato SUCCEEDED vengono visualizzate con indicatori di attività riuscita, mentre tutte le altre attività vengono visualizzate con indicatori di attività non riuscita.
Opzioni di personalizzazione	Le opzioni del provider di località del veicolo di consegna ti consentono di fornire personalizzazioni di polilinee e indicatori. Puoi colorare e applicare stili alle polilinee per visualizzare una serie di scenari reali per il veicolo, ad esempio il percorso attivo del veicolo. Puoi personalizzare gli indicatori per diversi scopi, ad esempio per un veicolo di consegna. Puoi anche aggiungere la gestione dei clic a polilinee e indicatori.
Filtro delle attività di consegna	Il filtro delle attività consente all'operatore di filtrare la visualizzazione in base alle attività completate prima o dopo un'ora specificata, nonché di filtrare in base alle attività aperte o chiuse.
Listener di eventi del veicolo di consegna	Il listener di eventi consente all'operatore di ottenere informazioni sui segmenti del percorso completati da un veicolo per le consegne, nonché un elenco di attività svolte dal veicolo.
Provider di località per la flotta di consegna	Il provider di dati sulla posizione della flotta di consegna mostra i dati sulla posizione di più veicoli di consegna. Puoi filtrare per visualizzare un veicolo per le consegne specifico e la sua posizione oppure puoi visualizzare le posizioni dei veicoli per l'intera flotta.

Come utilizzare il monitoraggio della flotta

1	Configura il monitoraggio del parco risorse in JavaScript.	Per saperne di più, consulta Configura la libreria di monitoraggio del parco risorse JavaScript.
2	Carica la libreria e inizializza la mappa.	Per saperne di più, consulta Carica la libreria e inizializza la visualizzazione mappa.
3	Fornisci la posizione del veicolo e imposta la visualizzazione della mappa.	Per iniziare a seguire un veicolo, devi creare un'istanza di un provider di località con l'ID veicolo corretto e utilizzarlo per inizializzare la visualizzazione mappa. Per maggiori informazioni, consulta Fornisci la posizione del veicolo.
5	Aggiorna l'avanzamento del parco risorse e gestisci gli errori relativi alle corse.	Per saperne di più, consulta Aggiorna l'avanzamento del parco veicoli e Gestisci gli errori.
5	Al termine della giornata, interrompi il monitoraggio dei veicoli del parco risorse.	Per saperne di più, consulta Interrompi il monitoraggio di un veicolo per le consegne.

Passaggi successivi

• Configura la libreria di Fleet Tracking JavaScript