VehicleJourneySegment

Stellt das Fahrtsegment eines Fahrzeugs dar – von der vorherigen Haltestelle bis zur aktuellen Haltestelle. Wenn es sich um die erste aktive Haltestelle handelt, gelangt sie von der aktuellen Position des Fahrzeugs zu dieser Haltestelle.

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

object (VehicleStop)

Gibt den Standort der Haltestelle sowie die mit der Haltestelle verknüpften Task an. Einige Felder des „VehicleStop“ sind möglicherweise nicht vorhanden, wenn dieses Fahrtsegment zu JourneySharingInfo gehört.

drivingDistanceMeters

integer

Nur Ausgabe. Die Fahrstrecke von der vorherigen Haltestelle zu dieser Haltestelle. Wenn die aktuelle Haltestelle die erste Haltestelle in der Liste der Fahrtabschnitte ist, ist der Startpunkt der Standort des Fahrzeugs, der zum Zeitpunkt der Aufnahme dieser Haltestelle in die Liste erfasst wurde. Dieses Feld ist möglicherweise nicht vorhanden, wenn dieses Navigationssegment Teil von JourneySharingInfo ist.

drivingDuration

string (Duration format)

Nur Ausgabe. Die Fahrtzeit von der vorherigen Haltestelle zu dieser Haltestelle. Wenn die aktuelle Haltestelle die erste Haltestelle in der Liste der Fahrtabschnitte ist, ist der Startpunkt der Standort des Fahrzeugs, der zum Zeitpunkt der Aufnahme dieser Haltestelle in die Liste erfasst 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) gefüllt werden. Hier sehen Sie die verbleibende Fahrdauer ab dem letzten bekannten Standort der Fahrer App, nicht die Fahrzeit ab der vorherigen Haltestelle.

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

path[]

object (LatLng)

Nur Ausgabe. Der Weg von der vorherigen Haltestelle zu dieser Haltestelle. Wenn die aktuelle Haltestelle die erste Haltestelle in der Liste der Fahrtsegmente ist, ist dies der Weg vom aktuellen Standort des Fahrzeugs zu dieser Haltestelle zum Zeitpunkt, als die Haltestelle der Liste hinzugefügt wurde. Dieses Feld ist möglicherweise nicht vorhanden, wenn dieses Navigationssegment 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 ausgefüllt werden, die aus DeliveryVehicle.current_route_segment (gRPC) oder DeliveryVehicle.currentRouteSegment (REST) decodiert wurden. Dies liefert den Fahrweg vom letzten bekannten Standort der Fahrer-App anstelle des Pfads von der vorherigen Haltestelle.

VehicleStop

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

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

object (LocationInfo)

Erforderlich. Der Standort der Haltestelle. Die Standorte in den Tasks stimmen möglicherweise nicht genau mit diesem Standort überein, befinden sich aber in unmittelbarer Nähe. Dieses Feld wird in der Antwort eines tasks.get-Aufrufs nicht ausgefüllt.

tasks[]

object (TaskInfo)

Die Liste der Tasks, die an dieser Haltestelle ausgeführt werden sollen. Dieses Feld wird in der Antwort eines tasks.get-Aufrufs nicht ausgefüllt.

state

enum (State)

Der Status von VehicleStop. Dieses Feld wird in der Antwort eines tasks.get-Aufrufs nicht ausgefüllt.

TaskInfo

Zusätzliche Informationen zur Aufgabe, die an dieser Haltestelle ausgeführt wird.

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

string

Die Aufgaben-ID. Dieses Feld wird in der Antwort eines tasks.get-Aufrufs nicht ausgefüllt. Für Aufgaben-IDs gelten die folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Sie ist auf maximal 64 Zeichen beschränkt.
  • Normalisiert gemäß Unicode-Normalisierungsform C.
  • Darf keines der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.
taskDuration

string (Duration format)

Nur Ausgabe. Die Zeit, die für die Ausführung der Aufgabe erforderlich ist.

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

targetTimeWindow

object (TimeWindow)

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

Status

Der aktuelle Status einer VehicleStop.

Enums
STATE_UNSPECIFIED Unbekannt
NEW Erstellt, aber nicht aktiv geroutet.
ENROUTE Zugewiesen und aktiv geroutet.
ARRIVED An der Haltestelle angekommen. Es wird davon ausgegangen, dass alle vorherigen Haltestellen bereits angefahren wurden, wenn das Fahrzeug zur nächsten Haltestelle fährt.