TaskLog

Il log di una risorsa Tasks nell'API Deliveries.

Rappresentazione JSON
{
  "name": string,
  "type": enum (TaskTypeLog),
  "state": enum (TaskStateLog),
  "taskOutcome": enum (TaskOutcomeLog),
  "taskOutcomeTime": string,
  "taskOutcomeLocation": {
    object (LocationInfoLog)
  },
  "taskOutcomeLocationSource": enum (TaskOutcomeLocationSourceLog),
  "trackingId": string,
  "deliveryVehicleId": string,
  "plannedLocation": {
    object (LocationInfoLog)
  },
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindowLog)
  },
  "journeySharingInfo": {
    object (JourneySharingInfoLog)
  },
  "taskTrackingViewConfig": {
    object (TaskTrackingViewConfigLog)
  },
  "attributes": [
    {
      object (TaskAttributeLog)
    }
  ]
}
Campi
name

string

Il nome della risorsa attività nel formato providers/{providerId}/tasks/{taskId}.

type

enum (TaskTypeLog)

Il tipo di attività.

state

enum (TaskStateLog)

Lo stato di un'attività che ne indica l'avanzamento.

taskOutcome

enum (TaskOutcomeLog)

Il risultato del tentativo di eseguire un'attività. Quando TaskState è chiuso, indica se è stato completato correttamente.

taskOutcomeTime

string (Timestamp format)

Il timestamp relativo al momento in cui è stato impostato il risultato dell'attività (dal provider).

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

taskOutcomeLocation

object (LocationInfoLog)

Località in cui è stato impostato il risultato dell'attività.

taskOutcomeLocationSource

enum (TaskOutcomeLocationSourceLog)

Indica la provenienza del valore di taskOutcomeLocation.

trackingId

string

Questo campo facilita l'archiviazione di un ID per il cliente per evitare una mappatura superflua o complicata.

deliveryVehicleId

string

L'ID del veicolo che sta eseguendo questa attività.

plannedLocation

object (LocationInfoLog)

La posizione in cui viene completata l'attività.

taskDuration

string (Duration format)

Tempo aggiuntivo per eseguire un'azione in questa località.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

targetTimeWindow

object (TimeWindowLog)

L'intervallo di tempo durante il quale deve essere completata l'attività.

journeySharingInfo

object (JourneySharingInfoLog)

Campi specifici della condivisione del percorso.

taskTrackingViewConfig

object (TaskTrackingViewConfigLog)

La configurazione per il monitoraggio delle attività che specifica quali elementi di dati sono visibili agli utenti finali in quali circostanze.

attributes[]

object (TaskAttributeLog)

Un elenco di attributi di attività personalizzati. Ogni attributo deve avere una chiave univoca.

JourneySharingInfoLog

Campi specifici della condivisione del percorso.

Rappresentazione JSON
{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegmentLog)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocationLog)
  },
  "lastLocationSnappable": boolean
}
Campi
remainingVehicleJourneySegments[]

object (VehicleJourneySegmentLog)

Informazioni di tracciamento per ogni fermata che il veicolo assegnato raggiungerà prima di completare questa attività. Questo elenco potrebbe contenere fermate da altre attività.

lastLocation

object (DeliveryVehicleLocationLog)

L'ultima posizione segnalata del veicolo.

lastLocationSnappable

boolean

Indica se il lastLocation del veicolo può essere agganciato a currentRouteSegment. False se lastLocation o currentRouteSegment non esistono.

TaskTrackingViewConfigLog

Il messaggio di configurazione che definisce quando un elemento di dati di un'attività deve essere visibile agli utenti finali.

Rappresentazione JSON
{
  "routePolylinePointsVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOptionLog)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOptionLog)
  }
}
Campi
routePolylinePointsVisibility

object (VisibilityOptionLog)

Il campo che specifica quando possono essere visibili i punti della polilinea del percorso. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati.

estimatedArrivalTimeVisibility

object (VisibilityOptionLog)

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

object (VisibilityOptionLog)

Il campo che specifica quando può essere visibile il tempo stimato di completamento dell'attività. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati.

remainingDrivingDistanceVisibility

object (VisibilityOptionLog)

Il campo che specifica la distanza percorsa rimanente può essere visibile. Se questo campo non viene specificato, verrà utilizzata la configurazione della visibilità predefinita a livello di progetto per questi dati.

remainingStopCountVisibility

object (VisibilityOptionLog)

Il campo che specifica il numero di interruzioni 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

object (VisibilityOptionLog)

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.

VisibilityOptionLog

Il messaggio di opzione che definisce quando un elemento di dati deve essere visibile agli utenti finali.

Rappresentazione JSON
{

  // Union field visibility_option can be only one of the following:
  "remainingStopCountThreshold": integer,
  "durationUntilEstimatedArrivalTimeThreshold": string,
  "remainingDrivingDistanceMetersThreshold": integer,
  "always": boolean,
  "never": boolean
  // End of list of possible types for union field visibility_option.
}
Campi

Campo di unione visibility_option.

visibility_option può essere solo uno dei seguenti:

remainingStopCountThreshold

integer

Questo elemento di dati è visibile agli utenti finali se il numero di arresti anomali rimanente è <= restStopCountThreshold.

durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

Questo elemento di dati è visibile agli utenti finali se l'orario di arrivo stimato fino alla fermata è pari a <= avevatenEstimatedArrivalTimeThreshold.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

remainingDrivingDistanceMetersThreshold

integer

Questo elemento di dati è visibile agli utenti finali se la distanza percorsa rimanente in metri è <= leftDrivingDistanceMetersThreshold.

always

boolean

Se viene impostato su true, questo elemento di dati è sempre visibile agli utenti finali senza soglie.

never

boolean

Se impostato su true, questo elemento di dati è sempre nascosto agli utenti finali senza soglie.

TaskAttributeLog

Descrive un attributo di un'attività come coppia chiave-valore. La lunghezza della stringa "key:value" non può superare i 256 caratteri.

Rappresentazione JSON
{
  "key": string,

  // Union field task_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field task_attribute_value.
}
Campi
key

string

La chiave dell'attributo. Le chiavi non possono contenere i due punti (:).

Campo di unione task_attribute_value. Il valore dell'attributo può essere di tipo stringa, bool o doppio. Se non viene impostato alcun valore, il valore string_value di TaskAttribute verrà memorizzato come stringa vuota "". task_attribute_value può essere solo uno dei seguenti:
stringValue

string

Valore dell'attributo di tipo stringa.

boolValue

boolean

Valore dell'attributo di tipo booleano.

numberValue

number

Valore dell'attributo di tipo doppio.