Method: providers.trips.search

Pobierz wszystkie podróże danego pojazdu.

Żądanie HTTP

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips:search

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Musi mieć format providers/{provider}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi wywołujące to wywołanie.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "header": {
    object (RequestHeader)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
Pola
header

object (RequestHeader)

Standardowy nagłówek żądania Fleet Engine.
vehicleId

string

Pojazd powiązany z podróżami w żądaniu. Jeśli te informacje nie są określone, zwrócone podróże nie zawierają:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Jeśli ustawisz tę wartość na „PRAWDA”, odpowiedź będzie zawierać Przejazdy, które wpływają na trasę kierowcy.
pageSize

integer

Jeśli jej nie skonfigurujesz, serwer decyduje o liczbie wyników do zwrócenia.
pageToken

string

Aby kontynuować z poprzednich wyników, ustaw tę wartość na wartość zwróconą wcześniej w SearchTripsResponse.
minimumStaleness

string (Duration format)

Jeśli został podany, zwraca podróże, które nie zostały zaktualizowane po czasie (current - minimumStaleness).

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

Treść odpowiedzi

wiadomość z poziomu odpowiedzi na wywołanie trips.search.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
Pola
trips[]

object (Trip)

Lista przejazdów dla wybranego pojazdu.
nextPageToken

string

Przekaż ten token w SearchTripsRequest, aby przeglądać wyniki z listy. Interfejs API zwraca listę przejazdów przy każdym wywołaniu, a gdy nie ma już wyników, lista przejazdów jest pusta.