Zasób: podróż
Metadane podróży.
Zapis JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. W formacie „dostawcy/{dostawca}/podróże/{podróż}” |
vehicleId |
Identyfikator pojazdu, który pokonuje tę podróż. |
tripStatus |
Bieżący stan podróży. |
tripType |
Typ podróży. |
pickupPoint |
Miejsce, w którym klient wskazuje, że zostanie odebrany. |
actualPickupPoint |
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. |
actualPickupArrivalPoint |
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 |
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: |
intermediateDestinations[] |
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 |
Wskazuje, kiedy po raz ostatni zmodyfikowano Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
intermediateDestinationIndex |
Jeśli |
actualIntermediateDestinationArrivalPoints[] |
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. |
actualIntermediateDestinations[] |
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. |
dropoffPoint |
Lokalizacja, w której klient wskazuje, że zostanie odesłany. |
actualDropoffPoint |
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 |
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: |
remainingWaypoints[] |
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[] |
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ń |
route[] |
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. |
currentRouteSegment |
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 |
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: |
currentRouteSegmentTraffic |
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. |
currentRouteSegmentTrafficVersion |
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: |
currentRouteSegmentEndPoint |
Tylko dane wyjściowe. Punkt na trasie, w którym kończy się |
remainingDistanceMeters |
Tylko dane wyjściowe. Pozostała odległość samochodem podana w polu |
etaToFirstWaypoint |
Tylko dane wyjściowe. Szacowany czas dotarcia do następnego punktu na trasie (pierwszy wpis w polu Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
remainingTimeToFirstWaypoint |
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, kończący się cyfrą „ |
remainingWaypointsVersion |
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: |
remainingWaypointsRouteVersion |
Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmodyfikowano Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
numberOfPassengers |
Stały. 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 |
lastLocation |
Tylko dane wyjściowe. Wskazuje ostatnią zarejestrowaną lokalizację pojazdu na trasie. |
lastLocationSnappable |
Tylko dane wyjściowe. Wskazuje, czy można przyciągnąć element |
view |
Podzbiór pól Podróże, które zostały wypełnione 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 wysiądzie i podróż się zakończyła. |
CANCELED |
Podróż została anulowana przed odbiorem przez kierowcę, pasażera lub dostawcę wspólnych przejazdów. |
StopLocation
Rzeczywista lokalizacja, w której miała miejsce przystanek (odbiór/zwrot).
Zapis JSON |
---|
{
"point": {
object ( |
Pola | |
---|---|
point |
Wymagane. Wskazuje rzeczywistą lokalizację. |
timestamp |
Wskazuje, kiedy doszło do postoju. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
stopTime |
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: |
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órych interpretacja lub działanie może być niemożliwe przy użyciu publicznie dostępnych bibliotek. |
JOURNEY_SHARING_V1S |
Pola dotyczące podróży są wypełniane w przypadku zastosowania funkcji udostępniania trasy. Ten widok jest przeznaczony do komunikacji między serwerami. |
Metody |
|
---|---|
|
Tworzy podróż we Fleet Engine i zwraca nową podróż. |
|
Informacje o pojedynczej podróży. |
|
Wszystkie podróże danym pojazdem. |
|
Aktualizuje dane o podróży. |