Che cos'è un'attività pianificata?

La documentazione in questa sezione mostra come creare e gestire attività pianificate utilizzando il servizio di attività pianificate per la mobilità di Google Maps. Presuppone la conoscenza di quanto segue:

La risorsa Task che utilizzerai è disponibile sia in gRPC che in REST.

In Fleet Engine per le attività pianificate, un'attività rappresenta un'attività del conducente che soddisfa una spedizione o un servizio pianificato per i consumatori. Puoi assegnare le attività ai luoghi delle fermate dei veicoli da completare e il veicolo arriva fino a queste fermate.

Sono possibili due stati per un'attività: OPEN o CLOSED. Questi stati indicano se l'attività è attiva o meno nel sistema. Man mano che il percorso si evolve per un'attività attiva, puoi segnalarlo a Fleet Engine aggiornando la fermata del veicolo associata all'attività, che può essere ENROUTE o ARRIVED. Una volta che il conducente completa le attività e lascia la fermata, questa viene rimossa dall'elenco delle fermate del veicolo. Per ulteriori informazioni sulle attività e sulla loro relazione con fermate e veicoli, consulta Attività programmate in Nozioni di base su Fleet Engine .

Durata di un'attività

Per monitorare ogni attività in Fleet Engine, devi prima creare un'entità Task. Consulta gRCP o REST come riferimento.

La tabella seguente descrive un flusso end-to-end di esempio di un'attività creata nel tuo sistema e le relative fasi del ciclo di vita in Fleet Engine. Si presuppone che tu abbia configurato Fleet Engine e abbia un veicolo per l'attività, con gli aggiornamenti della posizione attivati nell'app del conducente. Vedi SDK del conducente: attività pianificate.

1 Creare attività. All'inizio del ciclo di lavoro, il supervisore o l'amministratore del servizio crea innanzitutto un manifest per le attività o i servizi di distribuzione. Da qui, il sistema crea le entità delle attività utilizzando CreateTrip con i campi obbligatori, come il tipo di attività e la località. A questo punto può anche fornire altre configurazioni, come la finestra temporale target, la visibilità per la condivisione del percorso e attributi personalizzati. Consulta Creare attività di spedizione e le guide correlate.
2 Pianifica le attività.

Quando pianifichi un'attività per la consegna, invii una richiesta di aggiornamento del veicolo per la consegna, che a sua volta aggiorna l'entità veicolo con un elenco di fermate da percorrere. A ogni fermata assegni un elenco di attività da completare nella fermata. Vedi Aggiornare le attività del veicolo per la consegna.

3 Aggiorna l'avanzamento dell'attività. Quando l'attività è assegnata a un'interruzione della consegna e attiva in Fleet Engine, il sistema notifica a Fleet Engine l'avanzamento del veicolo man mano che si avvicina, arriva e completa l'arresto. Con queste informazioni, Fleet Engine può eseguire al meglio gli aggiornamenti dei percorsi e dello stato durante il viaggio e nel corso della giornata per il veicolo. Consulta la pagina Aggiornare lo stato dell'arresto del veicolo.
4 Condividi i percorsi. Nello stesso momento in cui il veicolo avvia la navigazione attiva per il giorno della consegna, puoi condividere le informazioni sul viaggio con gli stakeholder interessati. Fleet Engine rende disponibili i dettagli delle attività e la posizione dei veicoli agli stakeholder interessati nei seguenti modi:
  • Informazioni sulla spedizione per i consumatori . Con questa soluzione, i consumatori possono vedere lo stato del pacco e le informazioni sulla posizione del veicolo che puoi visualizzare.
    Vedi Condivisione dei consumatori per le attività pianificate.
  • Informazioni sullo stato del parco risorse per gli amministratori. Con questa soluzione, gli amministratori dei parchi risorse possono visualizzare le posizioni dei veicoli per la consegna e le fermate nei tuoi parchi risorse quasi in tempo reale. Se il percorso di un veicolo è noto, il componente Visualizzazione mappa anima il veicolo mentre si sposta lungo il percorso previsto.
    Consulta la libreria JavaScript Fleet Tracking.
5 Finalizza l'attività. Puoi finalizzare le attività di spedizione in Fleet Engine nei seguenti modi:
  • Chiudi l'attività: la chiusura di un'attività di spedizione indica che l'attività non è più attiva.
  • Imposta il risultato dell'attività: una volta chiusa un'attività, indichi un'attività riuscita o non riuscita per indicare se l'importazione è avvenuta o meno. Questa è una parte importante della finalizzazione di un'attività per mostrare il risultato della consegna nella condivisione del percorso e garantire una fatturazione corretta per il servizio Fleet Engine.
Vedi Finalizzare le attività.

Flusso della sequenza di attività

Il seguente diagramma mostra un flusso dettagliato del ciclo di vita di un'attività.

TaskSequenceDiagram

Passaggi successivi