Zasób: Podróż
Metadane podróży.
Zapis JSON |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. W formacie „providers/{provider}/trips/{trip} |
vehicleId |
Identyfikator pojazdu w tej podróży. |
tripStatus |
Aktualny stan podróży. |
tripType |
Typ podróży. |
pickupPoint |
Lokalizacja, w której klient może odebrać zamówienie. |
actualPickupPoint |
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. |
actualPickupArrivalPoint |
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. |
pickupTime |
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: |
intermediateDestinations[] |
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. |
intermediateDestinationsVersion |
Wskazuje ostatnią zmianę elementu Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
intermediateDestinationIndex |
Gdy |
actualIntermediateDestinationArrivalPoints[] |
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. |
actualIntermediateDestinations[] |
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. |
dropoffPoint |
Lokalizacja, w której klient wskazuje, że zostanie odesłany. |
actualDropoffPoint |
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. |
dropoffTime |
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: |
remainingWaypoints[] |
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. |
vehicleWaypoints[] |
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 |
route[] |
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. |
currentRouteSegment |
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. |
currentRouteSegmentVersion |
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: |
currentRouteSegmentTraffic |
Tylko dane wyjściowe. Wskazuje warunki na drodze ( Uwaga: to pole jest przeznaczone tylko do użycia w pakietach Driver SDK i Consumer SDK. |
currentRouteSegmentTrafficVersion |
Tylko dane wyjściowe. Wskazuje ostatnią zmianę elementu 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: |
currentRouteSegmentEndPoint |
Tylko dane wyjściowe. Punkt pośredni, gdzie kończy się |
remainingDistanceMeters |
Tylko dane wyjściowe. Pozostała odległość w polu |
etaToFirstWaypoint |
Tylko dane wyjściowe. Szacowany czas dotarcia do następnego punktu na trasie (pierwszy wpis w polu Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
remainingTimeToFirstWaypoint |
Tylko dane wyjściowe. Czas, jaki upływa od momentu zwrócenia danych o podróży do godziny w kolumnie Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
remainingWaypointsVersion |
Tylko dane wyjściowe. Wskazuje, kiedy ostatnio zmieniono obiekt Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
remainingWaypointsRouteVersion |
Tylko dane wyjściowe. Wskazuje ostatnią zmianę elementów Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: |
numberOfPassengers |
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 |
lastLocation |
Tylko dane wyjściowe. Wskazuje ostatnią lokalizację pojazdu na trasie. |
lastLocationSnappable |
Tylko dane wyjściowe. Wskazuje, czy obiekt |
view |
Podzbiór wypełnionych pól Podróż i sposobu ich interpretacji. |
TripStatus
Stan podróży wskazujący jej postęp.
Wartości w polu enum | |
---|---|
UNKNOWN_TRIP_STATUS |
Domyślny, używany 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ł na miejsce 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 miejsca docelowego). |
ENROUTE_TO_DROPOFF |
Kierowca podwoił pasażera i jedzie do następnego miejsca docelowego. |
COMPLETE |
Pasażer został wysadzony i podróż się zakończył. |
CANCELED |
Podróż została anulowana przed odbiorem przez kierowcę, pasażera lub firmę oferującą wspólne przejazdy. |
StopLocation
Rzeczywiste miejsce, w którym zatrzymano się (odbiór/zwrot).
Zapis JSON |
---|
{
"point": {
object ( |
Pola | |
---|---|
point |
To pole jest wymagane. Wskazuje rzeczywistą lokalizację. |
timestamp |
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: |
stopTime |
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: |
TripView
Selektor różnych zestawów pól Podróż w odpowiedzi trips.get
. Kontekst znajdziesz na stronie AIP-157. Prawdopodobnie zostaną dodane dodatkowe widoki.
Wartości w polu enum | |
---|---|
TRIP_VIEW_UNSPECIFIED |
Wartość domyślna. Aby zapewnić zgodność wsteczną, interfejs API będzie domyślnie wyświetlać widok pakietu SDK. W celu zapewnienia stabilności i wsparcia zalecamy klientom wybranie atrybutu TripView innego niż SDK . |
SDK |
Obejmuje pola, których nie można interpretować lub obsługiwać za pomocą publicznie dostępnych bibliotek. |
JOURNEY_SHARING_V1S |
Pola podróży są wypełnione na potrzeby udostępniania serii czynności. Ten widok jest przeznaczony do komunikacji między serwerami. |
Metody |
|
---|---|
|
Tworzy podróż w Fleet Engine i zwraca nową podróż. |
|
Uzyskiwanie informacji o pojedynczej podróży. |
|
Wyświetl wszystkie przejazdy wybranym pojazdem. |
|
Aktualizuje dane podróży. |