- Ressource: Trip
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TripStatus
- StopLocation
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- TripView
- Methoden
Ressource: Fahrt
Metadaten zu Fahrten.
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 durchführt. |
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 wo der Kunde abgeholt wurde. In diesem Feld kann der Anbieter Feedback zu den tatsächlichen Abholinformationen geben. |
actualPickupArrivalPoint |
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 |
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: |
intermediateDestinations[] |
Zwischenstopps, damit die Fahrt angefordert wird (zusätzlich zu Start- und Zielhaltestellen). Für geteilte Fahrten wird dies anfangs nicht unterstützt. |
intermediateDestinationsVersion |
Gibt an, wann das Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
intermediateDestinationIndex |
Wenn |
actualIntermediateDestinationArrivalPoints[] |
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[] |
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 |
Ort, an dem der Kunde angibt, dass er aussteigt. |
actualDropoffPoint |
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 |
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: |
remainingWaypoints[] |
Nur Ausgabe. Der vollständige Pfad vom aktuellen Standort bis zum Abgabepunkt (einschließlich). Dieser Pfad könnte Wegpunkte von anderen Fahrten enthalten. |
vehicleWaypoints[] |
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 |
route[] |
Nur Ausgabe. Voraussichtliche Route für diese Fahrt zum ersten Eintrag in den verbleibendenWegpunkten. Beachten Sie, dass der erste Wegpunkt möglicherweise zu einer anderen Fahrt gehört. |
currentRouteSegment |
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 |
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: |
currentRouteSegmentTraffic |
Nur Ausgabe. Gibt die Verkehrslage entlang der Hinweis: Dieses Feld ist nur für die Verwendung vom Driver SDK und Consumer SDK vorgesehen. |
currentRouteSegmentTrafficVersion |
Nur Ausgabe. Gibt an, wann das 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: |
currentRouteSegmentEndPoint |
Nur Ausgabe. Wegpunkt, an dem |
remainingDistanceMeters |
Nur Ausgabe. Die verbleibende Fahrstrecke im Feld |
etaToFirstWaypoint |
Nur Ausgabe. Die voraussichtliche Ankunftszeit zum nächsten Wegpunkt (erster Eintrag im Feld Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
remainingTimeToFirstWaypoint |
Nur Ausgabe. Die Dauer ab Rückgabe der Fahrtdaten bis zum Zeitpunkt in Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
remainingWaypointsVersion |
Nur Ausgabe. Gibt an, wann Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
remainingWaypointsRouteVersion |
Nur Ausgabe. Gibt an, wann Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
numberOfPassengers |
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 |
lastLocation |
Nur Ausgabe. Zeigt den letzten gemeldeten Standort des Fahrzeugs auf der Route an. |
lastLocationSnappable |
Nur Ausgabe. Gibt an, ob das |
view |
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 ( |
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 einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
stopTime |
Nur Eingabe Verworfen. Verwenden Sie das Feld für den Zeitstempel. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
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 |
|
---|---|
|
Erstellt eine Fahrt in der Fleet Engine und gibt die neue Fahrt zurück. |
|
Informationen zu einer einzelnen Fahrt abrufen. |
|
Sie können alle Fahrten für ein bestimmtes Fahrzeug abrufen. |
|
Aktualisiert Fahrtdaten. |