Spec-Zone.ru › AWS CLI v2

[ aws . location ]

batch-evaluate-geofences

Описание

Оценивает позиции устройств по геозонам, взятым из заданного набора геозон.

Этот оператор всегда возвращает пустой ответ, потому что оценка геозон выполняется асинхронно. Оценка определяет, вошёл ли или вышел ли аппарат из области геозоны, и затем публикует одно из следующих событий в Amazon EventBridge:

  • ENTER если Amazon Location определил, что отслеживаемое устройство вошло в зону геозоны.
  • EXIT если Amazon Location определил, что отслеживаемое устройство вышло из зоны геозоны.

Примечание

Последняя геозона, в которой наблюдалось устройство, отслеживается в течение 30 дней после последнего обновления позиции устройства.

Примечание

Оценка геозон использует заданную позицию устройства. Она не учитывает необязательный Accuracy устройства DevicePositionUpdate.

Примечание

DeviceID используется в качестве строки для представления устройства. Вам не нужно иметь Tracker, связанную с DeviceID.

См. также: Документация AWS API

Синтаксис

  batch-evaluate-geofences
--collection-name <value>
--device-position-updates <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--collection-name (строка)

Набор геозон, используемый для оценки позиции устройств по отношению к его геозонам.

--device-position-updates (список)

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

(структура)

Содержит детали обновления позиции устройства.

DeviceId -> (строка)

Устройство, связанное с обновлением позиции.

SampleTime -> (временная метка)

Временная метка, в которой была определена позиция устройства. Используется формат ISO 8601: YYYY-MM-DDThh:mm:ss.sssZ

Position -> (список)

Последняя позиция устройства, определённая в формате WGS 84: [X or longitude, Y or latitude] .

(двойное)

Accuracy -> (структура)

Точность позиции устройства.

Horizontal -> (двойное)

Предполагаемое максимальное расстояние, в метрах, между измеренной позицией и фактической позицией устройства вдоль поверхности Земли.

PositionProperties -> (словарь)

Связывает одно или несколько свойств с обновлением позиции. Свойство представляет собой пару «ключ-значение», хранящуюся с обновлением позиции и добавляемую в любое событие геозоны, которое может быть вызвано обновлением.

Формат: "key" : "value"

key -> (строка)

value -> (строка)

Упрощённый синтаксис:

DeviceId=string,SampleTime=timestamp,Position=double,double,Accuracy={Horizontal=double},PositionProperties={KeyName1=string,KeyName2=string} ...

Синтаксис JSON:

[
  {
    "DeviceId": "string",
    "SampleTime": timestamp,
    "Position": [double, ...],
    "Accuracy": {
      "Horizontal": double
    },
    "PositionProperties": {"string": "string"
      ...}
  }
  ...
]

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставляются в командной строке, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет интерпретироваться буквально. Это может не быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод без отправки запроса к API. При отсутствии значения или значении input выводит пример входного JSON, который может быть использован как аргумент для --cli-input-json. Аналогично, если указано yaml-input, будет напечатан образец входного YAML, который может быть использован с --cli-input-yaml. Если указано значение output, оно валидирует входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный каркас JSON не является стабильным между версиями AWS CLI, и нет гарантии обратной совместимости в сгенерированном JSON-каркасе.

Глобальные параметры

--debug (логическое)

Включить отладочную регистрацию.

--endpoint-url (строка)

Переопределить значение по умолчанию URL-адреса команды на указанный URL.

--no-verify-ssl (логическое)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (логическое)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

  • json
  • text
  • таблица
  • yaml
  • yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из вашего файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/отключить цветной вывод.

  • включить
  • выключить
  • автоматически

--no-sign-request (логическое)

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

--ca-bundle (строка)

Файл с набором сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут представлены как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и использовать содержимое файла непосредственно независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое)

Отключить пагинатор cli для вывода.

--cli-auto-prompt (логическое)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (логическое)

Отключить автоматический запрос параметров ввода CLI.

Вывод

Errors -> (список)

Содержит сведения об ошибках для каждого устройства, которое не смогло оценить свою позицию по отношению к заданному набору геозон.

(структура)

Содержит сведения об ошибках для каждого устройства, которое не смогло оценить свою позицию по отношению к геозонам в данном наборе геозон.

DeviceId -> (строка)

Устройство, связанное с ошибкой оценки позиции.

SampleTime -> (временная метка)

Указывает временную метку момента возникновения ошибки в формате ISO 8601: YYYY-MM-DDThh:mm:ss.sssZ

Error -> (структура)

Содержит данные, связанные с ошибкой пакетного запроса.

Code -> (строка)

Код ошибки, связанный с ошибкой пакетного запроса.

Message -> (строка)

Сообщение с причиной ошибки пакетного запроса.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API