Отправка запросов в CARS API из CARS Analytics UI

В CARS Analytics предусмотрена возможность тестирования CARS API с помощью сервиса CARS API tester. Рекомендуемые параметры изображений приведены в Таблице 39.

Таблица 39. Рекомендуемые параметры изображений

Параметр	Требования
Разрешение	- Детекция ТС и ГРЗ: от 100x100 px до 1920х1080 px,
	- Распознавания атрибутов ГРЗ: от 20х50 px до 1920х1080px,
	- Распознавания атрибутов ТС: от 100х100 px до 1920х1080 px
Максимальный размер файла	3 Mb
Цвет изображения	Цветное или чёрно-белое изображение
Формат изображения	JPG или PNG
Композиция изображения	- ТС и ГРЗ должны быть видны полностью (не перекрыты другими объектами);
	- При распознавании атрибутов ТС на изображении не должно быть больше одного ТС;
	- ГРЗ должен занимать всю область изображения, при распознавании атрибутов ГРЗ

CARS API tester доступен по адресу:

http://<IP_адрес>:8080/cars_api_tester

Для входа используются данные учётной записи администратора CARS Analytics UI.

Доступно тестирование следующих запросов:

• Vehicle/License plate classify – запрос на определение атрибутов ТС и ГРЗ;
• Vehicle/License plate detect – запрос на детектирование ТС и ГРЗ;
• Vehicle frame processing – запрос на обработку кадра;
• Animal detect – запрос на детектирование животных;
• Smoke/Fire detect – запрос на обнаружение дыма и/или огня.

Детальное описание параметров доступных запросов представлено в файле /docs/API/rus/API_Reference_Manual.html в составе документации.

Интерфейс CARS API tester (Рисунок 9). Описание элементов интерфейса представлено в Таблице 40.

Таблица 40. Описание элементов интерфейса

№	Описание
1	IP адрес сервера тестируемого CARS API. IP адрес задается на этапе установки. Подробнее об установке CARS API и CARS Analytics см. «LUNA CARS. Руководство по установке»
2	Версия CARS API
3	Список основных доступных классификаторов. Подробнее о классификаторах см. в «CARS API. Руководство администратора»
4	Список доступных детекторов. Подробнее о детекторах см. в «CARS API. Руководство администратора»
5	Выбор типа запроса:
	- Vehicle/License plate classify
	- Vehicle/License plate detect
	- Vehicle frame processing
	- Animal detect
	- Smoke/Fire detect

Отправка запроса Vehicle/License plate classify

Запрос Vehicle/License plate classify позволяет определять атрибуты ТС и ГРЗ с использованием классификатора.

Интерфейс запроса Vehicle/License plate classify (Рисунок 10).

Алгоритм отправки запроса приведен в Таблице 41.

Таблица 41. Описание элементов запроса Vehicle/License plate classify

№	Описание
1	Поля для загрузки изображений ТС или ГРЗ. Необходимо нажать и выбрать изображение в появившимся окне проводника. Изображения должны соответствовать требованиям (Таблица 39). Для сброса изображения необходимо нажать на справа от загруженного изображения
2	Список классификаторов, которыми необходимо обработать изображения. Для отправки запроса должен быть выбран хотя бы один классификатор для каждого загруженного изображения.
3	Подтверждение отправки запроса. Для отправки запроса нажмите кнопку «Send!».
4	Результат обработки изображений. Результат выводится в виде списка значений результатов обработки изображения при помощи классификаторов. По умолчанию результаты скрыты, для просмотра данных обработки каждого классификатора необходимо нажать на в строке названия классификатора. Список всех доступных классификаторов и их описание см. в документации LUNA CARS API Руководство администратора.

Отправка запроса Vehicle/License plate detect

Запрос Vehicle/License plate detect детектирует на изображении все ТС и ГРЗ. В ответ возвращаются атрибуты детектированных объектов (координаты и размеры BBox).

Интерфейс запроса Vehicle/License plate detect (Рисунок 11).

Алгоритм отправки запроса приведен в Таблице 42.

Таблица 42. Описание элементов запроса Vehicle/License plate detect

№	Описание
1	Поле для загрузки изображения. Необходимо нажать и выбрать изображение в появившимся окне проводника. Изображения должны соответствовать требованиям (Таблица 39). Количество ТС и ГРЗ на одном изображении неограниченно. Для сброса изображения необходимо нажать на справа от загруженного изображения.
2	Список детекторов, которыми необходимо обработать изображение:
	- car – детектор ТС;
	- grz – детектор ГРЗ.
	Для отправки запроса должен быть выбран хотя бы один детектор.
3	Подтверждение отправки запроса. Для отправки запроса нажмите кнопку «Send!». При необходимости отобразить BBox на изображении в ответе установите флаг «Visualize detectrs».
4	Результат обработки изображений. Результат выводится в виде списка значений результатов обработки изображения при помощи детектора (детекторов). По умолчанию результаты скрыты, для просмотра данных обработки изображения каждым детектором необходимо нажать на в строке названия детектора. Примеры отображения результатов выполнения запроса Vehicle/License plate detect и обработки изображения при помощи детекторов представлены на Рисунках 12 и 13.Ответ на запрос включает в себя информацию по каждому детектированному ТС и/или ГРЗ и визуализацию:
	- координаты BBox;
	- исходное изображение с BBox на каждом детектированном ТС или ГРЗ;
	- миниатюры детектированных ТС или ГРЗ.
	При нажатии на изображение система предложит сохранить изображение.

