Отправка запросов в 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.

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

Classify – запрос на определение атрибутов ТС и ГРЗ;
Detect – запрос на детектирование ТС и ГРЗ;
Frame prcessing – запрос на обработку кадра.

Детальное описание параметров доступных запросов представлено в файле /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	Выбор типа запроса:
	- Classify
	- Detect
	- Frame prcessing

Отправка запроса Classify#

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

Интерфейс запроса Classify (Рисунок 10). Алгоритм отправки запроса приведен в Таблице 41.

Рисунок 10. Интерфейс формирования запроса Classify

Таблица 41. Описание элементов запроса Classify

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

Отправка запроса Detect#

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

Интерфейс запроса Detect (Рисунок 11). Алгоритм отправки запроса приведен в Таблице 42.

Рисунок 11. Интерфейс формирования запроса Detect

Таблица 42. Описание элементов запроса Detect

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

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

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

Отправка запроса Frame prcessing#

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

Интерфейс формирования запроса Frame prcessing (Рисунок 14). Алгоритм отправки запроса приведен в Таблице 43.

Таблица 43. Описание параметров запроса Frame prcessing

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

Рисунок 15. Пример результата обработки изображения детекторами и классификаторами в результате выполнения запроса «Frame processing»