Method: providers.vehicles.list

string

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

object ( RequestHeader )

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

integer

Максимальное количество возвращаемых автомобилей. Значение по умолчанию: 100.

string

Значение nextPageToken предоставленное предыдущим вызовом vehicles.list , чтобы вы могли перемещаться по группам транспортных средств. Значение не определено, если критерии фильтра запроса не совпадают с критериями фильтра для предыдущего вызова vehicles.list .

integer

Указывает необходимую минимальную грузоподъемность автомобиля. Все возвращенные транспортные средства будут иметь maximumCapacity превышающую или равную этому значению. Если установлено, должно быть больше или равно 0.

enum ( TripType )

Ограничивает ответ транспортными средствами, которые поддерживают хотя бы один из указанных типов поездок.

string ( Duration format)

Ограничивает ответ транспортными средствами, которые отправили обновления местоположения в Fleet Engine в течение указанного периода. Стационарные транспортные средства, все еще передающие свое местоположение, не считаются устаревшими. Если присутствует, должна быть действительная положительная продолжительность.

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

enum ( Category )

Необходимый. Ограничивает ответ транспортными средствами одной из указанных типовых категорий. UNKNOWN не допускается.

string

Вызывающие объекты могут формировать сложные логические операции, используя любую комбинацию полей requiredAttributes , requiredOneOfAttributes и requiredOneOfAttributeSets .

requiredAttributes — это список; requiredOneOfAttributes использует сообщение, которое разрешает создание списка списков. В сочетании эти два поля позволяют составить это выражение:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(requiredOneOfAttributes[0][0] OR requiredOneOfAttributes[0][1] OR
...)
AND
(requiredOneOfAttributes[1][0] OR requiredOneOfAttributes[1][1] OR
...)

Ограничивает ответ транспортными средствами с указанными атрибутами. Это поле представляет собой операцию конъюнкции/И. Допускается максимум 50 обязательных атрибутов. Это соответствует максимальному количеству атрибутов, разрешенных для транспортного средства. Каждая повторяющаяся строка должна иметь формат «ключ:значение».

string

Ограничивает ответ транспортными средствами, имеющими хотя бы один из указанных атрибутов в каждом VehicleAttributeList . В каждом списке транспортное средство должно соответствовать хотя бы одному из атрибутов. Это поле представляет собой включающую операцию разъединения/ИЛИ в каждом VehicleAttributeList и операцию объединения/И в коллекции VehicleAttributeList . Каждая повторяющаяся строка должна иметь формат «ключ1:значение1|ключ2:значение2|ключ3:значение3».

string

requiredOneOfAttributeSets предоставляет дополнительные функциональные возможности.

Подобно requiredOneOfAttributes , requiredOneOfAttributeSets использует сообщение, которое разрешает создание списка списков, допуская такие выражения, как это:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(
  (requiredOneOfAttributeSets[0][0] AND
  requiredOneOfAttributeSets[0][1] AND
  ...)
  OR
  (requiredOneOfAttributeSets[1][0] AND
  requiredOneOfAttributeSets[1][1] AND
  ...)
)

Ограничивает ответ транспортными средствами, которые соответствуют всем атрибутам в VehicleAttributeList . В каждом списке транспортное средство должно соответствовать всем атрибутам. Это поле представляет собой операцию соединения/И в каждом VehicleAttributeList и инклюзивную операцию разъединения/ИЛИ в коллекции VehicleAttributeList . Каждая повторяющаяся строка должна иметь формат «ключ1:значение1|ключ2:значение2|ключ3:значение3».

enum ( VehicleState )

Ограничивает ответ транспортными средствами, имеющими это состояние.

boolean

Возвращайте только автомобили с текущей поездкой(ями).

string

Необязательный. Запрос-фильтр, применяемый при перечислении транспортных средств. См. http://aip.dev/160 для примеров синтаксиса фильтра.

Это поле предназначено для замены полей requiredAttributes , requiredOneOfAttributes и required_one_of_attributes_sets . Если здесь указано непустое значение, следующие поля должны быть пустыми: requiredAttributes , requiredOneOfAttributes и required_one_of_attributes_sets .

Этот фильтр работает как предложение AND с другими ограничениями, такими как vehicleState или onTripOnly .

Обратите внимание, что поддерживаются только запросы по атрибутам транспортного средства (например, attributes.<key> = <value> или attributes.<key1> = <value1> AND attributes.<key2> = <value2> ). Максимальное количество ограничений, разрешенное в запросе фильтра, — 50.

Кроме того, все атрибуты хранятся в виде строк, поэтому единственным поддерживаемым сравнением атрибутов является сравнение строк. Для сравнения с числовыми или логическими значениями значения должны быть явно заключены в кавычки, чтобы их можно было рассматривать как строки (например, attributes.<key> = "10" или attributes.<key> = "true" ).

object ( Viewport )

Необязательный. Фильтр, который ограничивает количество транспортных средств, возвращаемых теми, чье последнее известное местоположение находилось в прямоугольной области, определенной окном просмотра.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object ( LatLng )

Необходимый. Нижняя точка смотрового окна.

object ( LatLng )

Необходимый. Самая высокая точка смотрового окна.