VehicleJourneySegment

Die Fahrstrecke eines Fahrzeugs – 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 die Position der Haltestelle zusammen mit den mit der Haltestelle verknüpften Tasks an. Einige Felder von VehicleStop sind möglicherweise nicht vorhanden, wenn dieses Fahrtsegment zu JourneySharingInfo gehört.

drivingDistanceMeters

integer

Nur Ausgabe. Die Entfernung von der vorherigen Haltestelle bis 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 Fahrtabschnitte ist, ist der Startpunkt der Standort des Fahrzeugs, der erfasst wurde, als die 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) gefü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 Pfadsegment 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. Hier wird die Fahrstrecke ab dem letzten bekannten Standort der Fahrer-App angegeben, nicht der Pfad 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. Die Position der Haltestelle. Beachten Sie, dass die Standorte in den Tasks möglicherweise nicht genau mit diesem Standort übereinstimmen, aber nicht weit davon entfernt sind. Dieses Feld wird in der Antwort auf einen tasks.get-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-Aufruf nicht ausgefüllt.

state

enum (State)

Der Status von VehicleStop. Dieses Feld wird in der Antwort auf einen tasks.get-Aufruf 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 auf einen tasks.get-Aufruf 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. Dies wird nur in der Antwort auf deliveryVehicles.get festgelegt.

Status

Der aktuelle Status einer VehicleStop.

Enums
STATE_UNSPECIFIED Unbekannt
NEW Wird erstellt, aber nicht aktiv weitergeleitet.
ENROUTE Zugewiesen und aktiv weitergeleitet.
ARRIVED An der Haltestelle angekommen. Geht davon aus, dass alle vorherigen Haltestellen auf der Route des Fahrzeugs zur nächsten Haltestelle beendet wurden.