Questo documento descrive il servizio di attività pianificate in Fleet Engine. Presuppone hai letto Che cos'è Fleet Engine? e conosci il parco risorse specifico la capacità di servizio del motore di cui hai bisogno.
Mentre leggi questa documentazione, tieni presente quanto segue:
- Crea attività e associale a un punto di sosta per modellare l'associazione nel mondo reale tra l'attività e il luogo in cui il veicolo deve fermarsi affinché il conducente possa completare l'attività. Leggi Introduzione ai veicoli per migliorare a capire come funzionano i veicoli in Fleet Engine.
- Floet Engine per le attività pianificate utilizza le seguenti risorse: un
Task
e unDeliveryVehicle
. Fleet Engine fornisce sia un servizio gRPC sia un servizio REST interfacce:
Che cos'è un'attività pianificata?
Un'attività pianificata in Fleet Engine rappresenta un'azione individuale da eseguire completati da un conducente che utilizza un veicolo nel contesto più ampio di una attività di trasporto pubblico. Definisce l'obiettivo specifico per il conducente. Ad esempio:
- per consegnare un bene a una residenza
- per ritirare un pacco da restituire al deposito
- fermarsi in un punto per fornire un servizio in loco a un cliente
- di fare una fermata programmata per alimentare il veicolo
Elementi dell'attività
L'immagine seguente illustra questi elementi delle attività in una pianificazione 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 località non corrisponde sempre a quella pianificata per 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 dei dati della risorsa Task
accanto al diagramma per la risorsa DeliveryVehicle
associata. Puoi
esamina entrambi i diagrammi per esplorare le relazioni tra le due risorse,
tenendo presente quanto segue:
- Posizione pianificata: sia le fermate dei veicoli che le attività hanno località pianificate.
distinti tra loro.
- Per le attività, un luogo pianificato indica dove si trova l'azione del conducente. devono verificarsi. Ad esempio, 15 consegne di pacchi presso un grande complessi richiedono la consegna a postazioni diverse all'interno lo stesso complesso.
- Per le fermate di veicoli, la posizione pianificata indica la fermata per il veicolo mentre il conducente completa le attività. Ad esempio, un il veicolo si ferma all'ingresso di un complesso residenziale e il conducente consegna i pacchi a mano in apposito spazi di posta diversi all'interno del complesso.
- Stato: sia le attività che le fermate dei veicoli hanno un campo stato, diverso da quello
tra loro.
- Lo stato dell'arresto riflette l'avanzamento del veicolo in in relazione alla fermata, utilizzati per il monitoraggio della flotta.
- Lo stato dell'attività indica se è attiva o meno. Questo influisce su altre operazioni da eseguire sulle attività, come l'impostazione o di assegnarlo a un veicolo.
Risultato dell'attività: il risultato dell'attività è un campo importante nel modello dei dati. perché è utilizzato per indicare il successo o il fallimento di un'attività, dello stato dell'attività.
ID:
- Quando assegni un'attività a un veicolo, Fleet Engine compila la
campo
deliveryVehicleId
. Questo campo di sola lettura indica che il veicolo a cui è assegnata l'attività. - Gli ID attività sono identificatori univoci per tutte le attività nel sistema.
- Gli ID monitoraggio identificano un'attività ai fini del monitoraggio della spedizione.
- Quando assegni un'attività a un veicolo, Fleet Engine compila la
campo
Modello dei dati di Tasks
Modello dei dati del veicolo
ID attività
Analogamente agli ID veicolo in Fleet Engine, ciascuna attività deve contenere un ID
a distinguerle dalle altre attività all'interno del sistema. Tu fai riferimento e gestisci
tutte le attività del flusso di lavoro in base all'ID. Puoi creare questi ID utilizzando il parametro
CreateTaskRequest
e fornendo una stringa ID conforme alle
descritti in questa sezione.
Questa stringa include quindi parte del nome della risorsa dell'attività stessa,
campo di solo output nell'oggetto Task
. Analogamente a come Fleet Engine
genera 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 una corretta identificazione. |
Formato |
|
Esempi di ID attività efficaci |
|
---|---|
ID attività non consentiti |
|
Tipi di attività
Fleet Engine supporta vari tipi di attività per rappresentare azioni diverse all'interno di un attività di trasporto pubblico. Sono descritti qui insieme alla loro visibilità e dettagli di fatturazione.
Tipo di attività | Descrizione | Visibilità del monitoraggio della spedizione | Fatturato |
---|---|---|---|
Attività di consegna | Utilizza questa opzione per abbandonare gli articoli o completare un'attività per un cliente. | I consumatori possono vedere e monitorare questo dato. | Sì |
Ritira attività | Utilizza questo attributo per indicare il ritiro di merci da un cliente. Devi abbiano attività di consegna corrispondenti a qualsiasi attività di ritiro. | I consumatori possono vedere e monitorare questo dato. | 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 mancata consegna che richiede una fermata in una località specifica. Utilizza le attività di fermata programmata per le fermate giornaliere di ritiro in un luogo specifico, indipendentemente da altre consegne o ritiri presso la 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 vederla come parte del monitoraggio di altre attività. | No |
Ciclo di vita di attività e percorso
Questa sezione fornisce dettagli sul ciclo di vita delle attività di distribuzione all'interno del parco risorse di ricerca. Il ciclo di vita dell'attività è collegato al percorso del veicolo, il veicolo deve spostarsi fino a una fermata per consentire al conducente di completare un'attività alla sua luogo pianificato.
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 a una fermata.
Proprietà | Descrizione |
---|---|
Stato | Imposta su OPEN |
ID | Imposta l'attività e l'ID monitoraggio se utilizzi il monitoraggio della spedizione per i tuoi consumatori. |
Tempi | La durata pianificata per l'attività e la relativa finestra temporale di destinazione. Consulta Tempistiche delle attività per maggiori dettagli. |
Posizione pianificata | Imposta la coordinata geografica precisa in cui deve trovarsi l'attività completata. |
2. Assegnazione attività
Quando assegni un'attività a un veicolo, lo fai insieme a un veicolo interrompi. 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 fermo a strada in ogni località.
3. In corso
Lo stato di un'attività è APERTA o CHIUSA. Tuttavia, una volta che un'attività viene assegnata un veicolo, puoi monitorarne l'avanzamento nella sua associazione Il punto in cui il veicolo si trova rispetto alla fermata completata.
Quando il veicolo parte da una fermata o inizia la navigazione, lo stato del
la fermata dovrebbe diventare ENROUTE
. In questo modo, il tracciamento della spedizione al consumatore può
aggiorna il destinatario di un'attività con il numero di fermate rimanenti e una stima
all'ora di arrivo. Questo supporta anche qualsiasi visualizzazione in tempo reale per
monitoraggio della spedizione o 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 una fermata ENROUTE
, questo non influisce sullo stato della
l'attività stessa, ma supporta sia le notifiche per i consumatori sia le notifiche
report per il monitoraggio della flotta utilizzati dagli operatori del parco risorse. Attiva anche in seguito
le analisi e i report sulle operazioni
che useresti per la pubblicazione
ottimizzazioni.
Quando il veicolo arriva a una fermata, il sistema può gestire il resto dell'attività di destinazione utilizzando uno dei seguenti approcci:
Chiudi le attività non appena vengono completate.
Quando il conducente contrassegna l'attività come completata, il sistema può rimuoverla si interrompi, ma lasciala con le 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 alla 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 se l'attività è riuscita o meno.
La chiusura di un'attività indica solo che l'attività non è più considerata in corso.
Per le attività nello stato CLOSED
, puoi impostare il loro risultato su SUCCEEDED
o
FAILED
. Questo è necessario sia per indicare il risultato effettivo della spedizione
il monitoraggio della spesa e per una corretta fatturazione. Fleet Engine addebita solo le attività di consegna con un
stato di SUCCEEDED.
Una volta impostato un risultato per un'attività, non puoi modificarlo
Quando contrassegna il risultato di un'attività, Fleet Engine compila automaticamente l'attività posizione del risultato con l'ultima posizione nota del veicolo. Tuttavia, puoi modificare i tempi e la posizione dei risultati dell'attività, una volta impostati Fleet Engine non esegue l'override di questi campi.
5. Altri scenari di attività
Non tutte le attività che modelli in Fleet Engine rientrano in un flusso di viaggio tipico. Ad esempio:
- Attività di ritiro: Se hai un'attività di ritiro per la restituzione di un pacco al deposito per una successiva elaborazione, devi creare una query dell'attività di delivery del pacco, con la posizione pianificata impostata nel deposito. In caso contrario, le attività di ritiro di solito seguono lo stesso flusso delle attività di consegna.
- Riassegnazione delle attività. Non puoi riassegnare direttamente un'attività a un'altra veicolo. Per spostare un'attività da un veicolo all'altro, chiudi la l'attività originale e ricrearla prima di assegnarle il nuovo veicolo. Se aggiorna l'ordine delle attività per un'attività già assegnata a un veicolo diverso, Fleet Engine produce un errore.
- Eliminazione delle attività. Come per i veicoli, Fleet Engine elimina le attività che non sono sono state aggiornate dopo sette giorni. Se provi a riutilizzare un ID attività per un'attività che ha chiuso in precedenza, Fleet Engine restituisce un errore se è stato utilizzato negli ultimi sette giorni. Al contrario, se vuoi conservare i dati delle attività più a lungo di sette giorni, devi implementare personalmente tale funzionalità, ad esempio tramite un job pianificato per reimpostare l'orologio a 7 giorni.
Condivisione del percorso dell'attività
Con la condivisione del percorso delle attività in Fleet Engine, puoi monitorare lo stato di avanzamento delle attività in tempo reale e condividere il percorso del conducente in due modi principali:
- Condivisione del percorso del consumatore per conoscere lo stato del proprio ordini di spedizione o ordine di servizio richiesto.
- Monitoraggio della flotta per consentire agli operatori del parco risorse di monitorare e analizzare lo stato di veicoli nel parco veicoli.
Condivisione del percorso del consumatore
Per integrare la condivisione del percorso del consumatore nella tua operazione, configura il percorso usando il JavaScript Consumer SDK. Con l'SDK, puoi migliorare esperienza visiva sul web o su app mobile in modo che i consumatori possano monitorare lo stato della loro spedizione insieme a orari di arrivo stimati e aggiornamenti della posizione in tempo reale del veicolo per la consegna. Consulta la Panoramica sulla condivisione del percorso del consumatore per attività pianificate.
L'SDK di condivisione del percorso del consumatore contiene una mappa JavaScript e componenti di dati
per la connessione a Fleet Engine. La mappa sostituisce una
standard google.maps.Map
. Il client deve autenticare il tuo sistema
e utilizzare il ruolo consumer Delivery del tuo progetto Google Cloud per
restituire solo informazioni specifiche del cliente. Fleet Engine filtra e oscura tutto
altre informazioni nelle risposte. Ad esempio, durante un'attività di indisponibilità,
le informazioni sulla posizione non vengono condivise con un utente finale.
In Fleet Engine, abiliti le seguenti impostazioni per il percorso del consumatore condivisione:
- Le attività utilizzano la proprietà
TaskTrackingViewConfig
. (Facoltativo) - Le attività utilizzano un ID monitoraggio, che la libreria deve identificare pertinenti per un consumatore.
Monitoraggio della flotta
La libreria di monitoraggio del parco risorse JavaScript ti consente di visualizzare le posizioni
veicoli delle loro flotte quasi in tempo reale. La libreria utilizza
L'API Fleet Engine, per fornire la visualizzazione dei veicoli per la consegna e
alle attività assegnate. Come l'SDK consumer di JavaScript, contiene un oggetto JavaScript
componente mappa che sostituisce direttamente un google.maps.Map
standard
con i componenti di dati che utilizzi per connetterti a Fleet Engine.
Questa libreria mostra la visibilità dei veicoli per la consegna non appena vengono in Fleet Engine. Per questa implementazione, utilizzerai Fleet Engine il ruolo Cloud IAM di Super User del servizio e fornisci la richiesta di token web Java per ai veicoli per la consegna e alle attività associate.
Scenari di attività pianificate
Questa sezione mostra una varietà di scenari di attività che riepilogano le informazioni fornita a questo punto della guida. Il suo scopo è quello di aiutarti a comprendere diversi modi per modellare le tue operazioni di trasporto in Fleet Engine, a seconda della tua attività.
Consegna con monitoraggio
Questo scenario di pubblicazione mostra un'attività di interruzione pianificata
assegnate al deposito sia in partenza dal deposito all’inizio del
il viaggio e l'arrivo al deposito alla fine del viaggio. Inoltre,
mostra due attività di consegna per una fermata, una delle quali non è riuscita. Usa questa
per abilitare il monitoraggio da e al deposito e come modo per
gli orari di inizio e di fine della giornata. Nessuna fatturazione
avviene con le attività di interruzione programmata.
Ritiro con consegna in deposito
Questo scenario mostra come modellare un ritiro con la sua l'attività di consegna corrispondente richiesta. Imposti il ritorno al deposito come l'invio ai fini della fatturazione.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/mobility/fleet-engine/essentials/images/taskScenarioPickup.png?authuser=8&hl=it)
Veicolo di alimentazione
Questo scenario mostra due consegne con una fermata centrale per il cui scopo è consentire al veicolo per la consegna di restituire al deposito una serie di pacchi da spedire. Tu Puoi anche modellare il veicolo con alimentatore con una fermata programmata.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/mobility/fleet-engine/essentials/images/taskScenarioFeeder.png?authuser=8&hl=it)
Tempi attività
Definire i tempi delle attività è utile per pianificare i percorsi, gli orari di arrivo stimati e la gestione in modo efficace aspettative di consegna. Fleet Engine offre due funzionalità chiave per modellare prevedere i tempi delle attività, come descritto in questa sezione.
Durata dell'attività
La durata dell'attività è impostata con il campo task_duration
, un campo obbligatorio
modella il tempo previsto che il conducente impiega a completare le attività in corrispondenza di una fermata
o per fare una pausa. Per le fermate, include tutte le attività necessarie
dopo l'arrivo a una fermata, ad esempio dopo aver scaricato i pacchi e aver interagito
destinatario. Più specifiche sono queste informazioni, migliore sarà Fleet Engine
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 di destinazione
L'ora target definisce un intervallo di tempo proposto per un'attività, generalmente utilizzato per
comunicare con i clienti o a fini di pianificazione interna. Lo imposti con
il campo target_time_window
, che consiste in un'ora di inizio e un'ora di fine.
Queste informazioni non influiscono direttamente sui calcoli dei percorsi, ma possono essere utilizzate per
situazione specifica, ad esempio avvisare un consumatore di un intervallo di tempo per un pacco
o quando aspettarsi l'arrivo di un service worker pianificato.
Attributi attività
Gli attributi delle attività in Fleet Engine consentono di filtrare facilmente le attività in base
in base a caratteristiche specifiche quando si utilizza la richiesta ListTasks
. Puoi anche utilizzare
personalizzati per l'analisi con Cloud Logging, oltre a
comunicare informazioni nella condivisione del percorso del consumatore o nel monitoraggio del parco risorse. La
è simile a quello degli attributi dei veicoli: usalo per creare un
una prospettiva più mirata delle tue operazioni di distribuzione.
Limitazioni e restrizioni
- Creazione di attributi personalizzati. Fleet Engine limita il numero di 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, attività non sostituiscono i campi dati delle attività principali. Utilizzali per filtri aggiuntivi in base alle tue esigenze specifiche.
- Ogni attributo deve avere una chiave univoca.
- Non includere informazioni che consentono l'identificazione personale o altri dati sensibili nel valore dell'attributo, che potrebbero essere visibili all'utente.
- Convalida dei dati: assicurati che i tipi di dati e i formati della tua richiesta sono compatibili con i requisiti di Fleet Engine.