Method: providers.trips.get

Rufen Sie Informationen zu einer einzelnen Fahrt ab.

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 gehört, das diesen Aufruf durchführt, 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 (ausschließlich) an, für den Trip.route- oder Trip.current_route_segment-Daten abgerufen werden. Wenn die Routendaten seit diesem Zeitstempel unverändert geblieben sind, wird das Routenfeld in der Antwort nicht festgelegt. Wenn kein Minimum angegeben ist, werden die Routendaten immer abgerufen.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung 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 (ausschließlich) an, für den Trip.remaining_waypoints abgerufen werden. Wenn sie seit diesem Zeitstempel unverändert sind, werden die remainingWaypoints nicht in der Antwort festgelegt. Wenn dieses Feld nicht angegeben ist, wird immer remainingWaypoints abgerufen.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung 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 (ausschließlich) an, für den Trip.current_route_segment_traffic abgerufen wird. Wenn sich die Verkehrsdaten seit diesem Zeitstempel nicht geändert haben, wird das Feld currentRouteSegmentTraffic in der Antwort nicht festgelegt. Wenn kein Minimum angegeben ist, werden die Traffic-Daten immer abgerufen. Beachten Sie, dass Traffic nur für Kunden der Lösung „On-Demand Rides and Deliveries“ verfügbar ist.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung 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 (ausschließlich) 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 obigen 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 Nanosekundenauflösung 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 Polylinie, die mit einem Algorithmus zur Komprimierung von Polylinien codiert ist. Die Decodierung wird noch nicht unterstützt.