Пример результата обработки изображения детектором ТС в результате выполнения запроса Vehicle/License plate detect (Рисунок 12).

Пример результата обработки изображения детектором ГРЗ в результате выполнения запроса Vehicle/License plate detect (Рисунок 13).

Отправка запроса Vehicle frame processing

Запрос Vehicle frame processing эмулирует работу CARS API для одного изображения. В результате выполнения этого запроса в CARS Analytics будет создано событие по входному изображению. Обработка изображения происходит с применением всех классификаторов и детекторов.

Интерфейс формирования запроса Vehicle frame processing (Рисунок 14).

Алгоритм отправки запроса приведен в Таблице 43.

Таблица 43. Описание параметров запроса Vehicle frame processing

№	Описание
1	Поле для загрузки изображения. Необходимо нажать и выбрать изображение в появившимся окне проводника. Изображения должны соответствовать требованиям (Таблица 39). Количество ТС и ГРЗ на одном изображении неограниченно. Для сброса изображения необходимо нажать на справа от загруженного изображения. При активации флага «Save as Event» результат выполнения запроса будет сохраняться как событие (оно будет отображено в разделе «События» пользовательского интерфейса CARS Analytics UI). При активации флага «Detect License plate only» будет произведена детекция только для ГРЗ с последующим распознаванием атрибутов ГРЗ.
2	Имя камеры. Необходимо указать название камеры. Это название будет передаваться в CARS Analytics в качестве названия источника, зафиксировавшего событие.
3	Подтверждение отправки запроса. Для отправки запроса нажмите кнопку «Send!».
4	Результат обработки изображения. Результат выводится в виде списка результатов обработки изображения при помощи классификаторов и детекторов, который содержит все детектированные объекты. Пример отображения результатов выполнения запроса Vehicle frame processing и обработки изображения при помощи классификаторов и детекторов (Рисунок 15). По умолчанию результаты скрыты, для просмотра каждого объекта необходимо нажать на в строке наименования детектированного объекта. Ответ на запрос включает в себя:
	- Изображение ТС c BBox вокруг ТС;
	- Миниатюры детектированных ТС и ГРЗ;
	- Сводную информацию по всем полученным атрибутам (Stream message);
	- Информацию по каждому классификатору:
	- car_brand_model_v2 – марку и модель ТС;
	- vehicle_type – тип ТС;
	- vehicle_emergency_type – принадлежность и тип экстренной службы;
	- vehicle_color – цвет ТС;
	- vehicle_descriptor_v2 – дескриптор ТС;
	- public_transport_type – тип общественного ТС;
	- special_transport_type – тип специальной техники;
	- vehicle_axles – координаты и количество осей ТС;
	- grz_all_countries – атрибуты ГРЗ.

Отправка запроса Animal detect

Запрос Animal detect позволяет детектировать животных на изображении с использованием детектора животных.

Интерфейс запроса Animal detect (Рисунок 16).

Алгоритм отправки запроса приведен в Таблице 44.

Таблица 44. Описание элементов запроса Animal detect

№	Описание
1	Поле для загрузки изображения. Необходимо нажать и выбрать изображение в появившимся окне проводника. Для сброса изображения необходимо нажать на справа от загруженного изображения
2	Подтверждение отправки запроса. Для отправки запроса нажмите кнопку «Send!».
3	Результат обработки изображения. Результат выводится в виде списка результатов обработки изображения при помощи детектора животных, который содержит все детектированные объекты. Пример отображения результатов выполнения запроса Animal detect (Рисунок 17). Ответ на запрос включает в себя:
	- Изображение животных выделенных BBox вокруг;
	- Миниатюры детектированных животных;
	- Сводную информацию по всем полученным атрибутам (Stream message);
	- Информацию детектора:
	- type – тип (big_animal, small_animal, bird).

Отправка запроса Smoke/Fire detect

Запрос Smoke/Fire detect позволяет обнаружить дым и/или огонь с использованием классификатора.

Интерфейс запроса Smoke/Fire detect (Рисунок 18).

Алгоритм отправки запроса приведен в Таблице 45.

Таблица 45. Описание элементов запроса Smoke/Fire detect

№	Описание
1	Поле для загрузки изображения. Необходимо нажать и выбрать изображение в появившимся окне проводника. Для сброса изображения необходимо нажать на справа от загруженного изображения
2	Настройка параметров разделения изображения на зоны. Детектор разделяет изображение на указанное количество зон по вертикали и горизонтали. В каждой зоне определяется наличие дыма или огня.
	- Number block of image in height – количество зон по вертикали;
	- Number block of image in width – количество зон по горизонтали;
3	Подтверждение отправки запроса. Для отправки запроса нажмите кнопку «Send!».
4	Результат обработки изображения. Выводится в виде списка результатов обработки изображения при помощи детектора дыма и/или огня, который содержит информацию о всех зонах наличии в них возгорания. Пример отображения результатов выполнения запроса Smoke/Fire detect (Рисунок 19). Ответ на запрос включает в себя:
	- Изображение c информацией о типе возгорания в каждой зоне;
	- Миниатюры детектированных зон;
	- Сводную информацию по всем полученным атрибутам (Stream message);
	- Информацию детектора:
	- type – тип (fire - огонь; black_smoke - черный дым; white_smoke - белый дым; none - нет возгорания)

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