Method: providers.trips.search

Wszystkie podróże danym pojazdem.

Żą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 związany z podróżami, których dotyczy prośba. Jeśli te informacje nie są określone, zwrócone podróże nie zawierają:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Jeśli ma wartość Prawda, odpowiedź będzie obejmować Podróże, które mają wpływ na trasę kierowcy.

pageSize

integer

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

pageToken

string

Aby kontynuować od poprzednich wyników, ustaw tę wartość na wartość zwrócona w polu 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 9 cyfr po przecinku, kończący się cyfrą „s”. Przykład: "3.5s".

Treść odpowiedzi

journey.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 żądanym pojazdem.

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ż żadnych wyników, lista przejazdów jest pusta.