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.

vehicleId

string

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

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

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

pageSize

integer

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

pageToken

string

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

minimumStaleness

string ( Duration format)

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

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

Тело ответа

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

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

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

object ( Trip )

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

nextPageToken

string

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