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:
- Fleet Engine: dovresti avere familiarità con i dettagli dell'implementazione, i meccanismi di richiesta e la sicurezza di Fleet Engine. A questo scopo, consulta Che cos'è il servizio Fleet Engine? e gli argomenti sulla sicurezza in Configurazione di Fleet Engine.
- Nozioni di base sui veicoli per i servizi on demand. Consulta la pagina Introduzione ai veicoli.
- Nozioni di base sulle attività per i servizi per attività pianificate. Vedi Attività pianificate
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:
|
5 | Finalizza l'attività. | Puoi finalizzare le attività di spedizione in Fleet Engine nei seguenti modi:
|
Flusso della sequenza di attività
Il seguente diagramma mostra un flusso dettagliato del ciclo di vita di un'attività.