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 das Format providers/{provider}/trips/{trip} haben. Der Anbieter muss die Projekt-ID des Google Cloud-Projekts sein, zu dem das Dienstkonto, das diesen Aufruf durchführt, gehört (z. B. sample-cloud-project).

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 minimalen Zeitstempel (exklusiv) an, für den Trip.route- oder Trip.current_route_segment-Daten abgerufen werden. Wenn Routendaten seit diesem Zeitstempel unverändert sind, wird das Routingfeld nicht in der Antwort 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 minimalen Zeitstempel (exklusiv) an, für den Trip.remaining_waypoints abgerufen werden. Wenn sie seit diesem Zeitstempel unverändert sind, werden remainingWaypoints nicht in der Antwort 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). Der Standardwert ist LAT_LNG_LIST_TYPE.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Gibt den minimalen Zeitstempel (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 Verkehrsdaten immer abgerufen. Traffic ist nur für Kunden der On-Demand Rides and 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 die Daten seit diesem Zeitstempel unverändert sind, werden die Felder oben 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 Mit einem Polylinien-Komprimierungsalgorithmus codierte Polylinie. Die Decodierung wird noch nicht unterstützt.