REST Resource: providers.trips

Ressource: Fahrt

Metadaten zu Fahrten.

JSON-Darstellung 
{
  "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)
}
Felder
name

string

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

string

ID des Fahrzeugs, das diese Fahrt durchführt.
tripStatus

enum (TripStatus)

Aktueller Status der Fahrt.
tripType

enum (TripType)

Die Art der Fahrt.
pickupPoint

object (TerminalLocation)

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

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.
actualPickupArrivalPoint

object (StopLocation)

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

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".
intermediateDestinations[]

object (TerminalLocation)

Zwischenstopps, damit die Fahrt angefordert wird (zusätzlich zu Start- und Zielhaltestellen). Für geteilte Fahrten wird dies anfangs nicht unterstützt.
intermediateDestinationsVersion

string (Timestamp format)

Gibt an, wann das intermediateDestinations zuletzt geändert wurde. Dein Server sollte diesen Wert im Cache speichern und beim Aktualisieren von intermediateDestinationIndex in UpdateTripRequest übergeben, um sicherzustellen, dass 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".
intermediateDestinationIndex

integer

Wenn TripStatus den Wert ENROUTE_TO_INTERMEDIATE_DESTINATION hat, ist eine Zahl zwischen [0–N–1] angegeben, die angibt, welches Zwischenziel das Fahrzeug als Nächstes überquert. Wenn TripStatus ARRIVED_AT_INTERMEDIATE_DESTINATION ist, eine Zahl zwischen [0–N–1], die angibt, an welchem Zwischenziel sich das Fahrzeug befindet. Der Anbieter legt diesen Wert fest. Wenn keine intermediateDestinations vorhanden sind, wird dieses Feld ignoriert.
actualIntermediateDestinationArrivalPoints[]

object (StopLocation)

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

object (StopLocation)

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

object (TerminalLocation)

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

object (StopLocation)

Nur Eingabe. Die tatsächliche Zeit und der tatsächliche Ort, an dem und wo der Kunde ausstieg. In diesem Feld können Dienstleister Feedback zu tatsächlichen Abbruchinformationen geben.
dropoffTime

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".
remainingWaypoints[]

object (TripWaypoint)

Nur Ausgabe. Der vollständige Pfad vom aktuellen Standort bis zum Abgabepunkt (einschließlich). Dieser Pfad könnte Wegpunkte von anderen Fahrten enthalten.
vehicleWaypoints[]

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 Start- und Zielorte 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.
route[]

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.
currentRouteSegment

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. Die Decodierung wird noch nicht unterstützt.
currentRouteSegmentVersion

string (Timestamp format)

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

Hinweis: Dieses Feld ist nur für die Verwendung vom Driver SDK und 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".
currentRouteSegmentTraffic

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.
currentRouteSegmentTrafficVersion

string (Timestamp format)

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

Hinweis: Dieses Feld ist nur für die Verwendung vom Driver SDK und 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".
currentRouteSegmentEndPoint

object (TripWaypoint)

Nur Ausgabe. Wegpunkt, an dem currentRouteSegment endet.
remainingDistanceMeters

integer

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

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".
remainingTimeToFirstWaypoint

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".
remainingWaypointsVersion

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".
remainingWaypointsRouteVersion

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, um sicherzustellen, dass die Pfade und der Traffic für remainingWaypoints nur bei einer Aktualisierung zurückgegeben 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".
numberOfPassengers

integer

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

object (VehicleLocation)

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

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. Aktualisierungen von Clients werden ignoriert.
view

enum (TripView)

Die Teilmenge der Trip-Felder, die ausgefüllt werden, und deren Interpretation.

TripStatus

Der Status einer Fahrt, der den Verlauf angibt.

Enums
UNKNOWN_TRIP_STATUS Standardeinstellung, die für einen nicht angegebenen oder nicht erkannten Fahrtstatus verwendet wird.
NEW Neu erstellte Reise.
ENROUTE_TO_PICKUP Der Fahrer ist auf dem Weg zur Abholstelle.
ARRIVED_AT_PICKUP Der Fahrer ist am Abholpunkt angekommen.
ARRIVED_AT_INTERMEDIATE_DESTINATION Der Fahrer ist an einem Zwischenziel angekommen und wartet auf den Fahrgast.
ENROUTE_TO_INTERMEDIATE_DESTINATION Der Fahrer ist auf dem Weg zu einem Zwischenziel (nicht zum Absetzpunkt).
ENROUTE_TO_DROPOFF Der Fahrer hat den Fahrgast abgeholt und ist auf dem Weg zum nächsten Ziel.
COMPLETE Der Fahrgast ist ausgestiegen und die Fahrt ist abgeschlossen.
CANCELED Die Fahrt wurde vor der Abholung durch den Fahrer, Fahrgast oder Mitfahrdienst gestrichen.

StopLocation

Der tatsächliche Ort, an dem eine Haltestelle (Ab-/Absetz) stattfand.

JSON-Darstellung 
{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
Felder
point

object (LatLng)

Erforderlich. Gibt den tatsächlichen Standort an.
timestamp

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".
stopTime
(deprecated)

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".

TripView

Auswahl für verschiedene Gruppen von Trip-Feldern in einer trips.get-Antwort. Weitere Informationen finden Sie unter AIP-157. Es ist wahrscheinlich, dass weitere Aufrufe hinzugefügt werden.

Enums
TRIP_VIEW_UNSPECIFIED Der Standardwert. Aus Gründen der Abwärtskompatibilität verwendet die API standardmäßig eine SDK-Ansicht. Um Stabilität und Support zu gewährleisten, wird Kunden empfohlen, eine andere TripView als SDK auszuwählen.
SDK Umfasst Felder, die in öffentlich verfügbaren Bibliotheken möglicherweise nicht interpretiert oder nicht unterstützt werden können.
JOURNEY_SHARING_V1S Für den Anwendungsfall „Teilen von Reisen“ werden die Reisefelder ausgefüllt. Diese Ansicht ist für die Server-zu-Server-Kommunikation vorgesehen.

Methoden

create

 Erstellt eine Fahrt in der Fleet Engine und gibt die neue Fahrt zurück.

get

 Informationen zu einer einzelnen Fahrt abrufen.
Sie können alle Fahrten für ein bestimmtes Fahrzeug abrufen.

update

 Aktualisiert Fahrtdaten.