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 „providers/{provider}/trips/{trip}

string

Identyfikator pojazdu w tej podróży.

enum (TripStatus)

Aktualny stan podróży.

enum (TripType)

Typ podróży.

object (TerminalLocation)

Lokalizacja, w której klient może odebrać zamówienie.

object (StopLocation)

Tylko dane wejściowe. Rzeczywiste miejsce, w którym klient został odebrany. To pole jest przeznaczone dla dostawcy do przesyłania opinii na temat rzeczywistych informacji o odbiorze.

object (StopLocation)

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

string (Timestamp format)

Tylko dane wyjściowe. Przewidywana godzina odjazdu pasażera lub rzeczywista godzina wysiadania.

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

object (TerminalLocation)

Pośrednie przystanki w takiej kolejności, w jakiej zostały wysłane żądanie podróży (a nie tylko w przypadku odbioru i zwrotu). Początkowo nie będzie dostępna w przypadku wspólnych podróży.

string (Timestamp format)

Wskazuje ostatnią zmianę elementu intermediateDestinations. Serwer powinien buforować tę wartość i przekazać ją w UpdateTripRequest po aktualizacji intermediateDestinationIndex, aby mieć pewność, że intermediateDestinations nie uległo zmianie.

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

integer

Gdy TripStatus to ENROUTE_TO_INTERMEDIATE_DESTINATION, jest to liczba z zakresu od [0..N-1] wskazująca, gdzie następny cel pośredni, który pojazd przemieści się w następnej kolejności. Gdy TripStatus to ARRIVED_AT_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1] wskazująca, w którym punkcie pośrednim znajduje się pojazd. Tę wartość ustawia dostawca. Jeśli nie ma wartości intermediateDestinations, to pole jest ignorowane.

object (StopLocation)

Tylko dane wejściowe. Rzeczywista godzina i lokalizacja przybycia kierowcy do miejsca docelowego pośredniego. To pole jest przeznaczone dla usługodawcy do przesyłania opinii na temat rzeczywistego przyjazdu do miejsc docelowych pośrednich.

object (StopLocation)

Tylko dane wejściowe. Rzeczywista godzina i miejsce odbioru klienta z pośredniego miejsca docelowego. To pole jest przeznaczone dla dostawcy do przesyłania opinii na temat rzeczywistych informacji o odbiorze w pośrednich miejscach docelowych.

object (TerminalLocation)

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

object (StopLocation)

Tylko dane wejściowe. Rzeczywista godzina i miejsce wysyłki klienta. To pole służy dostawcy do przekazywania opinii na temat rzeczywistych informacji o porzuceniu.

string (Timestamp format)

Tylko dane wyjściowe. Przybliżona godzina wysiedlenia pasażerów w przyszłości na miejscu docelowym lub rzeczywista godzina wysiedlenia.

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

object (TripWaypoint)

Tylko dane wyjściowe. Pełna ścieżka od bieżącej lokalizacji do miejsca docelowego włącznie. Może ona obejmować punkty na trasie z innych podróży.

object (TripWaypoint)

To pole umożliwia ręczne ustalanie kolejności punktów na trasie. Zawiera wszystkie pozostałe punkty na trasie dla przypisanego pojazdu, a także punkty na początku i na końcu 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 tylko przez serwer w wywołaniach trips.update i trips.create, a NIE przez wywołania trips.get.

object (LatLng)

Tylko dane wyjściowe. Przewidywana trasa tej podróży do pierwszego wejścia w pozostałych punktachWaypoints. Zwróć uwagę, że pierwszy punkt na trasie może należeć do innej podróży.

string

Tylko dane wyjściowe. Zakodowana ścieżka do następnego punktu na trasie.

Uwaga: to pole jest przeznaczone tylko do użycia w pakietach Driver SDK i Consumer SDK. Dekodowanie nie jest jeszcze obsługiwane.

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje ostatnią zmianę trasy.

Uwaga: to pole jest przeznaczone tylko do użycia w pakietach Driver SDK i Consumer SDK.

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

object (ConsumableTrafficPolyline)

Tylko dane wyjściowe. Wskazuje warunki na drodze (currentRouteSegment), gdy są dostępne.

Uwaga: to pole jest przeznaczone tylko do użycia w pakietach Driver SDK i Consumer SDK.

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje ostatnią zmianę elementu currentRouteSegmentTraffic.

Uwaga: to pole jest przeznaczone tylko do użycia w pakietach Driver SDK i Consumer SDK.

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

object (TripWaypoint)

Tylko dane wyjściowe. Punkt pośredni, gdzie kończy się currentRouteSegment.

integer

Tylko dane wyjściowe. Pozostała odległość w polu currentRouteSegment. Wartość nie jest określona, jeśli podróż nie została przypisana do pojazdu albo podróż została ukoń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ść nie jest określona, jeśli podróż nie jest przypisana do pojazdu lub podróż jest nieaktywna (ukończona lub anulowana).

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

string (Duration format)

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

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmieniono obiekt remainingWaypoints (punkt pośredni został dodany, usunięty lub zmieniony).

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

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje ostatnią zmianę elementów remainingWaypoints.path_to_waypoint i remainingWaypoints.traffic_to_waypoint. Aplikacja kliencka powinna buforować tę wartość i przekazywać ją w GetTripRequest, aby mieć pewność, że ścieżki i ruch dla remainingWaypoints będą zwracane tylko po zaktualizowaniu.

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

integer

Niezmienne. Wskazuje liczbę pasażerów w tej podróży. Nie obejmuje 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ą lokalizację pojazdu na trasie.

boolean

Tylko dane wyjściowe. Wskazuje, czy obiekt lastLocation pojazdu może być przyciągany do obecnegosegmentu. Jeśli lastLocation lub currentRouteSegment nie istnieje, ma wartość Fałsz. Oblicza je Fleet Engine. Wszelkie aktualizacje klientów będą ignorowane.

enum (TripView)

Podzbiór wypełnionych pól Podróż i sposobu ich interpretacji.

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

object (LatLng)

To pole jest wymagane. Wskazuje rzeczywistą lokalizację.

string (Timestamp format)

Wskazuje, kiedy miał miejsce postój.

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

string (Timestamp format)

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

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