REST Resource: providers.trips

Zasób: Trip

Metadane dotyczące 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, w której i kiedy odebrano 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 do przekazywania opinii na temat rzeczywistych informacji o przyjeździe do punktu odbioru.

pickupTime

string (Timestamp format)

Tylko dane wyjściowe. Przewidywany czas, w którym pasażerowie zostaną odebrani, lub faktyczny czas odbioru.

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""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 możliwe w przypadku udostępnionych przejazdów.

intermediateDestinationsVersion

string (Timestamp format)

Wskazuje czas ostatniej modyfikacji 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""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 jakim miejscu pośrednim znajduje się pojazd. Wartość tę ustawia dostawca. W przypadku braku wartości intermediateDestinations to pole jest ignorowane.

actualIntermediateDestinationArrivalPoints[]

object (StopLocation)

Tylko dane wejściowe. Rzeczywisty czas i miejsce przyjazdu kierowcy do miejsca docelowego pośredniego. 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, w którym i kiedy klient został odebrany z miejsca docelowego pośredniego. To pole jest przeznaczone dla dostawcy, który może w nim podać informacje o rzeczywistych danych dotyczących odbioru w miejscach pośrednich.

dropoffPoint

object (TerminalLocation)

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

actualDropoffPoint

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.

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

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 obejmować punkty na trasie innych podróży.

vehicleWaypoints[]

object (TripWaypoint)

To pole umożliwia ręczne sortowanie punktów pośrednich na trasie. 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.

route[]

object (LatLng)

Tylko dane wyjściowe. Przewidywana trasa dla tej podróży do pierwszego wpisu w sekcji remainingWaypoints. 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 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.

currentRouteSegmentVersion

string (Timestamp format)

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

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

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

currentRouteSegmentTraffic

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.

currentRouteSegmentTrafficVersion

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""2014-10-02T15:01:23.045123456Z".

currentRouteSegmentEndPoint

object (TripWaypoint)

Tylko dane wyjściowe. Punkt na trasie, 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 podróż nie jest przypisana do pojazdu lub jest nieaktywna (ukończona lub anulowana).

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

remainingTimeToFirstWaypoint

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

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

remainingWaypointsVersion

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

remainingWaypointsRouteVersion

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmodyfikowano remainingWaypoints.path_to_waypoint i remainingWaypoints.traffic_to_waypoint. Aplikacja klienta powinna przechowywać tę wartość w pamięci podręcznej i przekazywać ją w wartości GetTripRequest, aby mieć pewność, że ścieżki i ruchy dla remainingWaypoints są zwracane tylko wtedy, gdy są aktualne.

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""2014-10-02T15:01:23.045123456Z".

numberOfPassengers

integer

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

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 podróży wskazujący jej 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 pośredniego miejsca docelowego 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 zabierze pasażera i jest w drodze 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 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".

stopTime
(deprecated)

string (Timestamp format)

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

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""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. Ze względu na zgodność wsteczną interfejs API domyślnie wyświetla widok pakietu SDK. Aby zapewnić stabilność i obsługę, zalecamy klientom wybranie TripView innego 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 w przypadku użycia funkcji Udostępnianie trasy. Ten widok jest przeznaczony do komunikacji między serwerami.

Metody

create

Tworzy przejazd w silniku floty i zwraca nowy przejazd.

get

uzyskać informacje o pojedynczej podróży;
Znajdziesz tu wszystkie dane dotyczące podróży konkretnym pojazdem.

update

Aktualizuje dane dotyczące przejazdu.