Method: providers.trips.get

uzyskać 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 (na przykład sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi wykonujące to wywołanie.

Parametry zapytania

Parametry
header

object (RequestHeader)

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

enum (TripView)

Podzbiór pól wyjazdu, które powinny zostać zwrócone, oraz ich interpretacja.
currentRouteSegmentVersion

string (Timestamp format)

Wskazuje minimalną sygnaturę czasową (bez uwzględnienia) dla danych Trip.route lub Trip.current_route_segment. Jeśli dane trasy nie zmieniły się od tego sygnatury czasowej, pole route nie jest ustawione w odpowiedzi. Jeśli wartość minimalna nie jest określona, dane o trasie są zawsze pobierane.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc 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 uwzględnienia) dla której pobierane są wartości Trip.remaining_waypoints. Jeśli nie zmieniły się od tego momentu, nie są ustawiane w odpowiedzi. Jeśli to pole nie zostanie określone, zawsze jest pobierana wartość remainingWaypoints.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
routeFormatType

enum (PolylineFormatType)

Zwracany format bieżącej trasy: LAT_LNG_LIST_TYPE (w pliku Trip.route) lub ENCODED_POLYLINE_TYPE (w pliku Trip.current_route_segment). Domyślnie jest to LAT_LNG_LIST_TYPE.
currentRouteSegmentTrafficVersion

string (Timestamp format)

Wskazuje minimalną sygnaturę czasową (bez uwzględnienia) dla której pobierana jest wartość Trip.current_route_segment_traffic. Jeśli dane o ruchu nie zmieniły się od tego 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ługi Przejazdy i dostawy na żądanie.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy 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 minimalny znacznik czasu (wykluczający) dla którego pobierane są dane Trip.remaining_waypoints.traffic_to_waypoint i Trip.remaining_waypoints.path_to_waypoint. Jeśli dane nie zmieniły się od tego sygnatury czasowej, powyższe pola nie są ustawione w odpowiedzi. Jeśli nie podasz argumentu remainingWaypointsRouteVersion, ruch i ścieżka są zawsze pobierane.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc 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 nie został określony lub jest nieznany.
LAT_LNG_LIST_TYPE Lista wartości google.type.LatLng.
ENCODED_POLYLINE_TYPE Linia łamana zakodowana za pomocą algorytmu kompresji linii łamanej. Dekodowanie nie jest jeszcze obsługiwane.