Ressource: Trip
Reisemetadaten.
JSON-Darstellung |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Felder | |
---|---|
name |
Nur Ausgabe Im Format „providers/{provider}/trips/{trip}“ |
vehicleId |
ID des Fahrzeugs, das diese Fahrt vornimmt. |
tripStatus |
Aktueller Status der Fahrt. |
tripType |
Die Art der Fahrt. |
pickupPoint |
Ort, an dem der Kunde angibt, dass er abgeholt wird |
actualPickupPoint |
Nur Eingabe. Der tatsächliche Ort, an dem und an dem der Kunde abgeholt wurde. In diesem Feld können Anbieter Feedback zu tatsächlichen Abholinformationen geben. |
actualPickupArrivalPoint |
Nur Eingabe. Die tatsächliche Zeit und der tatsächliche Standort des Fahrers, der am Abholpunkt ankommt. In diesem Feld kann der Dienstleister Feedback zur tatsächlichen Ankunft am Abholort geben. |
pickupTime |
Nur Ausgabe Entweder die voraussichtliche zukünftige Zeit, zu der der Fahrgast/die Fahrgäste abgeholt werden, oder die tatsächliche Zeit, zu der der Fahrgast abgeholt wird. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
intermediateDestinations[] |
Zwischenstopps, damit die Fahrt angefragt wird (zusätzlich zu Abhol- und Absetzort). Dies wird anfangs nicht für geteilte Reisen unterstützt. |
intermediateDestinationsVersion |
Gibt an, wann das Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
intermediateDestinationIndex |
Wenn |
actualIntermediateDestinationArrivalPoints[] |
Nur Eingabe. Die tatsächliche Zeit und der tatsächliche Standort der Ankunft des Fahrers an einem Zwischenziel. In diesem Feld kann der Dienstleister Feedback zu tatsächlichen Ankunftsinformationen an Zwischenzielen geben. |
actualIntermediateDestinations[] |
Nur Eingabe. Die tatsächliche Zeit und der tatsächliche Ort, an dem und an der der Kunde von einem Zwischenziel abgeholt wurde. In diesem Feld können Anbieter Feedback zu tatsächlichen Abholinformationen an Zwischenzielen geben. |
dropoffPoint |
Ort, an dem der Kunde angibt, dass er aussteigt. |
actualDropoffPoint |
Nur Eingabe. Die tatsächliche Zeit und der tatsächliche Ort, an dem und zu der der Kunde ausgestiegen ist. In diesem Feld kann der Dienstleister Feedback zu den tatsächlichen Ausstiegsinformationen geben. |
dropoffTime |
Nur Ausgabe Entweder die voraussichtliche Ankunftszeit, zu der die Fahrgäste am Zielort aussteigen, oder die tatsächliche Zeit, zu der sie ausgestiegen sind. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
remainingWaypoints[] |
Nur Ausgabe Der vollständige Pfad vom aktuellen Standort bis zur Abgabestelle (einschließlich). Dieser Pfad kann Wegpunkte von anderen Fahrten enthalten. |
vehicleWaypoints[] |
In diesem Feld können die Wegpunkte für die Fahrt manuell sortiert werden. Sie enthält alle verbleibenden Wegpunkte für das zugewiesene Fahrzeug sowie die Start- und Zielpunkte für diese Fahrt. Wenn die Fahrt keinem Fahrzeug zugewiesen wurde, ignoriert Fleet Engine dieses Feld. Aus Datenschutzgründen wird dieses Feld nur bei |
route[] |
Nur Ausgabe Voraussichtliche Route für diese Fahrt zum ersten Eintrag in verbleibenden Waypoints. Der erste Wegpunkt kann zu einer anderen Fahrt gehören. |
currentRouteSegment |
Nur Ausgabe Ein codierter Pfad zum nächsten Wegpunkt. Hinweis: Dieses Feld ist nur für die Verwendung mit dem Driver SDK und dem Consumer SDK vorgesehen. Die Decodierung wird noch nicht unterstützt. |
currentRouteSegmentVersion |
Nur Ausgabe Gibt an, wann die Route zuletzt geändert wurde. Hinweis: Dieses Feld ist nur für die Verwendung mit dem Driver SDK und dem Consumer SDK vorgesehen. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
currentRouteSegmentTraffic |
Nur Ausgabe Zeigt die Verkehrslage entlang der Straße Hinweis: Dieses Feld ist nur für die Verwendung mit dem Driver SDK und dem Consumer SDK vorgesehen. |
currentRouteSegmentTrafficVersion |
Nur Ausgabe Gibt an, wann das Hinweis: Dieses Feld ist nur für die Verwendung mit dem Driver SDK und dem Consumer SDK vorgesehen. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
currentRouteSegmentEndPoint |
Nur Ausgabe Wegpunkt, an dem |
remainingDistanceMeters |
Nur Ausgabe Die verbleibende Fahrstrecke im Feld |
etaToFirstWaypoint |
Nur Ausgabe Die voraussichtliche Ankunftszeit für den nächsten Wegpunkt (erster Eintrag im Feld Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
remainingTimeToFirstWaypoint |
Nur Ausgabe Die Dauer ab der Rückgabe der Fahrtdaten bis zur Zeit in Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
remainingWaypointsVersion |
Nur Ausgabe Gibt an, wann der Ort Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
remainingWaypointsRouteVersion |
Nur Ausgabe Gibt an, wann Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
numberOfPassengers |
Nicht veränderbar. Gibt die Anzahl der Fahrgäste bei dieser Fahrt an, ohne den Fahrer. Ein Fahrzeug muss verfügbare Kapazität haben, um in einer |
lastLocation |
Nur Ausgabe Zeigt den letzten gemeldeten Standort des Fahrzeugs entlang der Route an. |
lastLocationSnappable |
Nur Ausgabe Gibt an, ob das |
view |
Die ausgefüllte Teilmenge der Trip-Felder und wie sie interpretiert werden sollen. |
TripStatus
Der Status einer Fahrt, der ihren Verlauf anzeigt.
Enums | |
---|---|
UNKNOWN_TRIP_STATUS |
Standardeinstellung, wird für einen nicht angegebenen oder unbekannten Fahrtstatus verwendet. |
NEW |
Neu erstellte Reise. |
ENROUTE_TO_PICKUP |
Der Fahrer ist auf dem Weg zum Abholpunkt. |
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 zur Abgabestelle). |
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 Mitfahrdienstanbieter storniert. |
StopLocation
Der tatsächliche Ort, an dem eine Haltestelle (Start-/Abbruch) angehalten wurde.
JSON-Darstellung |
---|
{
"point": {
object ( |
Felder | |
---|---|
point |
Erforderlich. Gibt den tatsächlichen Standort an. |
timestamp |
Gibt an, wann die Haltestelle stattgefunden hat. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
stopTime |
Nur Eingabe Veraltet. Verwenden Sie das Feld „Zeitstempel“. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
TripView
Auswahl für verschiedene Gruppen von Trip-Feldern in einer trips.get
-Antwort. Weitere Informationen findest du unter AIP-157. Weitere Aufrufe werden wahrscheinlich hinzugefügt.
Enums | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Der Standardwert. Aus Gründen der Abwärtskompatibilität wird für die API standardmäßig eine SDK-Ansicht verwendet. Wir empfehlen Kunden, einen anderen TripView als SDK auszuwählen, um Stabilität und Support zu gewährleisten. |
SDK |
Umfasst Felder, die bei öffentlich verfügbaren Bibliotheken möglicherweise nicht interpretierbar oder unterstützt werden können. |
JOURNEY_SHARING_V1S |
Fahrtfelder werden für den Anwendungsfall „Wegbeschreibung teilen“ ausgefüllt. Diese Ansicht ist für die Server-zu-Server-Kommunikation vorgesehen. |
Methoden |
|
---|---|
|
Erstellt eine Fahrt in der Fleet Engine und gibt die neue Fahrt zurück. |
|
Rufen Sie Informationen zu einer einzelnen Fahrt ab. |
|
Sie können alle Fahrten für ein bestimmtes Fahrzeug abrufen. |
|
Aktualisiert Fahrtdaten. |