- Ressource: Aufgabe
- Typ
- TaskOutcomeLocationSource
- JourneySharingInfo
- TaskTrackingViewConfig
- VisibilityOption
- Methoden
Ressource: Task
Eine Aufgabe in der Delivery API stellt eine einzelne zu verfolgende Aktion dar. Im Allgemeinen wird zwischen lieferungsbezogenen Aufgaben und nicht funktionsfähigen Aufgaben unterschieden. Einer Sendung können mehrere Tasks zugeordnet sein. Zum Beispiel könnte es eine Aufgabe für den Abholvorgang und eine für das Einsteigen oder Umsteigen geben. Außerdem können unterschiedliche Aufgaben für eine bestimmte Sendung von verschiedenen Fahrzeugen abgewickelt werden. Zum Beispiel könnte ein Fahrzeug die Abholung erledigen und die Sendung zum Hub leiten, während ein anderes Fahrzeug dieselbe Sendung vom Hub an die Abgabestelle fährt.
Hinweis: gRPC und REST APIs verwenden unterschiedliche Namenskonventionen für Felder. Beispielsweise beziehen sich das Feld Task.journey_sharing_info
in der gRPC API und das Feld Task.journeySharingInfo
in der REST API auf dasselbe Feld.
JSON-Darstellung |
---|
{ "name": string, "type": enum ( |
Felder | |
---|---|
name |
Muss das Format |
type |
Erforderlich. Nicht veränderbar. Definiert den Aufgabentyp. Dies kann beispielsweise eine Pause oder eine Sendung sein. |
state |
Erforderlich. Der aktuelle Ausführungsstatus der Aufgabe. |
taskOutcome |
Das Ergebnis der Aufgabe. |
taskOutcomeTime |
Der Zeitstempel, der angibt, wann das Ergebnis des Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
taskOutcomeLocation |
Der Ort, an dem das Ergebnis des |
taskOutcomeLocationSource |
Gibt an, woher der Wert für |
trackingId |
Nicht veränderbar. Dieses Feld erleichtert das Speichern einer ID, sodass Sie eine komplizierte Zuordnung vermeiden können. Sie können
|
deliveryVehicleId |
Nur Ausgabe. Die ID des Fahrzeugs, das diese Task ausführt. Für Lieferfahrzeug-IDs gelten die folgenden Einschränkungen:
|
plannedLocation |
Nicht veränderbar. Der Ort, an dem die Aufgabe erledigt wird. Optional für |
taskDuration |
Erforderlich. Nicht veränderbar. Die Zeit, die zum Ausführen einer Aufgabe an diesem Standort benötigt wird. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
targetTimeWindow |
Das Zeitfenster, in dem die Aufgabe abgeschlossen werden soll. |
journeySharingInfo |
Nur Ausgabe. Spezifische Felder für die Kursfreigabe. Wird nicht gefüllt, wenn der Status |
taskTrackingViewConfig |
Die Konfiguration für das Aufgaben-Tracking, die angibt, welche Datenelemente unter welchen Umständen für die Endnutzer sichtbar sind. |
attributes[] |
Eine Liste benutzerdefinierter Aufgabenattribute. Jedes Attribut muss einen eindeutigen Schlüssel haben. |
Typ
Die Art der Aufgabe.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Standardmäßig ist der Aufgabentyp unbekannt. |
PICKUP |
Eine Abholaufgabe ist die Aktion, bei der eine Lieferung von einem Kunden abgeholt wird. Für Abholer in Depots oder Zubringern muss der Typ SCHEDULED_STOP verwendet werden. |
DELIVERY |
Eine Lieferaufgabe ist die Aktion, die für die Lieferung einer Sendung an einen Endkunden ergriffen wird. Für Abgaben von Depots oder Zubringern sollte der Typ SCHEDULED_STOP verwendet werden. |
SCHEDULED_STOP |
Eine Aufgabe für geplante Stopps wird zu Planungszwecken verwendet. Dabei kann es sich zum Beispiel um das Abholen oder Ausgeben von Lieferungen in Zubringern oder Depots handeln. Es sollte nicht für Sendungen verwendet werden, die von einem Endkunden abgeholt oder abgegeben werden. |
UNAVAILABLE |
Eine Aufgabe, bei der das Fahrzeug nicht verfügbar ist. Das kann beispielsweise passieren, wenn der Fahrer eine Pause macht oder wenn das Fahrzeug aufgetankt wird. |
TaskOutcomeLocationSource
Die Identität der Quelle, die taskOutcomeLocation
ausgefüllt hat.
Enums | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
Das Ergebnis der Aufgabe, bevor es festgelegt wird. |
PROVIDER |
Der Anbieter hat taskOutcomeLocation angegeben. |
LAST_VEHICLE_LOCATION |
Der Anbieter hat taskOutcomeLocation nicht angegeben, sodass Fleet Engine den letzten bekannten Fahrzeugstandort verwendet hat. |
JourneySharingInfo
Spezielle Felder der Onlinerecherche
JSON-Darstellung |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
Felder | |
---|---|
remainingVehicleJourneySegments[] |
Tracking-Informationen für die Haltestellen, die das zugewiesene Fahrzeug machen wird, bevor es diese Aufgabe abschließt. Beachten Sie, dass diese Liste Haltestellen von anderen Aufgaben enthalten kann. Das erste Segment, |
lastLocation |
Gibt den letzten gemeldeten Standort des zugewiesenen Fahrzeugs an. |
lastLocationSnappable |
Gibt an, ob der letzteStandort des Fahrzeugs an |
TaskTrackingViewConfig
Die Konfigurationsnachricht, die definiert, wann ein Datenelement einer Aufgabe für die Endnutzer sichtbar sein soll.
JSON-Darstellung |
---|
{ "routePolylinePointsVisibility": { object ( |
Felder | |
---|---|
routePolylinePointsVisibility |
Das Feld, das angibt, wann Polylinienpunkte der Route sichtbar sein können. Wenn dieses Feld nicht angegeben ist, wird für diese Daten die Konfiguration der Standardsichtbarkeit auf Projektebene verwendet. |
estimatedArrivalTimeVisibility |
Das Feld, das angibt, wann die voraussichtliche Ankunftszeit sichtbar sein soll. Wenn dieses Feld nicht angegeben ist, wird für diese Daten die Konfiguration der Standardsichtbarkeit auf Projektebene verwendet. |
estimatedTaskCompletionTimeVisibility |
Das Feld, das angibt, wann die geschätzte Fertigstellungszeit für Aufgaben sichtbar sein kann. Wenn dieses Feld nicht angegeben ist, wird für diese Daten die Konfiguration der Standardsichtbarkeit auf Projektebene verwendet. |
remainingDrivingDistanceVisibility |
Das Feld, das angibt, wann die verbleibende Fahrstrecke sichtbar sein soll. Wenn dieses Feld nicht angegeben ist, wird für diese Daten die Konfiguration der Standardsichtbarkeit auf Projektebene verwendet. |
remainingStopCountVisibility |
Das Feld, das angibt, wann die Anzahl der verbleibenden Haltestellen sichtbar sein soll. Wenn dieses Feld nicht angegeben ist, wird für diese Daten die Konfiguration der Standardsichtbarkeit auf Projektebene verwendet. |
vehicleLocationVisibility |
Das Feld, das angibt, wann der Fahrzeugstandort sichtbar ist. Wenn dieses Feld nicht angegeben ist, wird für diese Daten die Konfiguration der Standardsichtbarkeit auf Projektebene verwendet. |
VisibilityOption
Die Optionsnachricht, die definiert, wann ein Datenelement für die Endnutzer sichtbar sein soll.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld visibility_option . Die ausgewählte Sichtbarkeitsoption. Für visibility_option ist nur einer der folgenden Werte zulässig: |
|
remainingStopCountThreshold |
Dieses Datenelement ist für die Endnutzer sichtbar, wenn die Anzahl der verbleibenden Haltestellen <= RemainingStopCountThreshold kleiner ist. |
durationUntilEstimatedArrivalTimeThreshold |
Dieses Datenelement ist für Endnutzer sichtbar, wenn die voraussichtliche Ankunftszeit für die Haltestelle kleiner als „durationUntilestimatedArrivalTimeThreshold“ ist. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
remainingDrivingDistanceMetersThreshold |
Dieses Datenelement ist für die Endnutzer sichtbar, wenn die verbleibende Fahrstrecke in Metern <= gleichbleibendDrivingDistanceMetersThreshold ist. |
always |
Wenn die Richtlinie auf „true“ gesetzt ist, ist dieses Datenelement für Endnutzer ohne Grenzwerte immer sichtbar. Dieses Feld darf nicht auf "false" gesetzt werden. |
never |
Wenn die Richtlinie auf „true“ gesetzt ist, wird dieses Datenelement für Endnutzer ohne Schwellenwerte immer ausgeblendet. Dieses Feld darf nicht auf "false" gesetzt werden. |
Methoden |
|
---|---|
|
Erstellt einen Batch neuer Task -Objekte und gibt ihn zurück. |
|
Erstellt ein neues Task -Objekt und gibt es zurück. |
|
Ruft Informationen zu Task ab. |
|
Ruft alle Task s ab, die die angegebenen Filterkriterien erfüllen. |
|
Aktualisiert Task -Daten. |