La documentazione in questa sezione mostra come creare e utilizzare le attività pianificate utilizzando il servizio Attività pianificate di Google Maps Mobility. Presuppone di avere familiarità con quanto segue:
- Fleet Engine: devi conoscere i dettagli di implementazione di Fleet Engine, i meccanismi di richiesta e la sicurezza. A questo scopo, consulta Che cos'è il servizio Fleet Engine? e gli argomenti sulla sicurezza in Configurare Fleet Engine.
- Nozioni di base sui veicoli per i servizi on demand. Consulta Introduzione ai veicoli.
- Nozioni di base sulle attività per i servizi delle attività pianificate. Vedi Attività pianificate
La risorsa Task che utilizzerai è disponibile sia in gRPC sia in
REST.
In Fleet Engine per le attività pianificate, un'attività rappresenta un'attività del conducente che adempie a una spedizione o a un servizio pianificato per i tuoi consumatori. Assegni le attività alle fermate del veicolo in cui devono essere completate e il veicolo si reca a queste fermate.
Un'attività ha due stati possibili: 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, segnali questo 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 abbandona la fermata, questa viene rimossa dall'elenco delle fermate
sul veicolo. Per ulteriori informazioni
sulle attività e sulla loro relazione con le fermate e i veicoli, vedi
Attività pianificate in Nozioni di base su Fleet Engine .
La vita di un'attività
Per monitorare ogni attività in Fleet Engine, devi prima creare un'entità Task. Vedi gRCP o REST come riferimento.
La tabella seguente descrive un esempio di flusso end-to-end di un'attività creata nel tuo sistema e le relative fasi del ciclo di vita in Fleet Engine. Si presume che tu abbia configurato Fleet Engine e che tu abbia un veicolo per l'attività, con gli aggiornamenti della posizione attivati nell'app del conducente. Consulta SDK Driver: 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à di consegna o i servizi. 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 finestra temporale di destinazione, condivisione dell'avanzamento delle attività e attributi personalizzati. Consulta
Creare attività di spedizione
e le guide correlate. |
| 2 | Pianifica le attività. | Quando pianifichi la consegna di un'attività, invii una richiesta di aggiornamento del veicolo per la consegna, che aggiorna l'entità del veicolo con un elenco di fermate per viaggiare. Assegni a ogni fermata un elenco di attività da completare in quella fermata. Vedi Aggiornare le attività dei veicoli di consegna. |
| 3 | Aggiornare l'avanzamento dell'attività. | Una volta che l'attività è assegnata a un punto di sosta ed è attiva su Fleet Engine, il sistema comunica a Fleet Engine i progressi del veicolo quando si avvicina, arriva e completa la fermata. Con queste informazioni, Fleet Engine può eseguire al meglio gli aggiornamenti di routing e stato durante il viaggio nonché nel corso della giornata per il veicolo. Consulta Aggiornare lo stato della fermata del veicolo. |
| 4 | Condividere i viaggi. | Quando il veicolo inizia la navigazione attiva per il giorno della consegna, puoi condividere le informazioni sul viaggio con gli stakeholder interessati. Fleet Engine rende disponibili agli stakeholder interessati sia i dettagli delle attività che la posizione del veicolo 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à.
