Работа со списками для распознавания

Конфигурирование списков и данных для распознавания описывается в файле RealtimeRecognizer.proto.

Используется 4 метода:

1. ChangeLists
2. ChangeItems
3. GetLists
4. GetItems

Метод ChangeLists

Данный метод служит для добавления, редактирования и удаления списков.

Вводные данные

В качестве аргумента передается структура ChangeListsRequest, в которой заполняются 3 вектора входных данных:

1. added_lists - вектор списков для добавления;
2. changed_lists - вектор списков для изменения;
3. removed_list_ids - вектор id списков для удаления.

Сами списки представляют из себя структуру данных с полями:

1. id - id списка;
2. name - имя списка;
3. description - комментарии к списку;
4. score - минимальный уровень распознавания, по умолчанию 0,85;
5. item_ids - список id изображений, по которым происходит распознавание;
6. type - тип распознавания, ELT_Face - для лиц, ELT_LPR - для номеров авто, ELT_Food - для еды (блюд).

Выходные данные

В ответ на метод будет получен перечень id списков, которые не удалось добавить, отредактировать или удалить.

Метод ChangeItems

Данный метод служит для добавления, редактирования и удаления исходных данных для распознавателя.

Вводные данные

В качестве аргумента передается структура ChangeItemsRequest, в которой заполняются 3 вектора входных данных:

1. added_items - вектор данных для добавления;
2. changed_items - вектор данных для изменения;
3. removed_item_ids - вектор id данных для удаления.

Данные представляют из себя структуру с полями:

1. id - id данных;
2. name - имя данных;
3. description - комментарии к данным;
4. type - тип данных,  DT_ImageFace - для лиц, DT_Plate - для номеров авто, DT_ImagesFood- для еды (блюд);
5. data - сами данные, зависят от типа. Для лица - это одно изображение, для еды - это массив изображений, для номеров авто - это номер в виде текста.
6. data_vectors - вектор картинок (не заполняется).

Изображение имеет 2 поля: id изображения и само изображение.

Если при изменения, т.е. при формировании changed_items, заполнить только id изображения, то это будет означать, что изображение с этим id должно быть удалено из конфигурации.

Выходные данные

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

Метод GetLists

Данный метод выводит информацию о списках в конфигурации.

Вводные данные

В качестве аргумента передается структура GetListsRequest, в которой заполняются 2 поля:

1. list_ids - множество id списков, которые должны быть получены;
2. type - тип списков: ELT_Face, ELT_LPR, ELT_Food.

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

Выходные данные

В ответ на метод будет получен массив списков.

Метод GetItems

Данный метод выводит информацию о данных в конфигурации.

Вводные данные

В качестве аргумента передается структура GetItemsRequest, в которой заполняются 3 поля:

1. item_ids - множество id данных, которые должны быть получены;
2. load_images - флаг, указывающий необходимость вывода картинки вместе с ответом;
3. load_vectors - флаг, указывающий необходимость вывода вектора картинок.

Выходные данные

В ответ на метод будет получен массив данных.