Method: providers.trips.get

Uzyskiwanie informacji 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

To pole jest 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 Trip, które powinny zostać zwrócone, oraz ich interpretacja.

currentRouteSegmentVersion

string (Timestamp format)

Wskazuje minimalną sygnaturę czasową (wyłącznie), z której pobierane są dane Trip.route lub Trip.current_route_segment. Jeżeli dane trasy nie zmieniły się od tej sygnatury czasowej, pole trasy nie jest ustawione w odpowiedzi. Jeśli wartość minimalna nie jest określona, dane trasy są zawsze pobierane.

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

remainingWaypointsVersion

string (Timestamp format)

Wskazuje minimalną sygnaturę czasową (wyłącznie), z której pobierane są elementy Trip.remaining_waypoints. Jeśli nie zmieniają się od tej sygnatury czasowej, w odpowiedzi nie ustawiono wartości remainingWaypoints. Jeśli nie określisz wartości tego pola, wartość remainingWaypoints będzie zawsze pobierana.

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

routeFormatType

enum (PolylineFormatType)

Zwrócony aktualny 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ą (wyłącznie), z której pobierany jest element Trip.current_route_segment_traffic. Jeśli dane o ruchu nie zmieniły się od tej sygnatury czasowej, pole currentRouteSegmentTraffic nie jest ustawione w odpowiedzi. Jeśli wartość minimalna nie jest określona, dane o ruchu są zawsze pobierane. Pamiętaj, że ruch jest dostępny tylko w przypadku klientów korzystających z rozwiązań dotyczących przejazdów na żądanie i rozwiązań dostawczych.

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 minimalną sygnaturę czasową (wyłącznie), z której pobierane są dane Trip.remaining_waypoints.traffic_to_waypoint i Trip.remaining_waypoints.path_to_waypoint. Jeśli od czasu wystąpienia tej sygnatury czasowej dane się nie zmieniły, odpowiedź nie zawiera powyższych pól. Jeśli wartość remainingWaypointsRouteVersion nie jest określona, ruch i ścieżka są zawsze pobierane.

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

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.