Method: providers.trips.get

Uzyskaj 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 Podróż, 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 nie określisz minimalnej wartości, dane trasy będą zawsze pobierane.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

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.remainingWaypoints Jeśli to pole nie zostanie określone, zawsze jest pobierana wartość remainingWaypoints.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

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 jest pobierana wartość Trip.current_route_segment_traffic. Jeśli dane o ruchu nie uległy zmianie od tego sygnatury czasowej, pole currentRouteSegmentTraffic nie jest ustawione w odpowiedzi. Jeśli nie zostanie podana wartość minimalna, dane o ruchu są zawsze pobierane. Uwaga: ruch jest dostępny tylko dla klientów korzystających z usługi Przejazdy i dostawy na żądanie.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

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.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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

PolylineFormatType

Typ formatu wielokąta.

Wartości w polu enum
UNKNOWN_FORMAT_TYPE Format nie został określony lub jest nieznany.
LAT_LNG_LIST_TYPE Lista google.type.LatLng.
ENCODED_POLYLINE_TYPE Linia złożona zakodowana za pomocą algorytmu kompresji linii złożonej. Dekodowanie nie jest jeszcze obsługiwane.