Method: providers.trips.search

Pobierz wszystkie podróże dotyczące konkretnego 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

Wymagany. Musi mieć format providers/{provider}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) projektu Google Cloud, do którego należy konto usługi wywołujące to połączenie.

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 żądaniami żądania. Jeśli nie określono inaczej, zwrócone podróże nie zawierają:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Jeśli ma wartość Prawda, odpowiedź obejmuje podróże, które wpływają na trasę kierowcy.
pageSize

integer

Jeśli nie jest skonfigurowana, serwer decyduje, ile wyników ma zostać zwróconych.
pageToken

string

Aby kontynuować od poprzednich wyników, ustaw tę wartość na wartość zwracaną wcześniej w polu SearchTripsResponse.
minimumStaleness

string (Duration format)

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

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, który kończy się na „s”. Przykład: "3.5s".

Treść odpowiedzi

w trakcie odpowiadania na pytania.

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

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

object (Trip)

Lista podróży żądanym pojazdem.
nextPageToken

string

Przekaż ten token w wywołaniu SearchTripsRequest do strony z wynikami listy. Interfejs API zwraca listę podróży przy każdym wywołaniu, a jeśli dalsze wyniki nie pozostaną puste, lista podróży będzie pusta.