Zasób: Trip
Metadane dotyczące podróży.
Zapis JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. W formacie „dostawcy/{dostawca}/podróże/{podróż}” |
vehicle |
Identyfikator pojazdu, który odbywa tę podróż. |
trip |
Bieżący stan podróży. |
trip |
Typ podróży. |
pickup |
Miejsce, w którym klient wskazuje, że chce odebrać przesyłkę. |
actual |
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. |
actual |
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. |
pickup |
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: |
intermediate |
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. |
intermediate |
Wskazuje czas ostatniej modyfikacji 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: |
intermediate |
Jeśli |
actual |
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. |
actual |
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. |
dropoff |
Lokalizacja, w której klient wskazuje, że zostanie odesłany. |
actual |
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. |
dropoff |
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: |
remaining |
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. |
vehicle |
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ń |
route[] |
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. |
current |
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. |
current |
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: |
current |
Tylko dane wyjściowe. Wskazuje natężenie ruchu na drodze Uwaga: to pole jest przeznaczone do użytku wyłącznie przez pakiety Driver SDK i Consumer SDK. |
current |
Tylko dane wyjściowe. Wskazuje, kiedy po raz ostatni zmodyfikowano 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: |
current |
Tylko dane wyjściowe. Punkt na trasie, w którym kończy się |
remaining |
Tylko dane wyjściowe. Pozostała odległość do przejechania w polu |
eta |
Tylko dane wyjściowe. Szacowany czas dotarcia do następnego punktu na trasie (pierwszy wpis w polu 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: |
remaining |
Tylko dane wyjściowe. Czas od zwrócenia danych o podróży do momentu w polu Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku i kończący się „ |
remaining |
Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmieniono element Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
remaining |
Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmodyfikowano 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: |
number |
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 |
last |
Tylko dane wyjściowe. Wskazuje ostatnią zarejestrowaną lokalizację pojazdu na trasie. |
last |
Tylko dane wyjściowe. Wskazuje, czy |
view |
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 ( |
Pola | |
---|---|
point |
Wymagane. Wskazuje rzeczywistą lokalizację. |
timestamp |
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: |
stopTime |
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: |
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 |
|
---|---|
|
Tworzy przejazd w silniku floty i zwraca nowy przejazd. |
|
uzyskać informacje o pojedynczej podróży; |
|
Znajdziesz tu wszystkie dane dotyczące podróży konkretnym pojazdem. |
|
Aktualizuje dane dotyczące przejazdu. |