REST Resource: providers.trips

{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}

string

Tylko dane wyjściowe. W formacie „dostawcy/{dostawca}/podróże/{podróż}”

string

Identyfikator pojazdu, który pokonuje tę podróż.

enum (TripStatus)

Bieżący stan podróży.

enum (TripType)

Typ podróży.

object (TerminalLocation)

Miejsce, w którym klient wskazuje, że zostanie odebrany.

object (StopLocation)

Tylko dane wejściowe. Rzeczywista lokalizacja i miejsce odbioru klienta. To pole jest przeznaczone dla usługodawcy do przekazywania opinii na temat rzeczywistych informacji o odbiorze.

object (StopLocation)

Tylko dane wejściowe. Rzeczywista godzina przyjazdu kierowcy do punktu odbioru i lokalizacja kierowcy. To pole jest przeznaczone dla dostawcy do przekazywania opinii na temat rzeczywistych informacji o przyjeździe do punktu odbioru.

string (Timestamp format)

Tylko dane wyjściowe. Szacowana godzina przyjazdu pasażerów lub faktyczna godzina ich odebrania w przyszłości.

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

object (TerminalLocation)

Pośrednie przystanki na potrzeby podróży (oprócz prośby o odbiór i powrót). Początkowo nie będzie to obsługiwane w przypadku wspólnych podróży.

string (Timestamp format)

Wskazuje, kiedy po raz ostatni zmodyfikowano intermediateDestinations. Aby zapewnić, że intermediateDestinations nie została zmieniona, serwer powinien zapisać tę wartość w pamięci podręcznej i przekazać ją w UpdateTripRequest po aktualizacji intermediateDestinationIndex.

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

integer

Jeśli TripStatus to ENROUTE_TO_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1] wskazuje pośrednie miejsce docelowe, przez które pojazd będzie następny. Jeśli TripStatus to ARRIVED_AT_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1] wskazująca pośrednie miejsce docelowe, na którym znajduje się pojazd. Dostawca ustawia tę wartość. W przypadku braku wartości intermediateDestinations to pole jest ignorowane.

object (StopLocation)

Tylko dane wejściowe. Rzeczywista godzina i lokalizacja dotarcia kierowcy do pośredniego miejsca docelowego. To pole jest przeznaczone dla dostawcy do przekazywania opinii na temat rzeczywistych informacji o przyjeździe do miejsc pośrednich.

object (StopLocation)

Tylko dane wejściowe. Rzeczywisty czas i miejsce odbioru klienta z pośredniego miejsca docelowego. To pole jest przeznaczone dla dostawcy do przekazywania informacji o rzeczywistych informacjach o odbiorze w miejscach docelowych pośrednich.

object (TerminalLocation)

Lokalizacja, w której klient wskazuje, że zostanie odesłany.

object (StopLocation)

Tylko dane wejściowe. Rzeczywiste miejsce i godzinę odejścia klienta. To pole jest przeznaczone dla dostawcy do przekazywania opinii na temat rzeczywistych informacji o rezygnacji.

string (Timestamp format)

Tylko dane wyjściowe. Szacowana godzina, o której pasażerowie wysiądą w przyszłości, albo godzina, o której pasażerowie wysiądzie.

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

object (TripWaypoint)

Tylko dane wyjściowe. Pełna ścieżka z bieżącej lokalizacji do punktu zwrotu (włącznie). Ta ścieżka może obejmować punkty na trasie innych podróży.

object (TripWaypoint)

To pole umożliwia ręczne porządkowanie punktów na trasie dla podróży. Zawiera wszystkie pozostałe punkty na trasie dla przypisanego pojazdu, a także punkty odbioru i zakończenia podróży dla tej podróży. Jeśli podróż nie została przypisana do pojazdu, Fleet Engine zignoruje to pole. Ze względu na ochronę prywatności to pole jest wypełniane przez serwer tylko w przypadku wywołań trips.update i trips.create, a NIE w przypadku wywołań trips.get.

object (LatLng)

Tylko dane wyjściowe. Przewidywana trasa do pierwszego wejścia w pozostałychWaypoints. Pamiętaj, że pierwszy punkt pośredni może należeć do innej podróży.

string

Tylko dane wyjściowe. Zakodowana ścieżka do następnego punktu pośredniego.

Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK. Dekodowanie nie jest jeszcze obsługiwane.

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje czas ostatniej modyfikacji trasy.

Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK.

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

object (ConsumableTrafficPolyline)

Tylko dane wyjściowe. Wskazuje natężenie ruchu na drodze currentRouteSegment, jeśli są dostępne.

Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK.

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje, kiedy po raz ostatni zmodyfikowano currentRouteSegmentTraffic.

Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK.

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

object (TripWaypoint)

Tylko dane wyjściowe. Punkt na trasie, w którym kończy się currentRouteSegment.

integer

Tylko dane wyjściowe. Pozostała odległość samochodem podana w polu currentRouteSegment. Wartość nie jest określona, jeśli podróż nie jest przypisana do pojazdu albo została zakończona lub anulowana.

string (Timestamp format)

Tylko dane wyjściowe. Szacowany czas dotarcia do następnego punktu na trasie (pierwszy wpis w polu remainingWaypoints). Wartość jest nieokreślona, jeśli podróż nie jest przypisana do pojazdu lub jest nieaktywna (ukończona lub anulowana).

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

string (Duration format)

Tylko dane wyjściowe. Czas od zwrócenia danych o podróży do momentu w polu Trip.eta_to_first_waypoint. Wartość jest nieokreślona, jeśli podróż nie jest przypisana do pojazdu lub jest nieaktywna (ukończona lub anulowana).

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku i kończący się „s”. Przykład: "3.5s".

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmieniono element remainingWaypoints (dodano, usunięto lub zmieniono punkt pośredni).

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

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmodyfikowano remainingWaypoints.path_to_waypoint i remainingWaypoints.traffic_to_waypoint. Aplikacja kliencka powinna być w pamięci podręcznej i przekazywać ją w narzędziu GetTripRequest, aby ścieżki i ruch związane z parametrem remainingWaypoints były zwracane tylko po zaktualizowaniu.

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

integer

Stała. Wskazuje liczbę pasażerów tej podróży bez uwzględniania kierowcy. Pojazd musi mieć dostępną pojemność, aby można go było zwrócić w odpowiedzi vehicles.search.

object (VehicleLocation)

Tylko dane wyjściowe. Wskazuje ostatnią zarejestrowaną lokalizację pojazdu na trasie.

boolean

Tylko dane wyjściowe. Wskazuje, czy można przyciągnąć element lastLocation pojazdu do bieżącego segmentu trasy. Fałsz, jeśli atrybut lastLocation lub currentRouteSegment nie istnieje. Obliczane przez Fleet Engine. Wszelkie aktualizacje od klientów zostaną zignorowane.

enum (TripView)

Podzbiór pól Podróże, które zostały wypełnione i sposób ich interpretacji.

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object (LatLng)

Wymagane. Wskazuje rzeczywistą lokalizację.

string (Timestamp format)

Wskazuje, kiedy doszło do postoju.

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

string (Timestamp format)

Tylko dane wejściowe. Rola wycofana. Użyj pola sygnatury czasowej.

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