REST Resource: providers.tasks

{
  "name": string,
  "type": enum (Type),
  "state": enum (State),
  "taskOutcome": enum (TaskOutcome),
  "taskOutcomeTime": string,
  "taskOutcomeLocation": {
    object (LocationInfo)
  },
  "taskOutcomeLocationSource": enum (TaskOutcomeLocationSource),
  "trackingId": string,
  "deliveryVehicleId": string,
  "plannedLocation": {
    object (LocationInfo)
  },
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  },
  "journeySharingInfo": {
    object (JourneySharingInfo)
  },
  "taskTrackingViewConfig": {
    object (TaskTrackingViewConfig)
  },
  "attributes": [
    {
      object (TaskAttribute)
    }
  ]
}

string

Deve essere nel formato providers/{provider}/tasks/{task}.

enum (Type)

obbligatorio. Immutabile. Definisce il tipo di attività. Ad esempio, una pausa o una spedizione.

enum (State)

obbligatorio. Lo stato di esecuzione attuale dell'attività.

enum (TaskOutcome)

Il risultato dell'attività.

string (Timestamp format)

Il timestamp che indica quando il risultato di Task è stato impostato dal provider.

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

object (LocationInfo)

La località in cui è stato impostato il risultato di Task. Questo valore viene aggiornato nell'ambito di tasks.patch. Se questo valore non viene aggiornato esplicitamente dal fornitore, Fleet Engine lo completa per impostazione predefinita con l'ultima posizione nota del veicolo (la posizione grezza).

enum (TaskOutcomeLocationSource)

Indica da dove proviene il valore di taskOutcomeLocation.

string

Immutabile. Questo campo facilita l'archiviazione di un ID per evitare di utilizzare una mappatura complicata. Non puoi impostare trackingId per attività di tipo UNAVAILABLE e SCHEDULED_STOP. Questi ID sono soggetti alle seguenti limitazioni:

• Deve essere una stringa Unicode valida.
• Lunghezza massima: 64 caratteri.
• Normalizzata secondo lo standard Unicode Normalization Form C.
• Non può contenere nessuno dei seguenti caratteri ASCII: "/", ":", "?", "," o "#".

string

Solo output. L'ID del veicolo su cui è in corso questa attività. Gli ID veicolo per la consegna sono soggetti alle seguenti limitazioni:

• Deve essere una stringa Unicode valida.
• Lunghezza massima: 64 caratteri.
• Normalizzata secondo lo standard Unicode Normalization Form C.
• Non può contenere nessuno dei seguenti caratteri ASCII: "/", ":", "?", "," o "#".

object (LocationInfo)

Immutabile. La posizione in cui verrà completata l'attività. Facoltativo per UNAVAILABLE Tasks, ma obbligatorio per tutte le altre attività.

string (Duration format)

obbligatorio. 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 "s". Esempio: "3.5s".

object (TimeWindow)

La finestra temporale durante la quale deve essere completata l'attività.

object (JourneySharingInfo)

Solo output. Campi specifici della condivisione del percorso. Non compilato quando lo stato è CLOSED.

object (TaskTrackingViewConfig)

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

object (TaskAttribute)

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

{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "lastLocationSnappable": boolean
}

object (VehicleJourneySegment)

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, Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) o Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST), contiene informazioni sul percorso dall'ultima posizione nota del conducente al VehicleStop successivo. Le informazioni sul percorso corrente in genere provengono dall'app del conducente, ad eccezione di alcuni casi indicati nella documentazione di DeliveryVehicle.current_route_segment. Gli altri segmenti in Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) o Task.journeySharingInfo.remainingVehicleJourneySegments (REST) vengono compilati da Fleet Engine. Forniscono informazioni sul percorso tra i restanti VehicleStops.

object (DeliveryVehicleLocation)

Indica l'ultima posizione segnalata del veicolo.

boolean

Indica se l'ultima posizione del veicolo può essere agganciata a currentRouteSegment. Questo valore è False se lastLocation o currentRouteSegment non esistono. Questo valore viene calcolato da Fleet Engine. Gli aggiornamenti dai client vengono ignorati.

{
  "routePolylinePointsVisibility": {
    object (VisibilityOption)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOption)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOption)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOption)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOption)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOption)
  }
}

object (VisibilityOption)

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.

object (VisibilityOption)

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.

object (VisibilityOption)

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.

object (VisibilityOption)

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.

object (VisibilityOption)

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.

object (VisibilityOption)

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.

{

  // 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.
}

integer

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

string (Duration format)

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 "s". Esempio: "3.5s".

integer

Questo elemento di dati è visibile agli utenti finali se la distanza percorsa restante in metri è pari a <= reindirizzare securityDistanceMetersThreshold.

boolean

Se viene impostato su true, questo elemento di dati è sempre visibile agli utenti finali senza soglie. Questo campo non può essere impostato su false.

boolean

Se viene impostato su true, questo elemento di dati è sempre nascosto agli utenti finali senza soglie. Questo campo non può essere impostato su false.