- Risorsa: attività
- Tipo
- TaskOutcomeLocationSource
- JourneySharingInfo
- TaskTrackingViewConfig
- VisibilityOption
- Metodi
Risorsa: attività
Un'attività nell'API Delivery rappresenta una singola azione da monitorare. In generale, esiste una distinzione tra Tasks relativo alla spedizione e Tasks interrotto. A una spedizione possono essere associate più attività. Ad esempio, potrebbe esserci un'attività per il ritiro e un'altra per la consegna o il trasferimento. Inoltre, veicoli diversi possono gestire attività diverse per una determinata spedizione. Ad esempio, un veicolo potrebbe gestire il ritiro, facendo in modo che il pacco arriva fino all'hub, mentre un altro può guidare la stessa spedizione dall'hub al punto di consegna.
Nota: le API gRPC e REST utilizzano convenzioni di denominazione dei campi diverse. Ad esempio, il campo Task.journey_sharing_info
nell'API gRPC e il campo Task.journeySharingInfo
nell'API REST fanno riferimento allo stesso campo.
Rappresentazione JSON |
---|
{ "name": string, "type": enum ( |
Campi | |
---|---|
name |
Deve essere nel formato |
type |
Obbligatoria. Immutabile. Definisce il tipo di attività. Ad esempio, una pausa o una spedizione. |
state |
Obbligatoria. Lo stato di esecuzione attuale dell'attività. |
taskOutcome |
Il risultato dell'attività. |
taskOutcomeTime |
Il timestamp che indica quando il risultato di Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
taskOutcomeLocation |
La località in cui è stato impostato il risultato di |
taskOutcomeLocationSource |
Indica da dove proviene il valore di |
trackingId |
Immutabile. Questo campo facilita l'archiviazione di un ID per evitare di utilizzare una mappatura complicata. Non puoi impostare
|
deliveryVehicleId |
Solo output. L'ID del veicolo su cui è in corso questa attività. Gli ID veicolo per la consegna sono soggetti alle seguenti limitazioni:
|
plannedLocation |
Immutabile. La posizione in cui verrà completata l'attività. Facoltativo per |
taskDuration |
Obbligatoria. Immutabile. Il tempo necessario per eseguire un'attività in questa posizione. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
targetTimeWindow |
La finestra temporale durante la quale deve essere completata l'attività. |
journeySharingInfo |
Solo output. Campi specifici della condivisione del percorso. Non compilato quando lo stato è |
taskTrackingViewConfig |
La configurazione per il monitoraggio delle attività che specifica quali elementi di dati sono visibili agli utenti finali e in quali circostanze. |
attributes[] |
Un elenco di attributi personalizzati delle attività. Ogni attributo deve avere una chiave univoca. |
Tipo
Il tipo di attività.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Impostazione predefinita, il tipo di attività è sconosciuto. |
PICKUP |
Un'attività di ritiro è l'azione intrapresa per ritirare una spedizione da un cliente. I ritiri dei veicoli con feeder o deposito devono essere di tipo SCHEDULED_STOP . |
DELIVERY |
Un'attività di consegna è l'azione intrapresa per consegnare una spedizione a un cliente finale. Le riduzioni dei veicoli per il deposito o la stazione di carico devono essere di tipo SCHEDULED_STOP . |
SCHEDULED_STOP |
Un'attività con interruzione pianificata viene utilizzata a scopo di pianificazione. Ad esempio, potrebbe rappresentare il ritiro o la consegna delle spedizioni dai veicoli con feeder o dai depositi. Non deve essere utilizzato per qualsiasi spedizione ritirata o consegnata da un cliente finale. |
UNAVAILABLE |
Un'attività che indica che il veicolo non è disponibile per il servizio. Ciò può accadere, ad esempio, quando il conducente fa una pausa o quando il veicolo viene rifornito. |
TaskOutcomeLocationSource
L'identità dell'origine che ha compilato taskOutcomeLocation
.
Enum | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
Il risultato dell'attività prima che sia impostato. |
PROVIDER |
Il provider ha specificato taskOutcomeLocation . |
LAST_VEHICLE_LOCATION |
Il provider non ha specificato taskOutcomeLocation , quindi Fleet Engine ha utilizzato l'ultima posizione nota del veicolo. |
JourneySharingInfo
Condivisione di campi specifici nel percorso.
Rappresentazione JSON |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
Campi | |
---|---|
remainingVehicleJourneySegments[] |
Informazioni di monitoraggio relative alle fermate che il veicolo assegnato farà prima che completi questa attività. Tieni presente che questo elenco può contenere fermate da altre attività. Il primo segmento, |
lastLocation |
Indica l'ultima posizione segnalata del veicolo. |
lastLocationSnappable |
Indica se l'ultima posizione del veicolo può essere agganciata a |
TaskTrackingViewConfig
Il messaggio di configurazione che definisce quando un elemento di dati di un'attività deve essere visibile agli utenti finali.
Rappresentazione JSON |
---|
{ "routePolylinePointsVisibility": { object ( |
Campi | |
---|---|
routePolylinePointsVisibility |
Il campo che specifica quando possono essere visibili i punti delle polilinee del percorso. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati. |
estimatedArrivalTimeVisibility |
Il campo che specifica quando può essere visibile l'ora di arrivo prevista. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati. |
estimatedTaskCompletionTimeVisibility |
Il campo che specifica quando può essere visibile il tempo di completamento stimato dell'attività. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati. |
remainingDrivingDistanceVisibility |
Il campo che specifica la distanza percorsa rimanente in auto può essere visibile. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati. |
remainingStopCountVisibility |
Il campo che specifica quando il numero di fermate rimanenti può essere visibile. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati. |
vehicleLocationVisibility |
Il campo che specifica quando può essere visibile la posizione del veicolo. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati. |
VisibilityOption
Il messaggio di opzione che definisce quando un elemento di dati deve essere visibile agli utenti finali.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione visibility_option . È stata scelta l'opzione di visibilità specifica. visibility_option può essere solo uno dei seguenti: |
|
remainingStopCountThreshold |
Questo elemento di dati è visibile agli utenti finali se il numero di fermate rimanenti è <= leftStopCountThreshold. |
durationUntilEstimatedArrivalTimeThreshold |
Questo elemento di dati è visibile agli utenti finali se l'orario di arrivo stimato fino alla fermata <= <= perioduntiltopArrivalTimeThreshold. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
remainingDrivingDistanceMetersThreshold |
Questo elemento di dati è visibile agli utenti finali se la distanza percorsa restante in metri è pari a <= reindirizzare securityDistanceMetersThreshold. |
always |
Se viene impostato su true, questo elemento di dati è sempre visibile agli utenti finali senza soglie. Questo campo non può essere impostato su false. |
never |
Se viene impostato su true, questo elemento di dati è sempre nascosto agli utenti finali senza soglie. Questo campo non può essere impostato su false. |
Metodi |
|
---|---|
|
Crea e restituisce un batch di nuovi oggetti Task . |
|
Crea e restituisce un nuovo oggetto Task . |
|
Recupera informazioni su un Task . |
|
Recupera tutti i valori Task che soddisfano i criteri di filtro specificati. |
|
Aggiorna i dati di Task . |