Method: providers.trips.search

Znajdziesz tu wszystkie dane dotyczące podróży konkretnym 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 wykonują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 nie podano tego argumentu, zwracane przejazdy nie zawierają:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Jeśli ustawisz tę opcję 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 w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „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 żą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.