[ aws . rekognition ]
detect-protective-equipment
Описание
Обнаруживает средства индивидуальной защиты (СИЗ), которые носят люди, обнаруженные на изображении. Amazon Rekognition может обнаруживать следующие типы СИЗ:
- Защита лица
- Защита рук
- Защита головы
Вы передаёте входное изображение в виде закодированных байтами base64 изображения или ссылкой на изображение в ведре Amazon S3. Изображение должно быть в формате PNG или JPG.
DetectProtectiveEquipment обнаруживает СИЗ, носимые до 15 человек, обнаруженных на изображении.Для каждого человека, обнаруженного на изображении, API возвращает массив частей тела (лицо, голова, левая рука, правая рука). Для каждой части тела возвращается массив обнаруженных элементов СИЗ, включая индикатор того, покрывает ли СИЗ эту часть тела. API возвращает уверенность в каждом обнаружении (человек, СИЗ, часть тела и покрытие части тела). Также возвращается прямоугольник ( BoundingBox ) для каждого обнаруженного человека и каждого обнаруженного элемента СИЗ.
Вы можете дополнительно запросить сводку обнаруженных элементов СИЗ с помощью параметра ввода SummarizationAttributes. Сводка содержит следующую информацию:
- Люди, обнаруженные как носители всех типов СИЗ, которые вы указали.
- Люди, обнаруженные как не носители всех типов СИЗ, которые вы указали.
- Люди, обнаруженные, где невозможно определить наличие СИЗ.
Эта операция API является бессостоятельной. То есть, она не сохраняет никакие данные.
Для этой операции необходимы разрешения на выполнение действия rekognition:DetectProtectiveEquipment.
См. также: Документацию API AWS
Синтаксис
detect-protective-equipment
[--image <value>]
[--summarization-attributes <value>]
[--image-bytes <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]
Параметры
--image (структура)
Изображение, на котором вы хотите обнаружить СИЗ на обнаруженных людях. Изображение можно передать в виде байтов изображения или вы можете указать ссылку на изображение, хранящееся в ведре Amazon S3.
Для указания локального файла используйте --image-bytes.
Байты -> (блоб)
DetectCustomLabels, составляет 4 МБ.S3Object -> (структура)
Идентифицирует объект S3 как источник изображения.
Bucket -> (строка)
Name -> (строка)
Version -> (строка)
Сокращённый синтаксис:
Bytes=blob,S3Object={Bucket=string,Name=string,Version=string}
Синтаксис JSON:
{
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
--summarization-attributes (структура)
Массив типов СИЗ, сводку которых вы хотите получить.
MinConfidence -> (вещественное число)
Минимальный уровень уверенности, для которого вы хотите получить сводку. Уровень уверенности относится к обнаружению человека, обнаружению части тела, обнаружению оборудования и покрытию части тела. Amazon Rekognition не возвращает сводку с уверенностью ниже этого значения. Значения по умолчанию нет.
Укажите значение MinConfidence, которое находится в диапазоне от 50 до 100%, так как DetectProtectiveEquipment возвращает прогнозы только там, где уверенность в обнаружении находится в диапазоне от 50% до 100%. Если вы укажете значение меньше 50%, результаты будут такими же, как при указании значения 50%.
RequiredEquipmentTypes -> (список)
Массив типов средств индивидуальной защиты, для которых вы хотите получить сводку. Если человек обнаружен как носящий требуемый тип СИЗ, идентификатор человека добавляется в поле PersonsWithRequiredEquipment массива DetectProtectiveEquipment.
(строка)
Сокращённый синтаксис:
MinConfidence=float,RequiredEquipmentTypes=string,string
Синтаксис JSON:
{
"MinConfidence": float,
"RequiredEquipmentTypes": ["FACE_COVER"|"HAND_COVER"|"HEAD_COVER", ...]
}
--image-bytes (блоб)
--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
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из файла аутентификации.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить вывод цвета.
- вкл
- выкл
- авто
--no-sign-request (булево)
Не подписывать запросы. Кредиты не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификата корневого центра, используемый для проверки сертификатов 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.
Вывод
ProtectiveEquipmentModelVersion -> (строка)
Люди -> (список)
Массив людей, обнаруженных на изображении (включая людей, не носящих СИЗ).
(структура)
Человек, обнаруженный с помощью вызова DetectProtectiveEquipment. API возвращает всех обнаруженных людей в массиве объектов ProtectiveEquipmentPerson.
Части тела -> (список)
Массив частей тела, обнаруженных на теле человека (включая части тела без СИЗ).
(структура)
Информация о части тела, обнаруженной DetectProtectiveEquipment, содержащей СИЗ. Для каждого обнаруженного человеком DetectProtectiveEquipment возвращается массив объектов ProtectiveEquipmentBodyPart.
Название -> (строка)
Доверие -> (число с плавающей запятой)
Обнаружения оборудования -> (список)
Массив обнаруженных элементов личной защитной экипировки (СИЗ) вокруг части тела.
(структура)
Информация об элементе личной защитной экипировки (СИЗ), обнаруженном с помощью DetectProtectiveEquipment. Для получения дополнительной информации см. DetectProtectiveEquipment.
Прямоугольник -> (структура)
Прямоугольник, окружающий обнаруженный элемент СИЗ.
Ширина -> (число с плавающей запятой)
Высота -> (число с плавающей запятой)
Левый -> (число с плавающей запятой)
Верхний -> (число с плавающей запятой)
Доверие -> (число с плавающей запятой)
BoundingBox) содержит элемент СИЗ.Тип -> (строка)
Покрывает часть тела -> (структура)
Информация о части тела, покрытой обнаруженным СИЗ.
Доверие -> (число с плавающей запятой)
Value.Значение -> (логическое)
Прямоугольник -> (структура)
Прямоугольник вокруг обнаруженного человека.
Ширина -> (число с плавающей запятой)
Высота -> (число с плавающей запятой)
Левый -> (число с плавающей запятой)
Верхний -> (число с плавающей запятой)
Доверие -> (число с плавающей запятой)
Id -> (целое число)
DetectProtectiveEquipment.Сводка -> (структура)
Сводная информация о типах СИЗ, указанных в параметре ввода SummarizationAttributes.
ЛюдиСНеобходимымОборудованием -> (список)
Массив идентификаторов людей, которые носят обнаруженное личное защитное снаряжение.
(целое число)
ЛюдиБезНеобходимогоОборудования -> (список)
Массив идентификаторов людей, которые не носят все типы СИЗ, указанные в поле RequiredEquipmentTypes обнаруженного личного защитного снаряжения.
(целое число)
НеопределенныеЛюди -> (список)
Массив идентификаторов людей, для которых невозможно определить, носят ли они личное защитное снаряжение.
(целое число)
© Copyright 2025, Amazon Web Services. Created using Sphinx.