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 erfasst wurde, als die Haltestelle der Liste hinzugefügt wurde. Dieses Feld ist möglicherweise nicht vorhanden, wenn dieses Pfadsegment 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 Fahrtsegmente 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) ausgefüllt werden. Dadurch wird die verbleibende Fahrtdauer vom letzten bekannten Standort der Fahrer-App und nicht von der Fahrzeit von der vorherigen Haltestelle abgerufen.

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 Fahrtabschnitte 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 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 Pfades von der vorherigen Haltestelle.

VehicleStop

Beschreibt einen Punkt, an dem ein Fahrzeug anhält, um eine oder mehrere Tasks 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 auf einen tasks.get-Aufruf 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 wurde.

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. Aufgaben-IDs unterliegen den folgenden Einschränkungen:

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

string (Duration format)

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

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 abgeschlossen werden sollte. 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 weitergeleitet.
ARRIVED An der Haltestelle angekommen. Es wird davon ausgegangen, dass auf der Route des Fahrzeugs zur nächsten Haltestelle alle vorherigen Haltestellen abgeschlossen wurden.