REST Resource: providers.trips

{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}

string

Nur Ausgabe. Im Format „providers/{provider}/trips/{trip}“

string

ID des Fahrzeugs, das diese Fahrt durchführt.

enum (TripStatus)

Aktueller Status der Fahrt.

enum (TripType)

Die Art der Fahrt.

object (TerminalLocation)

Ort, an dem der Kunde angibt, dass er abgeholt wird.

object (StopLocation)

Nur Eingabe. Der tatsächliche Ort, an dem und wo der Kunde abgeholt wurde. In diesem Feld kann der Anbieter Feedback zu den tatsächlichen Abholinformationen geben.

object (StopLocation)

Nur Eingabe. Die tatsächliche Ankunftszeit und der tatsächliche Ort des Fahrers am Abholort. In diesem Feld können Dienstleister Feedback zur tatsächlichen Ankunft am Abholpunkt geben.

string (Timestamp format)

Nur Ausgabe. Entweder die geschätzte zukünftige Abholzeit der Fahrgäste oder die tatsächliche Uhrzeit, zu der die Fahrgäste abgeholt werden.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

object (TerminalLocation)

Zwischenstopps, damit die Fahrt angefordert wird (zusätzlich zu Start- und Zielhaltestellen). Diese Funktion wird anfangs nicht für Fahrten mit mehreren Personen unterstützt.

string (Timestamp format)

Gibt an, wann das intermediateDestinations zuletzt geändert wurde. Dein Server sollte diesen Wert im Cache speichern und bei der Aktualisierung von intermediateDestinationIndex in UpdateTripRequest übergeben, damit intermediateDestinations nicht geändert wird.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

integer

Wenn TripStatus = ENROUTE_TO_INTERMEDIATE_DESTINATION ist, eine Zahl zwischen [0..N-1], die angibt, welches Zwischenziel das Fahrzeug als Nächstes passiert. Wenn TripStatus ARRIVED_AT_INTERMEDIATE_DESTINATION ist, eine Zahl zwischen [0–N–1], die angibt, an welchem Zwischenziel sich das Fahrzeug befindet. Dieser Wert wird vom Anbieter festgelegt. Wenn keine intermediateDestinations vorhanden sind, wird dieses Feld ignoriert.

object (StopLocation)

Nur Eingabe. Tatsächliche Uhrzeit und Ort der Ankunft des Fahrers an einem Zwischenziel. In diesem Feld können Anbieter Feedback zu den tatsächlichen Ankunftsinformationen an Zwischenzielen geben.

object (StopLocation)

Nur Eingabe. Die tatsächliche Uhrzeit und der tatsächliche Ort, an dem der Kunde an einem Zwischenziel abgeholt wurde. In diesem Feld kann der Anbieter Feedback zu tatsächlichen Abholinformationen an Zwischenzielen geben.

object (TerminalLocation)

Ort, an dem der Kunde angibt, dass er aussteigt.

object (StopLocation)

Nur Eingabe. Die tatsächliche Uhrzeit und der tatsächliche Ort, an dem der Kunde abgesetzt wurde. In diesem Feld kann der Anbieter Feedback zu den tatsächlichen Informationen zur Absetzung geben.

string (Timestamp format)

Nur Ausgabe. Entweder die geschätzte zukünftige Zeit, zu der die Fahrgäste am endgültigen Ziel aussteigen, oder die tatsächliche Zeit, zu der die Fahrgäste aussteigen werden.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

Nur Ausgabe. Der vollständige Pfad vom aktuellen Standort bis zum Abgabepunkt (einschließlich). Dieser Pfad kann Wegpunkte aus anderen Fahrten enthalten.

object (TripWaypoint)

Dieses Feld unterstützt die manuelle Sortierung der Wegpunkte für die Fahrt. Sie enthält alle verbleibenden Wegpunkte für das zugewiesene Fahrzeug sowie die Abhol- und Rückgabeorte für diese Fahrt. Wenn die Fahrt keinem Fahrzeug zugewiesen wurde, ignoriert Fleet Engine dieses Feld. Aus Datenschutzgründen wird dieses Feld nur bei trips.update- und trips.create-Aufrufen vom Server ausgefüllt, NICHT bei trips.get-Aufrufen.

