Method: providers.trips.get

Informacje o jednej 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

Wymagany. Musi mieć format providers/{provider}/trips/{trip}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) projektu Google Cloud, do którego należy konto usługi wywołujące to połączenie.

Parametry zapytania

Parametry
header

object (RequestHeader)

Standardowy nagłówek żądania w usłudze Fleet Engine.

view

enum (TripView)

Podzbiór pól Trip, które należy zwrócić, i ich interpretacja.

currentRouteSegmentVersion

string (Timestamp format)

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

Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr 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), dla której pobierane są wartości Trip.remaining_waypoints. Jeśli nie zostaną zmienione od tej sygnatury czasowej, właściwość remainingWaypoints nie zostanie ustawiona w odpowiedzi. Jeśli to pole nie jest określone, remainingWaypoints jest zawsze pobierany.

Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

routeFormatType

enum (PolylineFormatType)

Zwrócony 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ą (wyłączną), dla której pobierany jest element Trip.current_route_segment_traffic. Jeśli dane o ruchu nie zostaną zmienione od tej sygnatury czasowej, pole currentRouteSegmentTraffic nie zostanie 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 funkcji przejazdów i dostawy na żądanie.

Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr 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), dla której pobierane są dane Trip.remaining_waypoints.traffic_to_waypoint i Trip.remaining_waypoints.path_to_waypoint. Jeśli od tej sygnatury czasowej nie zostaną zmienione dane, powyższe pola nie zostaną ustawione w odpowiedzi. Jeśli nie określono parametru remainingWaypointsRouteVersion, ruch i ścieżka są zawsze pobierane.

Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr 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.

Typ formatu linii łamanej

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 Poliline zakodowana z użyciem algorytmu kompresji tej linii. Dekodowanie nie jest jeszcze obsługiwane.