Method: providers.trips.get

Informacje o pojedynczej podróży.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Musi mieć format providers/{provider}/trips/{trip}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi wywołujące to wywołanie.

Parametry zapytania

Parametry
header

object (RequestHeader)

Standardowy nagłówek żądania Fleet Engine.
view

enum (TripView)

Podzbiór pól Podróży, które powinny zostać zwrócone, i ich interpretacji.
currentRouteSegmentVersion

string (Timestamp format)

Wskazuje minimalną sygnaturę czasową (z jej wyłączeniem), dla której pobierane są dane z kategorii Trip.route lub Trip.current_route_segment. Jeśli dane o trasie nie zmieniają się od tej sygnatury czasowej, pole trasy nie jest ustawione w odpowiedzi. Jeśli wartość minimalna nie jest określona, dane o trasie są zawsze pobierane.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
remainingWaypointsVersion

string (Timestamp format)

Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), dla której pobierane są Trip.remaining_waypoints. Jeśli nie zmieniają się od tej sygnatury czasowej, w odpowiedzi nie są ustawione parametry remainingWaypoints. Jeśli to pole nie jest określone, pole remainingWaypoints jest zawsze pobierane.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
routeFormatType

enum (PolylineFormatType)

Zwracany bieżący format trasy: LAT_LNG_LIST_TYPE (w Trip.route) lub ENCODED_POLYLINE_TYPE (w Trip.current_route_segment). Wartość domyślna to LAT_LNG_LIST_TYPE.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), z którą jest pobierana plik Trip.current_route_segment_traffic. Jeśli dane o ruchu nie zmieniają się od tej sygnatury czasowej, pole currentRouteSegmentTraffic nie jest ustawione w odpowiedzi. Jeśli wartość minimalna nie jest określona, dane dotyczące ruchu są zawsze pobierane. Pamiętaj, że ruch jest dostępny tylko dla klientów korzystających z usług przejazdów na żądanie i usług dostawy.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
remainingWaypointsRouteVersion

string (Timestamp format)

Wskazuje minimalną sygnaturę czasową (bez jej uwzględnienia), dla której pobierane są dane z kategorii Trip.remaining_waypoints.traffic_to_waypoint i Trip.remaining_waypoints.path_to_waypoint. Jeśli dane nie zmieniają się od tej sygnatury czasowej, powyższe pola nie są ustawione w odpowiedzi. Jeśli pole remainingWaypointsRouteVersion nie jest określone, ruch i ścieżka są zawsze pobierane.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Trip.

PolylineFormatType

Typ formatu linii łamanej.

Wartości w polu enum
UNKNOWN_FORMAT_TYPE Format jest nieokreślony lub nieznany.
LAT_LNG_LIST_TYPE Lista: google.type.LatLng.
ENCODED_POLYLINE_TYPE Linia łamana zakodowana za pomocą algorytmu kompresji linii łamanej. Dekodowanie nie jest jeszcze obsługiwane.