Method: providers.trips.get

Informationen zu einer einzelnen Fahrt abrufen

HTTP-Anfrage

GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Muss im Format providers/{provider}/trips/{trip} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-cloud-project) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.

Abfrageparameter

Parameter
header

object (RequestHeader)

Der standardmäßige Fleet Engine-Anfrageheader.
view

enum (TripView)

Die Teilmenge der Trip-Felder, die zurückgegeben werden sollen, und ihre Interpretation.
currentRouteSegmentVersion

string (Timestamp format)

Gibt den Mindestzeitstempel (exklusiv) an, für den Trip.route- oder Trip.current_route_segment-Daten abgerufen werden. Wenn sich die Routendaten seit diesem Zeitstempel nicht geändert haben, wird das Feld „route“ in der Antwort nicht festgelegt. Wenn kein Minimum angegeben ist, werden die Routendaten immer abgerufen.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
remainingWaypointsVersion

string (Timestamp format)

Gibt den Mindestzeitstempel (exklusiv) an, für den Trip.remaining_waypoints abgerufen werden. Wenn sie seit diesem Zeitstempel unverändert sind, werden die remainingWaypoints in der Antwort nicht festgelegt. Wenn dieses Feld nicht angegeben ist, wird immer remainingWaypoints abgerufen.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
routeFormatType

enum (PolylineFormatType)

Das zurückgegebene aktuelle Routenformat, LAT_LNG_LIST_TYPE (in Trip.route) oder ENCODED_POLYLINE_TYPE (in Trip.current_route_segment). Standardmäßig ist LAT_LNG_LIST_TYPE festgelegt.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Gibt den Mindestzeitstempel (exklusiv) an, für den Trip.current_route_segment_traffic abgerufen wird. Wenn sich die Besucherzahlen seit diesem Zeitstempel nicht geändert haben, ist das Feld currentRouteSegmentTraffic in der Antwort nicht festgelegt. Wenn kein Minimum angegeben ist, werden die Besucherzahlen immer abgerufen. Die Zugriffe sind nur für Kunden der On-Demand Rides & Deliveries-Lösung verfügbar.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
remainingWaypointsRouteVersion

string (Timestamp format)

Gibt den Mindestzeitstempel (exklusiv) an, für den Trip.remaining_waypoints.traffic_to_waypoint- und Trip.remaining_waypoints.path_to_waypoint-Daten abgerufen werden. Wenn sich die Daten seit diesem Zeitstempel nicht geändert haben, werden die oben genannten Felder in der Antwort nicht festgelegt. Wenn remainingWaypointsRouteVersion nicht angegeben ist, werden Traffic und Pfad immer abgerufen.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Trip.

PolylineFormatType

Der Typ des Polylinienformats.

Enums
UNKNOWN_FORMAT_TYPE Das Format ist nicht angegeben oder unbekannt.
LAT_LNG_LIST_TYPE Eine Liste mit google.type.LatLng.
ENCODED_POLYLINE_TYPE Eine Polylinie, die mit einem Polylinienkomprimierungsalgorithmus codiert wurde. Das Dekodieren wird noch nicht unterstützt.