Документация для версии Axxon Next 4.5.0 - 4.5.10. Документация на другие версии также доступна.

Предыдущая страница API Поиск по лицам  Определение признака Следующая страница

Данный тип поиска сравнивает каждое распознанное лицо со всеми лицами в базе данных одной видеокамеры за 30 дней (или за текущую глубина архива, если она меньше 30 дней) и устанавливает количество дней, в которых искомое лицо было зафиксировано видеокамерой. По заданным критериям поиск определяет искомое лицо "своим" или "чужим".

Для запуска поиска используется POST запрос (см. Запрос на поиск), тип поиска stranger, тело запроса пустое.

При этом доступны следующие параметры:

ПараметрОбязательныйОписание
accuracyНет

Позволяет задать степень похожести лица в диапазоне от 0 до 1 (1 - полное совпадение). В случае отсутствия параметра будет использовано значение по умолчанию: 0.9. Если сравниваемое лицо попадало в поле зрения видеокамеры в определенный день и было распознано с точностью, не менее указанной, то считается, что данное лицо в этот день присутствовало. В противном случае, алгоритм считает, что данное лицо в этот день отсутствовало. 

Внимание!

Параметр accuracy  также можно использовать в теле запроса (начиная с версии 4.3.0.7914). При этом именно значение в теле будет иметь приоритет.

tresholdНет

Определяет пороговую величину для принятия лица "чужим".  Значение задается в диапазоне от 0 до 1 и определяет необходимое число дней, в который искомое лицо отсутствовало, чтобы считаться "чужим" по следующей формуле: 30-30*treshold. Например, значение 0.8 можно интерпретировать как "искомый объект появлялся в области поиска в течении (30 - 30 * 0.8 = 6) дней". Все лица, которые появлялись 6 и более дней будут определяться как "свои", остальные - как "чужие".

Внимание!

Параметры treshold и op должны использоваться в только связке. Если любой из параметров не задан или содержит некорректное значение, оба будут проигнорированы.

opНет

Определяет направление операции поиска.
Допустимые значения:
lt - поиск "своих" лиц (исходя из определения параметром treshold).
gt - поиск "чужих" лиц.

Пример запроса:

POST http://127.0.0.1:80/search/stranger/SERVER1/AVDetector.2/EventSupplier/past/future?accuracy=0.7

GET http://127.0.0.1:80/search/stranger/2e69ba76-23f1-4d07-a812-fee86e994b8e/result

Пример ответа:

{
   "events" : [
      {
         "rate" : 0.90591877698898315,
         "origin" : "hosts/SERVER1/DeviceIpint.2/SourceEndpoint.video:0:0",
         "position" : {
            "bottom" : 0.10694444444444445,
            "left" : 0.69687500000000002,
            "right" : 0.74687500000000007,
            "top" : 0.018055555555555554
         },
         "timestamp" : "20160914T085307.499000"
      },
      {
         "rate" : 0.90591877698898315,
         "origin" : "hosts/SERVER1/DeviceIpint.2/SourceEndpoint.video:0:0",
         "position" : {
            "bottom" : 0.10694444444444445,
            "left" : 0.69687500000000002,
            "right" : 0.74687500000000007,
            "top" : 0.018055555555555554
         },
         "timestamp" : "20160914T085830.392000"
      }
}
ПараметрОписание
originКанал камеры с которого поступает видео поток для анализа.
timestampВремя кадра, на котором детектор обнаружил лицо.
rate

Коэффициент принятия лица "чужим", значение в диапазоне [0,1].  1 - максимально "чужое" лицо.

positionКоординаты рамки, определяющей положение лица на кадре.
  • No labels