VehicleJourneySegment

Stellt das Reisesegment eines Fahrzeugs dar, also von der vorherigen Haltestelle bis zur aktuellen Haltestelle. Wenn es die erste aktive Haltestelle ist, wird sie vom aktuellen Standort des Fahrzeugs 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 mit der Haltestelle verknüpften Tasks an. Einige Felder von VehicleStop sind nicht vorhanden, wenn dieser Fahrtabschnitt Teil von JourneySharingInfo ist.

drivingDistanceMeters

integer

Nur Ausgabe. Die Entfernung zwischen der vorherigen Haltestelle und dieser Haltestelle. Wenn die aktuelle Haltestelle die erste Haltestelle in der Liste der Fahrtsegmente ist, wird als Startpunkt der Standort des Fahrzeugs verwendet, das zu dem Zeitpunkt erfasst wurde, zu dem diese Haltestelle der Liste hinzugefügt wurde. Dieses Feld ist möglicherweise nicht vorhanden, wenn dieser Wegabschnitt 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, wird als Startpunkt der Standort des Fahrzeugs verwendet, der zu dem Zeitpunkt erfasst wurde, zu dem diese Haltestelle in die Liste aufgenommen 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. So wird die verbleibende Fahrtzeit vom letzten bekannten Standort der Fahrer-App und nicht mehr der Fahrtzeit ab der vorherigen Haltestelle angezeigt.

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 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 Wegabschnitt 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 der Fahrweg vom letzten bekannten Standort der Fahrer-App und nicht vom Pfad von der vorherigen Haltestelle angegeben.

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. Die Orte 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-Aufruf nicht ausgefüllt.

tasks[]

object (TaskInfo)

Die Liste der Task-Werte, 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 zu der 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-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 nicht aktiv weitergeleitet.
ENROUTE Zugewiesenes und aktives Routing
ARRIVED An der Haltestelle angekommen. Bei der Routenplanung zur nächsten Haltestelle wird davon ausgegangen, dass alle vorherigen Haltestellen angefahren wurden.