Questo documento descrive il servizio di attività pianificate in Fleet Engine. Si presume che tu abbia letto Che cos'è Fleet Engine? e che tu conosca la funzionalità del servizio Fleet Engine specifica di cui hai bisogno.
Mentre leggi questa documentazione, tieni presente quanto segue:
- Puoi creare le attività e associarle a un punto di sosta del veicolo per modellare l'associazione reale tra l'attività e il luogo in cui si prevede che il veicolo si fermi, in modo che il conducente possa completare l'attività. Leggi l'articolo Introduzione ai veicoli per comprendere meglio come funzionano i veicoli in Fleet Engine.
- Fleet Engine per le attività pianificate utilizza le seguenti risorse:
TaskeDeliveryVehicle. Fleet Engine fornisce interfacce sia di servizio gRPC che REST:
Che cos'è un'attività pianificata?
Un'attività pianificata in Fleet Engine rappresenta un'azione individuale da completare da parte di un conducente che utilizza un veicolo nel contesto più ampio di un'operazione di trasporto. Definisce l'obiettivo specifico per il conducente. Ad esempio:
- per consegnare un bene a una residenza
- per ritirare un pacco da restituire al centro spedizioni
- fermarsi in una località per fornire un servizio in loco a un cliente
- per fare una fermata programmata per fare rifornimento al veicolo
Elementi dell'attività
L'immagine seguente illustra questi elementi di attività in un percorso pianificato standard per un veicolo.
Campi attività di base
| Campo | Descrizione |
|---|---|
| Tipo | Definisce il tipo di azione associata all'attività. |
| ID attività | Una stringa che identifica in modo univoco l'attività all'interno del sistema. |
| Posizione pianificata | Specifica la posizione prevista in cui deve essere eseguita l'attività. Questa posizione non corrisponde sempre a quella pianificata per la fermata del veicolo. |
| Stato | Indica se l'attività è aperta o chiusa. |
| Risultato attività | Indica se l'attività è riuscita o meno. |
Modello dei dati per le attività
I seguenti diagrammi illustrano il modello di dati della risorsa Task insieme al diagramma della risorsa DeliveryVehicle associata. Puoi esaminare entrambi i diagrammi per esplorare le relazioni tra le due risorse, tenendo presente quanto segue:
- Posizione pianificata: sia le fermate dei veicoli sia le attività hanno posizioni pianificate distinte tra loro.
- Per le attività, una posizione pianificata indica dove deve avvenire l'azione del conducente. Ad esempio, 15 consegne di pacchi in un complesso residenziale di grandi dimensioni richiedono la consegna a diversi centri di posta all'interno dello stesso complesso.
- Per le soste dei veicoli, la posizione pianificata indica la fermata del veicolo mentre il conducente completa le attività. Ad esempio, un veicolo si ferma all'ingresso di un complesso di appartamenti e il conducente consegna i pacchi a mano a caselle postali separate all'interno del complesso.
- Stato: sia le attività che le fermate dei veicoli hanno un campo stato, diverso l'uno dall'altro.
- Lo stato della fermata del veicolo riflette l'avanzamento del veicolo rispetto alla fermata, utilizzato a fini di monitoraggio della flotta.
- Lo stato dell'attività indica se l'attività è attiva o meno. Ciò influisce su altre operazioni da eseguire sulle attività, ad esempio l'impostazione del risultato o l'assegnazione a un veicolo.
Risultato dell'attività: il risultato dell'attività è un campo importante nel modello di dati, poiché viene utilizzato per indicare il successo o il fallimento di un'attività, indipendentemente dal suo stato.
ID:
- Quando assegni un'attività a un veicolo, Fleet Engine compila il
deliveryVehicleIdcampo. Questo campo di sola lettura indica il veicolo a cui è assegnata l'attività. - Gli ID attività sono identificatori univoci di tutte le attività del sistema.
- Gli ID monitoraggio identificano un'attività ai fini del monitoraggio della spedizione.
- Quando assegni un'attività a un veicolo, Fleet Engine compila il
Modello di dati di Tasks
Modello dei dati del veicolo
ID attività
Analogamente agli ID veicolo in Fleet Engine, ciascuna attività deve contenere un ID per distinguerle dalle altre attività all'interno del sistema. Puoi fare riferimento a tutte le attività
del flusso di lavoro e gestirle in base all'ID. Puoi creare questi ID utilizzando il servizio CreateTaskRequest e fornendo una stringa ID conforme ai requisiti descritti in questa sezione.
Questa stringa include quindi parte del nome della risorsa dell'attività stessa, un campo di solo output nell'oggetto Task. Questo scenario è simile a quello di Fleet Engine
che crea risorse per i nomi dei veicoli. Consulta la sezione Denominazione delle risorse in
Introduzione a Fleet Engine.
| Proprietà | Descrizione |
|---|---|
| Unicità | Ogni ID attività deve essere univoco all'interno dell'implementazione di Fleet Engine per evitare confusione e garantire l'identificazione corretta. |
| Formato |
|
| Esempi di ID attività validi |
|
|---|---|
| ID attività non consentiti |
|
Tipi di attività
Fleet Engine supporta vari tipi di attività per rappresentare azioni diverse all'interno di un'operazione di trasporto. Sono descritti qui insieme alla loro visibilità e ai dettagli di fatturazione.
| Tipo di attività | Descrizione | Visibilità del monitoraggio della spedizione | Fatturato |
|---|---|---|---|
| Attività di importazione | Da utilizzare per la consegna di articoli o per completare un'attività per un cliente. | I consumatori possono vedere e monitorare questo dato. | Sì |
| Attività di ritiro | Utilizza questo attributo per indicare il ritiro di merci da un cliente. Devi avere attività di consegna corrispondenti a qualsiasi attività di ritiro. | I consumatori possono visualizzare e monitorare queste informazioni. | No |
| Attività di indisponibilità | Identifica il veicolo come non disponibile per la manutenzione, ad esempio quando il conducente fa una pausa o ricarica il veicolo. | Non visibile ai consumatori. | No |
| Attività di interruzione pianificata | Un'attività di consegna che richiede una fermata in una posizione specifica. Utilizza le attività di fermata programmata per le fermate di ritiro programmate giornaliere in una località specifica, indipendentemente da altre consegne o ritiri nella stessa località. Puoi anche creare attività di sosta programmate per le raccolte dalle caselle personali, oppure per i trasferimenti o le fermate del modello presso i centri assistenza e i punti di assistenza. | I consumatori non possono monitorare questa attività specifica, ma possono visualizzarla nell'ambito del monitoraggio di altre attività. | No |
Ciclo di vita di attività e percorsi
Questa sezione fornisce dettagli sul ciclo di vita delle attività di distribuzione all'interno di Fleet Engine. Il ciclo di vita dell'attività è collegato al percorso del veicolo, perché il veicolo deve fermarsi a una fermata affinché il conducente possa completare un'attività nella posizione pianificata.
1. Creazione attività
Quando crei un'attività in Fleet Engine per la prima volta, imposti una serie di campi per l'attività indipendentemente dall'associazione con una fermata.
| Proprietà | Descrizione |
|---|---|
| Stato | Imposta su OPEN |
| ID | Imposta l'attività e l'ID monitoraggio se utilizzi il monitoraggio della spedizione per i consumatori. |
| Tempi | La durata pianificata dell'attività e la finestra temporale di destinazione. Per informazioni dettagliate, consulta la sezione Tempi delle attività. |
| Posizione pianificata | Imposta la coordinata geografica esatta in cui deve essere completata l'attività. |
2. Assegnazione attività
Quando assegni un'attività a un veicolo, lo fai in combinazione con una fermata del veicolo. Le fermate sono coordinate di latitudine/longitudine che indicano la posizione in cui parcheggiare il veicolo mentre il conducente completa le attività associate alla fermata. Le fermate sono in genere un punto di accesso, come un molo di carico, o un punto agganciato alla strada.
3. In corso
Lo stato di un'attività è APERTA o CHIUSA. Tuttavia, una volta assegnata un'attività a un veicolo, puoi monitorarne l'avanzamento tramite l'associazione al veicolo e la posizione del veicolo rispetto alla fermata in cui deve essere completata l'attività.
Quando il veicolo parte da una fermata o inizia la navigazione, lo stato della fermata dovrebbe passare a ENROUTE. In questo modo, il monitoraggio della spedizione per i consumatori può informare il destinatario di un'attività con il numero di fermate rimanenti e l'orario di arrivo stimato. Supporta anche qualsiasi visualizzazione in tempo reale per il monitoraggio delle spedizioni dei consumatori o per il monitoraggio della flotta.
4. Arrivo e risultato dell'attività
Quando il veicolo arriva a una fermata, lo stato della fermata deve essere impostato su
ARRIVED. Come per lo stato di interruzione ENROUTE, questo non influisce sullo stato della stessa attività, ma supporta sia le notifiche ai consumatori sia i report in tempo reale per il monitoraggio del parco risorse utilizzato dagli operatori del parco risorse. Inoltre, consente di eseguire analisi e generare report sulla tua attività da utilizzare per le ottimizzazioni di pubblicazione.
Quando il veicolo arriva a una fermata, il sistema può gestire il resto del percorso dell'attività utilizzando uno dei seguenti approcci:
Chiudi le attività non appena vengono completate.
Quando il conducente contrassegna l'attività come completata, il sistema può rimuoverla dalla fermata, ma lasciare la fermata con altre attività assegnate.
Rimuovi l'intera fermata dal veicolo.
Una volta che il conducente ha contrassegnato tutte le attività come completate e il veicolo è in viaggio verso la fermata successiva, puoi rimuovere l'intera fermata dal veicolo. Fleet Engine chiude automaticamente tutte le attività associate a una fermata rimossa.
La chiusura di un'attività non indica l'esito positivo o negativo
La chiusura di un'attività indica solo che l'attività non è più considerata in corso.
Per le attività nello stato CLOSED, imposta il relativo esito su SUCCEEDED o
FAILED. Questo è necessario sia per indicare il risultato effettivo per il monitoraggio della spedizione sia per la fatturazione corretta. Fleet Engine addebita solo le attività di consegna
con lo stato SUCCEEDED.
Una volta impostato un risultato per un'attività, non puoi modificarlo
Quando viene contrassegnato il risultato di un'attività, Fleet Engine compila automaticamente la posizione del risultato dell'attività con l'ultima posizione nota del veicolo. Tuttavia, puoi modificare l'ora e la località dei risultati dell'attività dopo che sono state impostate e Fleet Engine non eseguirà l'override di questi campi.
5. Altri scenari di attività
Non tutte le attività che modelli in Fleet Engine si inseriscono in un flusso di viaggio tipico. Ad esempio:
- Attività di ritiro: Quando hai un'attività di ritiro per un pacco da restituire al deposito per l'elaborazione successiva, devi creare un'attività di consegna corrispondente per il pacco, con la posizione pianificata impostata sul deposito. In caso contrario, le attività di ritiro generalmente seguono lo stesso flusso delle attività di consegna.
- Riassegnazione delle attività. Non puoi riassegnare direttamente un'attività a un veicolo diverso. Per spostare un'attività da un veicolo all'altro, chiudi l'attività originale e ricreala prima di assegnarla al nuovo veicolo. Se aggiorni l'ordine delle attività per un'attività già assegnata a un altro veicolo, Fleet Engine genera un errore.
- Eliminare le attività. Come per i veicoli, Fleet Engine elimina le attività che non sono state aggiornate dopo sette giorni. Se provi a riutilizzare un ID attività per un'attività che è stata chiusa in precedenza, Fleet Engine restituisce un errore se tale ID è stato utilizzato negli ultimi sette giorni. Al contrario, se vuoi conservare i dati delle attività per più di sette giorni, devi implementare personalmente questa funzionalità, ad esempio tramite un job pianificato per reimpostare l'orologio dei 7 giorni.
Condividere l'avanzamento delle attività
In Fleet Engine, puoi monitorare l'avanzamento delle attività in tempo reale e condividere il percorso del conducente in due modi principali:
- Esperienza del consumatore per consentire ai consumatori di conoscere lo stato dei loro ordini di spedizione o dell'ordine di servizio richiesto.
- Monitoraggio del parco risorse per consentire agli operatori del parco risorse di monitorare e analizzare lo stato degli automezzi del parco risorse.
Esperienza del consumatore
Per condividere l'avanzamento dell'attività, puoi configurare l'esperienza del consumatore utilizzando JavaScript Consumer SDK. Con l'SDK, puoi migliorare un'esperienza visiva su web o app mobile in modo che i consumatori possano monitorare lo stato della spedizione, nonché gli orari di arrivo stimati e gli aggiornamenti della posizione in tempo reale del veicolo di consegna. Consulta la panoramica delle attività pianificate dell'SDK per i consumatori.
L'SDK Consumer contiene componenti di mappa e dati JavaScript per connettersi a Fleet Engine. La mappa sostituisce un oggetto google.maps.Map standard. Il client deve autenticare gli utenti finali e utilizzare il ruolo consumer Distribuzione del progetto Google Cloud per restituire solo informazioni specifiche del cliente. Fleet Engine filtra e oscura tutte
le altre informazioni nelle risposte. Ad esempio, durante un'attività di mancata disponibilità,
non vengono condivise informazioni sulla posizione con un utente finale.
In Fleet Engine, puoi attivare le seguenti impostazioni per condividere con il consumatore l'avanzamento delle attività:
- Le attività utilizzano la proprietà
TaskTrackingViewConfig. (Facoltativo) - Le attività utilizzano un ID monitoraggio, necessario alla libreria per identificare le attività pertinenti per un consumatore.
Monitoraggio della flotta
La libreria di monitoraggio del parco risorse JavaScript ti consente di visualizzare la posizione dei
veicoli nelle loro flotte quasi in tempo reale. La libreria utilizza
l'API Fleet Engine per fornire la visualizzazione dei veicoli per la consegna e
delle loro attività assegnate. Come l'SDK per i consumatori JavaScript, contiene un componente mappa JavaScript che sostituisce direttamente un'entità google.maps.Map standard con componenti di dati che utilizzi per connetterti a Fleet Engine.
Questa libreria mostra la visibilità dei veicoli per le consegne non appena vengono creati in Fleet Engine. Per questa implementazione, utilizza il ruolo IAM Cloud Super user del servizio Fleet Engine e fornisci un claim Java Web Token per accedere ai veicoli di consegna e alle relative attività associate.
Scenari di attività pianificate
Questa sezione mostra una serie di scenari di attività che riassumono le informazioni fornite a questo punto della guida. Il suo scopo è quello di aiutarti a comprendere i vari modi in cui puoi modellare le tue operazioni di trasporto in Fleet Engine, a seconda della tua attività.
Consegna con tracciabilità
Questo scenario di importazione mostra un'attività di fermata programmata assegnata al deposito sia alla partenza dal deposito all'inizio del tragitto sia all'arrivo al deposito alla fine del tragitto. Inoltre,
mostra due attività di recapito per una fermata, una delle quali non è riuscita. Utilizza questa assegnazione per abilitare il monitoraggio da e al deposito e come modo per modellare gli orari di inizio e di fine della giornata. Non viene addebitata alcuna commissione per le attività di interruzione pianificate.
Ritiro con consegna in deposito
Questo scenario mostra come modellare un ritiro con la relativa attività di consegna obbligatoria. Puoi impostare la restituzione al deposito come consegna ai fini della fatturazione.
Veicolo di alimentazione
Questo scenario mostra due consegne con una fermata pianificata nel mezzo per un veicolo con alimentatore, il cui scopo è consentire al veicolo per la consegna di tornare al deposito con una serie di pacchi da spedire. Puoi anche modellare il veicolo di trasporto pubblico con una fermata programmata.
Tempi delle attività
Creare modelli dei tempi delle attività aiuta a pianificare in modo efficace i percorsi, gli orari di arrivo stimati e le aspettative di consegna. Fleet Engine offre due funzionalità chiave per modellare e prevedere le tempistiche delle attività, come descritto in questa sezione.
Durata dell'attività
La durata dell'attività viene impostata con il campo task_duration, un campo obbligatorio che simula il tempo previsto che il conducente impiega per completare le attività in una fermata o per fare una pausa. Per le fermate, include tutte le attività necessarie dopo l'arrivo a una fermata, come lo scarico dei pacchi e l'interazione con il destinatario. Più specifiche sono queste informazioni, più Fleet Engine sarà in grado di fornire orari di arrivo e orari di arrivo stimati realistici per le fermate successive del viaggio.
Per maggiori dettagli sul campo, consulta Durata nella documentazione relativa ai buffer di protocollo.
Finestra temporale target
L'ora target definisce un intervallo di tempo proposto per un'attività, in genere utilizzato per comunicare con i clienti o per scopi di pianificazione interna. Puoi impostarlo con il campo target_time_window, che è composto da un'ora di inizio e un'ora di fine.
Ciò non influisce direttamente sui calcoli del percorso, ma può essere utilizzato per situazioni come avvisare un consumatore di una finestra temporale per la consegna di un pacco o quando aspettarsi l'arrivo di un lavoratore del servizio programmato.
Attributi attività
Gli attributi delle attività in Fleet Engine consentono di filtrare facilmente le attività in base a caratteristiche specifiche quando si utilizza la richiesta ListTasks. Puoi anche utilizzare gli attributi delle attività personalizzate per l'analisi con Cloud Logging, nonché per comunicare informazioni ai consumatori o per il monitoraggio del parco veicoli. Lo scopo è simile a quello per gli attributi dei veicoli: utilizzalo per creare una prospettiva più mirata delle operazioni di consegna.
Limitazioni e restrizioni
- Creazione di attributi personalizzati: Fleet Engine limita il numero di attributi personalizzati che puoi definire per attività. Contatta il tuo rappresentante di vendita per richiedere un aumento di questi limiti.
- Funzionalità di filtro: pur offrendo flessibilità di filtro, gli attributi delle attività non sostituiscono i campi dei dati delle attività principali. Utilizzali per un filtro aggiuntivo in base alle tue esigenze specifiche.
- Ogni attributo deve avere una chiave univoca.
- Non includere informazioni che consentono l'identificazione personale o altre informazioni sensibili nel valore dell'attributo, in quanto potrebbero essere visibili all'utente.
- Convalida dei dati: assicurati che i tipi di dati e i formati degli attributi personalizzati siano compatibili con i requisiti di Fleet Engine.