Распознавание¶
REST API v2 предоставляет улучшенные возможности для настройки и управления процессом распознавания товаров, включая гибкие настройки скорости, режимов обучения и обратной связи.
Установка скорости распознавания¶
Установить скорость распознавания (чем быстрее, тем ниже точность распознавания). Скорость может быть normal или fast. fast аналогична предыдущей версии. normal медленнее предыдущей, но дает лучший результат распознавания. По умолчанию fast.
URL интерфейса: http://172.22.0.6/api/set_predict_speed
Метод запроса: POST
Content-Type: json
Параметры тела запроса
{
"speed": "normal"
}
Параметр |
Пример значения |
Тип |
Обязательно ? |
Описание |
|---|---|---|---|---|
speed |
normal |
String |
Да |
Скорость распознавания |
Пример успешного ответа
{
"code": 0,
"data": null
}
Параметр |
Пример значения |
Тип |
Описание |
|---|---|---|---|
code |
0 |
Number |
Код результата: 0 - успех |
data |
— |
Null |
— |
Получение результата распознавания¶
Получить результат распознавания на основе текущего изображения камеры.
URL интерфейса: http://172.22.0.6/api/get_result
Метод запроса: GET
Content-Type: none
Пример успешного ответа
{
"code": 0,
"data": {
"items": [
{
"id": "002",
"score": 0.29
},
{
"id": "003",
"score": 0.28
},
{
"id": "001",
"score": 0.25
},
{
"id": "004",
"score": 0.18
}
],
"sid": "19700101082633041672962"
}
}
Параметр |
Пример значения |
Тип |
Описание |
|---|---|---|---|
code |
0 |
Number |
Код результата: 0 - успех |
data.items |
— |
Array |
Список PLU и оценок |
data.sid |
19700101082633041672962 |
String |
ID этого распознавания |
Установка максимального количества результатов¶
Установить максимальное количество результатов за одно распознавание, от 1 до 5.
URL интерфейса: http://172.22.0.6/api/set_max_result
Метод запроса: POST
Content-Type: json
Параметры тела запроса
{
"num": 3
}
Параметр |
Пример значения |
Тип |
Обязательно ? |
Описание |
|---|---|---|---|---|
num |
3 |
Number |
Да |
Максимальное количество результатов |
Пример успешного ответа
{
"code": 0,
"data": null
}
Параметр |
Пример значения |
Тип |
Описание |
|---|---|---|---|
code |
0 |
Number |
Код результата: 0 - успех |
data |
— |
Null |
— |
Отзыв о результате распознавания¶
Передать результаты распознавания модулю распознавания для самообучения. Функция имеет 3 варианта, которые можно установить через set_learnmode:
disabled : не влияет на модуль распознавания limited : только оптимизирует точность распознавания товара, не добавляя новые шаблоны full : оптимизирует точность распознавания товара и добавляет новые шаблоны при необходимости
URL интерфейса: http://172.22.0.6/api/result_feedback
Метод запроса: POST
Content-Type: json
Параметры тела запроса
{
"sid": "19700101082633041672962",
"id": "001"
}
Параметр |
Пример значения |
Тип |
Обязательно? |
Описание |
|---|---|---|---|---|
sid |
19700101082633041672962 |
String |
Да |
ID распознавания, возвращенный get_result |
id |
001 |
String |
Да |
PLU товара, выбранный пользователем |
Пример успешного ответа
{
"code": 0,
"data": null
}
Параметр |
Пример значения |
Тип |
Описание |
|---|---|---|---|
code |
0 |
Number |
Код результата: 0 - успех |
data |
— |
Null |
— |
Установка режима обучения¶
Установить режим обучения. Модуль распознавания имеет два способа улучшения производительности распознавания: add/delete_item_template и result_feedback. Эта опция может устанавливать их в различные режимы.
Режимы обучения:
0: отключает и add/delete_item_template, и result_feedback 1: включает add/delete_item_template и устанавливает полную функциональность result_feedback 2: включает add/delete_item_template и устанавливает ограниченную функциональность result_feedback
URL интерфейса: http://172.22.0.6/api/set_learnmode
Метод запроса: POST
Content-Type: json
Параметры тела запроса
{
"mode": 1
}
Параметр |
Пример значения |
Тип |
Обязательно ? |
Описание |
|---|---|---|---|---|
mode |
1 |
Number |
Да |
Режим обучения, допустимы значения 0, 1, 2 |
Пример успешного ответа
{
"code": 0,
"data": null
}
Параметр |
Пример значения |
Тип |
Описание |
|---|---|---|---|
code |
0 |
Number |
Код результата: 0 - успех |
data |
— |
Null |
— |
Проверка настроек режима обучения¶
Проверить настройки режима обучения.
URL интерфейса: http://172.22.0.6/api/get_learnmode
Метод запроса: GET
Content-Type: none
Пример успешного ответа
{
"code": 0,
"data": {
"mode": 1
}
}
Параметр |
Пример значения |
Тип |
Описание |
|---|---|---|---|
code |
0 |
Number |
Код результата: 0 - успех |
data.mode |
1 |
Number |
Режим обучения, допустимы значения 0, 1, 2. По умолчанию 1 |