object (LatLng)

Nur Ausgabe. Voraussichtliche Route für diese Fahrt zum ersten Eintrag der verbleibendenWegpunkte. Beachten Sie, dass der erste Wegpunkt möglicherweise zu einer anderen Fahrt gehört.

string

Nur Ausgabe. Ein codierter Pfad zum nächsten Wegpunkt.

Hinweis: Dieses Feld ist nur für die Verwendung vom Driver SDK und Consumer SDK vorgesehen. Das Dekodieren wird noch nicht unterstützt.

string (Timestamp format)

Nur Ausgabe. Gibt an, wann die Route zuletzt geändert wurde.

Hinweis: Dieses Feld ist nur für das Driver SDK und das Consumer SDK vorgesehen.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

object (ConsumableTrafficPolyline)

Nur Ausgabe. Gibt die Verkehrslage entlang der currentRouteSegment an, sofern verfügbar.

Hinweis: Dieses Feld ist nur für die Verwendung vom Driver SDK und Consumer SDK vorgesehen.

string (Timestamp format)

Nur Ausgabe. Gibt an, wann die currentRouteSegmentTraffic zuletzt geändert wurde.

Hinweis: Dieses Feld ist nur für das Driver SDK und das Consumer SDK vorgesehen.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

Nur Ausgabe. Wegpunkt, an dem currentRouteSegment endet.

integer

Nur Ausgabe. Die verbleibende Fahrstrecke im Feld currentRouteSegment. Der Wert wird nicht angegeben, wenn die Fahrt keinem Fahrzeug zugewiesen ist oder die Fahrt beendet oder gestrichen wurde.

string (Timestamp format)

Nur Ausgabe. Die voraussichtliche Ankunftszeit zum nächsten Wegpunkt (erster Eintrag im Feld remainingWaypoints). Der Wert ist nicht angegeben, wenn die Fahrt keinem Fahrzeug zugewiesen ist oder die Fahrt inaktiv ist (abgeschlossen oder gestrichen).

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Nur Ausgabe. Die Dauer ab Rückgabe der Fahrtdaten bis zum Zeitpunkt in Trip.eta_to_first_waypoint. Der Wert ist nicht angegeben, wenn die Fahrt keinem Fahrzeug zugewiesen ist oder die Fahrt inaktiv ist (abgeschlossen oder gestrichen).

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

string (Timestamp format)

Nur Ausgabe. Gibt an, wann remainingWaypoints zuletzt geändert wurde (ein Wegpunkt wurde hinzugefügt, entfernt oder geändert).

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Nur Ausgabe. Gibt an, wann remainingWaypoints.path_to_waypoint und remainingWaypoints.traffic_to_waypoint zuletzt geändert wurden. Ihre Clientanwendung sollte diesen Wert im Cache speichern und in GetTripRequest übergeben, damit die Pfade und Zugriffe für remainingWaypoints nur zurückgegeben werden, wenn sie aktualisiert wurden.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

integer

Nicht veränderbar. Gibt die Anzahl der Fahrgäste bei dieser Fahrt an, ohne den Fahrer. Ein Fahrzeug muss genügend Kapazität haben, damit es in einer vehicles.search-Antwort zurückgegeben werden kann.

object (VehicleLocation)

Nur Ausgabe. Zeigt den letzten gemeldeten Standort des Fahrzeugs auf der Route an.

boolean

Nur Ausgabe. Gibt an, ob das lastLocation des Fahrzeugs an das currentRouteSegment ausgerichtet werden kann. Falsch, wenn lastLocation oder currentRouteSegment nicht vorhanden ist. Er wird von Fleet Engine berechnet. Alle Aktualisierungen von Kunden werden ignoriert.

enum (TripView)

Die Teilmenge der ausgefüllten Trip-Felder und ihre Interpretation.

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object (LatLng)

Erforderlich. Gibt den tatsächlichen Standort an.

string (Timestamp format)

Gibt an, wann die Haltestelle stattgefunden hat.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Nur Eingabe Verworfen. Verwenden Sie das Feld „Zeitstempel“.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".