TaskLog

Das Protokoll einer Aufgabenressource in der Deliveries API.

JSON-Darstellung
{
  "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)
    }
  ]
}
Felder
name

string

Der Name der Aufgabenressource im Format providers/{providerId}/tasks/{taskId}.

type

enum (TaskTypeLog)

Der Aufgabentyp.

state

enum (TaskStateLog)

Der Status einer Aufgabe, der ihren Fortschritt angibt.

taskOutcome

enum (TaskOutcomeLog)

Das Ergebnis des Versuchs, eine Aufgabe auszuführen. Wenn TaskState geschlossen ist, zeigt dies an, ob er erfolgreich abgeschlossen wurde.

taskOutcomeTime

string (Timestamp format)

Der Zeitstempel, der angibt, wann das Ergebnis der Aufgabe festgelegt wurde (vom Anbieter).

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

taskOutcomeLocation

object (LocationInfoLog)

Ort, an dem das Ergebnis der Aufgabe festgelegt wurde.

taskOutcomeLocationSource

enum (TaskOutcomeLocationSourceLog)

Gibt an, woher der Wert von taskOutcomeLocation stammt.

trackingId

string

Dieses Feld erleichtert das Speichern einer ID für den Kunden, um eine unnötige oder komplizierte Zuordnung zu vermeiden.

deliveryVehicleId

string

ID des Fahrzeugs, das diese Aufgabe ausführt.

plannedLocation

object (LocationInfoLog)

Der Ort, an dem die Aufgabe abgeschlossen wurde.

taskDuration

string (Duration format)

Zusätzliche Zeit, um eine Aktion an dieser Stelle auszuführen.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

targetTimeWindow

object (TimeWindowLog)

Das Zeitfenster, in dem die Aufgabe abgeschlossen werden sollte.

journeySharingInfo

object (JourneySharingInfoLog)

Bestimmte Felder für die gemeinsame Nutzung von Reisen.

taskTrackingViewConfig

object (TaskTrackingViewConfigLog)

Die Konfiguration für das Aufgaben-Tracking, die angibt, welche Datenelemente unter welchen Umständen für die Endnutzer sichtbar sind.

attributes[]

object (TaskAttributeLog)

Eine Liste benutzerdefinierter Aufgabenattribute. Jedes Attribut muss einen eindeutigen Schlüssel haben.

JourneySharingInfoLog

Bestimmte Felder für die gemeinsame Nutzung von Reisen.

JSON-Darstellung
{
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegmentLog)
    }
  ],
  "lastLocation": {
    object (DeliveryVehicleLocationLog)
  },
  "lastLocationSnappable": boolean
}
Felder
remainingVehicleJourneySegments[]

object (VehicleJourneySegmentLog)

Sendungsverfolgungsinformationen für jede Haltestelle, die das zugewiesene Fahrzeug vor Abschluss dieser Aufgabe erreicht. Diese Liste kann Zwischenstopps aus anderen Aufgaben enthalten.

lastLocation

object (DeliveryVehicleLocationLog)

Der letzte gemeldete Standort des Fahrzeugs.

lastLocationSnappable

boolean

Gibt an, ob die lastLocation des Fahrzeugs an currentRouteSegment ausgerichtet werden kann. False, wenn lastLocation oder currentRouteSegment nicht vorhanden sind.

TaskTrackingViewConfigLog

Die Konfigurationsnachricht, die definiert, wann ein Datenelement einer Aufgabe für Endnutzer sichtbar sein soll.

JSON-Darstellung
{
  "routePolylinePointsVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedArrivalTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "estimatedTaskCompletionTimeVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingDrivingDistanceVisibility": {
    object (VisibilityOptionLog)
  },
  "remainingStopCountVisibility": {
    object (VisibilityOptionLog)
  },
  "vehicleLocationVisibility": {
    object (VisibilityOptionLog)
  }
}
Felder
routePolylinePointsVisibility

object (VisibilityOptionLog)

Das Feld, das angibt, wann Polylinienpunkte der Route sichtbar sind. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration der Sichtbarkeit auf Projektebene für diese Daten verwendet.

estimatedArrivalTimeVisibility

object (VisibilityOptionLog)

Das Feld, das angibt, wann die voraussichtliche Ankunftszeit angezeigt werden kann. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration der Sichtbarkeit auf Projektebene für diese Daten verwendet.

estimatedTaskCompletionTimeVisibility

object (VisibilityOptionLog)

Das Feld, das angibt, wann die geschätzte Aufgabenerledigungszeit angezeigt werden kann. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration der Sichtbarkeit auf Projektebene für diese Daten verwendet.

remainingDrivingDistanceVisibility

object (VisibilityOptionLog)

Das Feld, das die verbleibende Fahrstrecke angibt, kann sichtbar sein. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration der Sichtbarkeit auf Projektebene für diese Daten verwendet.

remainingStopCountVisibility

object (VisibilityOptionLog)

Das Feld, das angibt, wann die Anzahl der verbleibenden Haltestellen sichtbar ist. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration der Sichtbarkeit auf Projektebene für diese Daten verwendet.

vehicleLocationVisibility

object (VisibilityOptionLog)

Das Feld, das angibt, wann der Fahrzeugstandort sichtbar ist. Wenn dieses Feld nicht angegeben ist, wird die Standardkonfiguration der Sichtbarkeit auf Projektebene für diese Daten verwendet.

VisibilityOptionLog

Die Optionsnachricht, die definiert, wann ein Datenelement für Endnutzer sichtbar sein soll.

JSON-Darstellung
{

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

Union-Feld visibility_option.

Für visibility_option ist nur einer der folgenden Werte zulässig:

remainingStopCountThreshold

integer

Dieses Datenelement ist für Endnutzer sichtbar, wenn die Anzahl der verbleibenden Haltestellen <= verbleibendenStopCountThreshold.

durationUntilEstimatedArrivalTimeThreshold

string (Duration format)

Dieses Datenelement ist für Endnutzer sichtbar, wenn die geschätzte Ankunftszeit für die Haltestelle <= durationUntilestimatedArrivalTimeThreshold.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

remainingDrivingDistanceMetersThreshold

integer

Dieses Datenelement ist für Endnutzer sichtbar, wenn die verbleibende Fahrstrecke in Metern <=reDrivingDistanceMetersThreshold ist.

always

boolean

Wenn die Richtlinie auf „true“ gesetzt ist, ist dieses Datenelement für Endnutzer ohne Grenzwerte immer sichtbar.

never

boolean

Wenn die Richtlinie auf „true“ gesetzt ist, wird dieses Datenelement für Endnutzer ohne Grenzwerte immer ausgeblendet.

TaskAttributeLog

Beschreibt ein Aufgabenattribut als Schlüssel/Wert-Paar. Das Schlüssel/Wert-Paar String darf nicht länger als 256 Zeichen sein.

JSON-Darstellung
{
  "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.
}
Felder
key

string

Der Schlüssel des Attributs. Schlüssel dürfen keinen Doppelpunkt (:) enthalten.

Union-Feld task_attribute_value. Der Wert des Attributs kann als String, boolescher oder Double-Wert angegeben werden. Wenn keine Werte festgelegt sind, wird der TaskAttribute string_value als leerer String "" gespeichert. Für task_attribute_value ist nur einer der folgenden Werte zulässig:
stringValue

string

Als String eingegebener Attributwert.

boolValue

boolean

Boolescher Attributwert

numberValue

number

Doppelter Attributwert.