Attività pianificate

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 un DeliveryVehicle. Fleet Engine fornisce sia un servizio gRPC sia un servizio REST interfacce:
  • Task: gRPC e REST
  • DeliveryVehicle: gRPC e REST
  • Per semplicità, questo manuale utilizza esempi di gRPC.

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.

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.

Requisiti per gli ID attività

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	Nessuna informazione che consente l'identificazione personale (PII) o dati di testo chiari. Stringhe Unicode valide. Massimo 64 caratteri. Escludi i seguenti caratteri: / : \ ? # Normalizzato in base a Modulo C di normalizzazione Unicode.

Esempi di ID attività

Esempi di ID attività efficaci	566c33d9-2a31-4b6a-9cd4-80ba1a0c643b e4708eabcfa39bf2767c9546c9273f747b4626e8cc44e9630d50f6d129013d38 NTA1YTliYWNkYmViMTI0ZmMzMWFmOWY2NzNkM2Jk
ID attività non consentiti	8/31/2019-20:48-46.70746,-130.10807,-85.17909,61.33680 JohnDoe-577b484da26f-Cupertino-SantaCruz 4R0oXLToF"112 Summer Dr. East Hartford, CT06118"577b484da26f8a

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à delle attività

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à.

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.

Passaggi successivi

• Configura Fleet Engine
• Creare veicoli
• Creare percorsi programmati