VehicleJourneySegment

Stellt das Reisesegment eines Fahrzeugs dar, d. h. von seiner vorherigen Haltestelle bis zur aktuellen Haltestelle. Wenn es sich um die erste aktive Haltestelle handelt, wird der Standort vom aktuellen Standort des Fahrzeugs bis zu dieser Haltestelle verschoben.

JSON-Darstellung
{
  "stop": {
    object (VehicleStop)
  },
  "drivingDistanceMeters": integer,
  "drivingDuration": string,
  "path": [
    {
      object (LatLng)
    }
  ]
}
Felder
stop

object (VehicleStop)

Gibt die Position der Haltestelle zusammen mit den der Haltestelle zugeordneten Task-Werten an. Einige Felder von VehicleStop sind möglicherweise nicht vorhanden, wenn dieser Fahrtabschnitt Teil von JourneySharingInfo ist.

drivingDistanceMeters

integer

Nur Ausgabe Die Strecke von der vorherigen Haltestelle bis zu dieser Haltestelle. Wenn die aktuelle Haltestelle die erste Haltestelle in der Liste der Fahrtsegmente ist, wird als Startpunkt der Standort des Fahrzeugs verwendet, der zu dem Zeitpunkt erfasst wurde, zu dem diese Haltestelle der Liste hinzugefügt wurde. Dieses Feld ist möglicherweise nicht vorhanden, wenn dieser Fahrtabschnitt Teil von JourneySharingInfo ist.

drivingDuration

string (Duration format)

Nur Ausgabe Die Fahrtzeit von der vorherigen Haltestelle bis zu dieser Haltestelle. Wenn die aktuelle Haltestelle die erste Haltestelle in der Liste der Fahrtsegmente ist, ist der Startpunkt der Standort des Fahrzeugs, der zu dem Zeitpunkt erfasst wurde, zu dem diese Haltestelle der Liste hinzugefügt wurde.

Wenn dieses Feld im Pfad Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) oder Task.remainingVehicleJourneySegments[0].drivingDuration (REST) definiert ist, kann es mit dem Wert aus DeliveryVehicle.remaining_duration (gRPC) oder DeliveryVehicle.remainingDuration (REST) ausgefüllt werden. Damit wird die verbleibende Fahrtzeit vom letzten bekannten Standort der Fahrer-App abgerufen und nicht der Fahrtzeit vom vorherigen Halt an.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".

path[]

object (LatLng)

Nur Ausgabe Pfad von der vorherigen Haltestelle bis zu dieser Haltestelle. Wenn die aktuelle Haltestelle die erste Haltestelle in der Liste der Fahrtsegmente ist, ist dies der Pfad vom aktuellen Standort des Fahrzeugs zu dieser Haltestelle zu dem Zeitpunkt, als die Haltestelle der Liste hinzugefügt wurde. Dieses Feld ist möglicherweise nicht vorhanden, wenn dieser Fahrtabschnitt Teil von JourneySharingInfo ist.

Wenn dieses Feld im Pfad Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) oder Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) definiert ist, kann es mit den LatLngs gefüllt werden, die aus DeliveryVehicle.current_route_segment (gRPC) oder DeliveryVehicle.currentRouteSegment (REST) decodiert wurden. Dadurch wird die Fahrstrecke vom letzten bekannten Standort der Fahrer-App und nicht der Pfad vom vorherigen Halt abgerufen.

VehicleStop

Beschreibt einen Punkt, an dem ein Fahrzeug anhält, um einen oder mehrere Tasks auszuführen.

JSON-Darstellung
{
  "plannedLocation": {
    object (LocationInfo)
  },
  "tasks": [
    {
      object (TaskInfo)
    }
  ],
  "state": enum (State)
}
Felder
plannedLocation

object (LocationInfo)

Erforderlich. Die Position der Haltestelle. Die Standorte in den Tasks stimmen möglicherweise nicht genau mit diesem Standort überein, sind aber nicht weit entfernt. Dieses Feld wird in der Antwort auf einen tasks.get- oder tasks.search-Aufruf nicht ausgefüllt.

tasks[]

object (TaskInfo)

Die Liste der Tasks, die an dieser Haltestelle ausgeführt werden sollen. Dieses Feld wird in der Antwort auf einen tasks.get- oder tasks.search-Aufruf nicht ausgefüllt.

state

enum (State)

Der Status von VehicleStop. Dieses Feld wird in der Antwort auf einen tasks.get- oder tasks.search-Aufruf nicht ausgefüllt.

TaskInfo

Zusätzliche Informationen zur an dieser Haltestelle ausgeführten Aufgabe.

JSON-Darstellung
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
Felder
taskId

string

Die Aufgaben-ID. Dieses Feld wird in der Antwort auf einen tasks.get- oder tasks.search-Aufruf nicht ausgefüllt. Aufgaben-IDs unterliegen den folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Er ist auf maximal 64 Zeichen begrenzt.
  • Normalisiert nach der Unicode-Normalisierungsform C.
  • Darf keine der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.
taskDuration

string (Duration format)

Nur Ausgabe Die zur Ausführung der Aufgabe erforderliche Zeit.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".

targetTimeWindow

object (TimeWindow)

Nur Ausgabe Das Zeitfenster, in dem die Aufgabe abgeschlossen werden soll. Dies wird nur in der Antwort auf deliveryVehicles.get festgelegt.

Status

Der aktuelle Status eines VehicleStop-Objekts.

Enums
STATE_UNSPECIFIED Unbekannt.
NEW Erstellt, aber keine aktive Weiterleitung
ENROUTE Zugewiesen und aktiv weitergeleitet.
ARRIVED An Haltestelle angekommen. Es wird davon ausgegangen, dass bei der Routenplanung des Fahrzeugs zur nächsten Haltestelle alle vorherigen Haltestellen abgeschlossen sind.