Method: providers.trips.search

Wyświetl wszystkie przejazdy wybranym 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

To pole jest 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 nie określono inaczej, zwrócone podróże nie będą zawierały:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Jeśli zasada ma wartość Prawda, odpowiedź uwzględnia podróże, które mają wpływ na trasę kierowcy.

pageSize

integer

Jeśli zasada nie jest skonfigurowana, serwer określa liczbę wyników do zwrócenia.

pageToken

string

Aby kontynuować od poprzednich wyników, wpisz wartość, która wcześniej została zwrócona w funkcji SearchTripsResponse.

minimumStaleness

string (Duration format)

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

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

Treść odpowiedzi

podczas wyszukiwania wiadomości.

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 żądaniu SearchTripsRequest, aby wyświetlić wyniki listy. Interfejs API zwraca listę podróży przy każdym wywołaniu, a gdy nie ma więcej wyników, lista podróży jest pusta.