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 zu retournierenden Trip-Felder und ihre Interpretation.
currentRouteSegmentVersion

string (Timestamp format)

Gibt den minimalen Zeitstempel (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.

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

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".
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 die Verkehrsdaten seit diesem Zeitstempel unverändert sind, wird das Feld currentRouteSegmentTraffic in der Antwort nicht festgelegt. Wenn kein Minimum angegeben ist, werden die Besucherzahlen immer abgerufen. Zugriffe sind nur für Kunden der On-Demand Rides & Deliveries-Lösung verfügbar.

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)

Gibt den minimalen Zeitstempel (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.

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

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.