Method: providers.trips.search

Получите все поездки для конкретного автомобиля.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

Необходимый. Должно быть в формате providers/{provider} . Поставщиком должен быть идентификатор проекта (например, sample-cloud-project ) проекта Google Cloud, участником которого является сервисный аккаунт, выполняющий этот вызов.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "header": {
    object (RequestHeader)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
Поля
header

object ( RequestHeader )

Стандартный заголовок запроса Fleet Engine.

vehicle Id

string

Транспортное средство, связанное с поездками в запросе. Если не указано, возвращенные поездки не содержат:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
active Trips Only

boolean

Если установлено значение true, ответ включает поездки, влияющие на маршрут водителя.

page Size

integer

Если не установлено, сервер определяет количество возвращаемых результатов.

page Token

string

Установите для этого значения значение, ранее возвращенное в SearchTripsResponse чтобы продолжить работу с предыдущими результатами.

minimum Staleness

string ( Duration format)

Если указано, возвращает поездки, которые не были обновлены по истечении времени (current - minimumStaleness) .

Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « s ». Пример: "3.5s" .

Тело ответа

Ответное сообщение trips.search.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
Поля
trips[]

object ( Trip )

Список поездок для запрошенного автомобиля.

next Page Token

string

Передайте этот токен в SearchTripsRequest для пролистывания результатов списка. API возвращает список поездок при каждом вызове, и когда результатов больше не остается, список поездок пуст.