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 „providers/{provider}/trips/{trip}”
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. Rzeczywisty czas i miejsce przyjazdu kierowcy do punktu odbioru. 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. Przewidywany czas, w którym pasażerowie zostaną odebrani, lub faktyczny czas ich odbioru.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
intermediateDestinations[]

object (TerminalLocation)

Przerwy na trasie (oprócz miejsca odbioru i celu podróży). Początkowo nie będzie to możliwe w przypadku udostępnionych przejazdów.
intermediateDestinationsVersion

string (Timestamp format)

Wskazuje, kiedy intermediateDestinations został ostatnio zmodyfikowany. Twój serwer powinien przechowywać tę wartość w pamięci podręcznej i przekazywać ją w UpdateTripRequest podczas aktualizacji intermediateDestinationIndex, aby zapewnić, że wartość intermediateDestinations się nie zmieni.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
intermediateDestinationIndex

integer

Jeśli TripStatus = ENROUTE_TO_INTERMEDIATE_DESTINATION, to liczba z zakresu [0..N-1], która wskazuje, który pośredni cel pojazd przejdzie jako 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. Wartość tę ustawia dostawca. Jeśli nie ma 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 w nim podać informacje o faktycznym 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 faktycznych danych dotyczących odbioru w miejscach 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. Przewidywany czas, w którym pasażerowie zostaną wysadzeni w miejscu docelowym, lub rzeczywisty czas ich wysadzenia.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
remainingWaypoints[]

object (TripWaypoint)

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

object (TripWaypoint)

To pole umożliwia ręczne uporządkowanie 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 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 orientacyjnego;

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

string (Timestamp format)

Tylko dane wyjściowe. Wskazuje czas ostatniej modyfikacji trasy.

Uwaga: to pole jest przeznaczone tylko do użycia przez pakiet SDK kierowcy i pakiet SDK klienta.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
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 tylko do użycia przez pakiet SDK kierowcy i pakiet SDK klienta.
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 kierowcy i pakiet SDK klienta.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
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. Jeśli przejazd nie jest przypisany do pojazdu lub został już zrealizowany lub anulowany, wartość jest nieokreślona.
etaToFirstWaypoint

string (Timestamp format)

Tylko dane wyjściowe. Przewidywany czas dojazdu do następnego punktu orientacyjnego (pierwszy wpis w polu remainingWaypoints). Wartość jest nieokreślona, jeśli przejazd nie jest przypisany do pojazdu lub jest nieaktywny (ukończony lub anulowany).

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
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 przejazd nie jest przypisany do pojazdu lub jest nieaktywny (ukończony lub anulowany).

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

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
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 zostały zaktualizowane.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
numberOfPassengers

integer

Niezmienna. Wskazuje liczbę pasażerów w danej podróży, nie wliczając kierowcy. Pojazd musi mieć dostępne miejsce, aby można było zwrócić odpowiedź vehicles.search.
lastLocation

object (VehicleLocation)

Tylko dane wyjściowe. Wskazuje ostatnią zgłoszoną lokalizację pojazdu na trasie.
lastLocationSnappable

boolean

Tylko dane wyjściowe. Wskazuje, czy lastLocation pojazdu może być dopasowywany do currentRouteSegment. Wartość Fałsz, jeśli lastLocation lub currentRouteSegment nie istnieje. Jest on obliczany przez mechanizm Fleet. 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 miejsca 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 miejsca docelowego pośredniego (a nie do miejsca wysadzania).
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 Przejazd został anulowany przed odbiorem przez kierowcę, pasażera lub dostawcę usług przewozu.

StopLocation

Rzeczywista lokalizacja przystanku (odbiór/zwrot).

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

object (LatLng)

Wymagany. Oznacza rzeczywistą lokalizację.
timestamp

string (Timestamp format)

Wskazuje, kiedy nastąpiło zatrzymanie.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
stopTime
(deprecated)

string (Timestamp format)

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

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

TripView

Selektor różnych zestawów pól Podróż w odpowiedzi trips.get. Więcej informacji znajdziesz w AIP-157. Prawdopodobnie zostaną dodane dodatkowe widoki.

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 na potrzeby udostępniania trasy. Ten widok jest przeznaczony do komunikacji między serwerami.

Metody

create

 Tworzy przejazd w Fleet Engine i zwraca nowy przejazd.

delete

 Usuwa pojedynczą podróż.

get

 Uzyskaj informacje o pojedynczej podróży.
Pobierz wszystkie podróże konkretnego pojazdu.

update

 Aktualizuje dane przejazdu.