REST Resource: providers.trips

Zasób: podróż

Metadane podróży.

Zapis JSON 
{
  "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)
}
Pola
name

string

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

string

Identyfikator pojazdu, który odbywa tę podróż.
tripStatus

enum (TripStatus)

Bieżący stan podróży.
tripType

enum (TripType)

Typ podróży.
pickupPoint

object (TerminalLocation)

Miejsce, w którym klient wskazuje, że chce odebrać przesyłkę.
actualPickupPoint

object (StopLocation)

Tylko dane wejściowe. Rzeczywista lokalizacja i miejsce odbioru klienta. To pole jest przeznaczone dla dostawcy, który może w nim podać informacje o rzeczywistym odbiorze.
actualPickupArrivalPoint

object (StopLocation)

Tylko dane wejściowe. Rzeczywista godzina przyjazdu kierowcy do punktu odbioru i lokalizacja kierowcy. To pole jest przeznaczone dla dostawcy, który może w nim podać informacje o faktycznym przybyciu do punktu odbioru.
pickupTime

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 formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
intermediateDestinations[]

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

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 formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
intermediateDestinationIndex

integer

Jeśli TripStatus to ENROUTE_TO_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1] wskazuje pośredni miejsce docelowe, przez które pojazd będzie następny. Gdy TripStatus = ARRIVED_AT_INTERMEDIATE_DESTINATION, liczba z zakresu [0..N-1], która wskazuje, w jakiej lokalizacji pośredniej znajduje się pojazd. Dostawca ustawia tę wartość. W przypadku braku wartości intermediateDestinations to pole jest ignorowane.
actualIntermediateDestinationArrivalPoints[]

object (StopLocation)

Tylko dane wejściowe. Rzeczywista godzina i lokalizacja dotarcia kierowcy do pośredniego miejsca docelowego. To pole jest przeznaczone dla dostawcy, który może podać informacje o rzeczywistym czasie przybycia do pośrednich miejsc docelowych.
actualIntermediateDestinations[]

object (StopLocation)

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

object (TerminalLocation)

Miejsce, w którym klient chce zostać odebrany.
actualDropoffPoint

object (StopLocation)

Tylko dane wejściowe. Rzeczywisty czas i miejsce, w którym klient został odwieziony. To pole jest przeznaczone dla dostawcy, który może podać informacje o rzeczywistym czasie i miejscu odwiezienia.
dropoffTime

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 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".
remainingWaypoints[]

object (TripWaypoint)

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

object (TripWaypoint)

To pole umożliwia ręczne sortowanie punktów pośrednich na trasie. Zawiera wszystkie pozostałe punkty pośrednie dla przypisanego pojazdu, a także punkty odbioru i rozładunku w ramach 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 trips.get.
route[]

object (LatLng)

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

string

Tylko dane wyjściowe. zakodowana ścieżka do następnego punktu orientacyjnego;

Uwaga: to pole jest przeznaczone tylko do użycia przez pakiet SDK sterownika i pakiet SDK dla konsumentów. Dekodowanie nie jest jeszcze obsługiwane.
currentRouteSegmentVersion

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje, kiedy trasa została ostatnio zmodyfikowana.

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

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
currentRouteSegmentTraffic

object (ConsumableTrafficPolyline)

Tylko dane wyjściowe. Wskazuje warunki natężenia ruchu na trasie currentRouteSegment (jeśli są dostępne).

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

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje, kiedy currentRouteSegmentTraffic został ostatnio zmodyfikowany.

Uwaga: to pole jest przeznaczone tylko do użycia przez pakiet SDK sterownika i pakiet SDK dla konsumentów.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
currentRouteSegmentEndPoint

object (TripWaypoint)

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

integer

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

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 przejazd nie jest przypisany do pojazdu lub jest nieaktywny (ukończony lub anulowany).

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

string (Duration format)

Tylko dane wyjściowe. Czas od momentu zwrócenia danych o podróży do czasu podanego w 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 w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".
remainingWaypointsVersion

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje ostatnią zmianę remainingWaypoints (dodanie, usunięcie lub zmianę punktu orientacyjnego).

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
remainingWaypointsRouteVersion

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmodyfikowano remainingWaypoints.path_to_waypoint i remainingWaypoints.traffic_to_waypoint. Aplikacja kliencka powinna przekazywać tę wartość 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 formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
numberOfPassengers

integer

Niezmienna. Wskazuje liczbę pasażerów w danej podróży, nie wliczając kierowcy. Pojazd musi mieć dostępną pojemność, aby można go było zwrócić w odpowiedzi vehicles.search.
lastLocation

object (VehicleLocation)

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

boolean

Tylko dane wyjściowe. Wskazuje, czy lastLocation pojazdu może być dopasowywany do currentRouteSegment. Fałsz, jeśli atrybut lastLocation lub currentRouteSegment nie istnieje. Obliczane przez Fleet Engine. Wszelkie aktualizacje od klientów zostaną zignorowane.
view

enum (TripView)

Podzbiór wypełnionych pól Podróży i sposób ich interpretacji.

TripStatus

Stan przejazdu wskazujący jego postęp.

Wartości w polu enum
UNKNOWN_TRIP_STATUS Domyślna używana w przypadku nieokreślonego lub nierozpoznanego stanu podróży.
NEW Nowo utworzona podróż.
ENROUTE_TO_PICKUP Kierowca jest w drodze do punktu odbioru.
ARRIVED_AT_PICKUP Kierowca dotarł do punktu odbioru.
ARRIVED_AT_INTERMEDIATE_DESTINATION Kierowca dotarł do miejsca docelowego pośredniego i czeka na pasażera.
ENROUTE_TO_INTERMEDIATE_DESTINATION Kierowca jest w drodze do pośredniego miejsca docelowego (nie do punktu nadania).
ENROUTE_TO_DROPOFF Kierowca odebrał pasażera i jedzie do następnego miejsca docelowego.
COMPLETE Pasażer został już odwieziony, a przejazd został zakończony.
CANCELED Podróż została anulowana przed odbiorem przez kierowcę, pasażera lub dostawcę wspólnych przejazdów.

StopLocation

Rzeczywista lokalizacja, w której miał miejsce przystanek (odbiór/zwrot).

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

object (LatLng)

Wymagane. Wskazuje rzeczywistą lokalizację.
timestamp

string (Timestamp format)

Wskazuje, kiedy nastąpiło zatrzymanie.

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".
stopTime
(deprecated)

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

TripView

Selektor różnych zestawów pól Podróż w odpowiedzi trips.get. Kontekst znajdziesz na stronie AIP-157. Prawdopodobnie uda się dodać więcej widoków.

Wartości w polu enum
TRIP_VIEW_UNSPECIFIED Wartość domyślna. Aby zapewnić zgodność wsteczną, interfejs API domyślnie użyje widoku pakietu SDK. Aby zapewnić stabilność i wsparcie, klienci powinni wybrać TripView inne niż SDK.
SDK Obejmuje pola, które mogą nie być interpretowane lub obsługiwane za pomocą publicznie dostępnych bibliotek.
JOURNEY_SHARING_V1S Pola dotyczące podróży są wypełniane na potrzeby udostępniania trasy. Ten widok jest przeznaczony do komunikacji między serwerami.

Metody

create

 Tworzy przejazd w silniku floty i zwraca nowy przejazd.

get

 Informacje o pojedynczej podróży.
Pobierz wszystkie podróże danego pojazdu.

update

 Aktualizuje dane o podróży.