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 dell'attività nel formato providers/{providerId}/tasks/{taskId}.

type

enum (TaskTypeLog)

Il tipo di attività.

state

enum (TaskStateLog)

Lo stato di un'attività che indica la sua avanzamento.

taskOutcome

enum (TaskOutcomeLog)

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

taskOutcomeTime

string (Timestamp format)

Il timestamp di quando è stato impostato il risultato dell'attività (dal provider).

Un timestamp nel formato RFC3339 UTC "Zulu" 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 consente di memorizzare un ID per il cliente, in modo da evitare una mappatura non necessaria o complicata.

deliveryVehicleId

string

L'ID del veicolo che esegue questa attività.

plannedLocation

object (LocationInfoLog)

Il luogo in cui viene completata l'attività.

taskDuration

string (Duration format)

Tempo aggiuntivo per eseguire un'azione in questa posizione.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

targetTimeWindow

object (TimeWindowLog)

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

journeySharingInfo

object (JourneySharingInfoLog)

Condivisione del percorso di campi specifici.

taskTrackingViewConfig

object (TaskTrackingViewConfigLog)

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

attributes[]

object (TaskAttributeLog)

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

JourneySharingInfoLog

Condivisione del percorso di campi specifici.

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

object (VehicleJourneySegmentLog)

Informazioni di monitoraggio per ogni fermata in cui si dirigerà il veicolo assegnato prima di completare questa attività. Questo elenco potrebbe contenere fermate di altre attività.

lastLocation

object (DeliveryVehicleLocationLog)

L'ultima posizione segnalata del veicolo.

lastLocationSnappable

boolean

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

TaskTrackingViewConfigLog

Il messaggio di configurazione che definisce quando un elemento 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 delle polilinee della route. Se questo campo non viene specificato, verrà utilizzata la configurazione di visibilità predefinita a livello di progetto per questi dati.

estimatedArrivalTimeVisibility

object (VisibilityOptionLog)

Il campo che specifica quando può essere visibile l'ora di arrivo stimata. Se questo campo non viene specificato, verrà utilizzata la configurazione di 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 di visibilità predefinita a livello di progetto per questi dati.

remainingDrivingDistanceVisibility

object (VisibilityOptionLog)

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

remainingStopCountVisibility

object (VisibilityOptionLog)

Il campo che specifica quando il conteggio delle fermate rimanenti può essere visibile. Se questo campo non viene specificato, verrà utilizzata la configurazione di visibilità predefinita a livello di progetto per questi dati.

vehicleLocationVisibility

object (VisibilityOptionLog)

Il campo che specifica quando la posizione del veicolo può essere visibile. Se questo campo non viene specificato, verrà utilizzata la configurazione di visibilità predefinita a livello di progetto per questi dati.

VisibilityOptionLog

Il messaggio di opzione che definisce quando un elemento dei 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 unione visibility_option.

visibility_option può essere solo uno dei seguenti:

remainingStopCountThreshold

integer

Questo elemento dati è visibile agli utenti finali se il numero di fermate rimanenti è <= higherStopCountThreshold.

durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

Questo elemento di dati è visibile agli utenti finali se l'orario di arrivo stimato verso la fermata è <=durationUntilestimatedArrivalTimeThreshold.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

remainingDrivingDistanceMetersThreshold

integer

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

always

boolean

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

never

boolean

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

TaskAttributeLog

Descrive un attributo attività come coppia chiave-valore. La colonna "key:value" la lunghezza della stringa 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 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 tipo di stringa.

boolValue

boolean

Valore di attributo digitato con valore booleano.

numberValue

number

Valore attributo doppio tipo.