Данный тип поиска сравнивает каждое распознанное лицо со всеми лицами в базе данных одной видеокамеры за 30 дней (или за текущую глубина архива, если она меньше 30 дней) и устанавливает количество дней, в которых искомое лицо было зафиксировано видеокамерой. По заданным критериям поиск определяет искомое лицо "своим" или "чужим".
Для запуска поиска используется POST запрос (см. Запрос на поиск), тип поиска stranger, тело запроса пустое.
При этом доступны следующие параметры:
- accuracy - позволяет задать степень похожести лица в диапазоне от 0 до 1 (1 - полное совпадение). В случае отсутствия параметра будет использовано значение по умолчанию: 0.9. Если сравниваемое лицо попадало в поле зрения видеокамеры в определенный день и было распознано с точностью, не менее указанной, то считается, что данное лицо в этот день присутствовало. В противном случае, алгоритм считает, что данное лицо в этот день отсутствовало.
- treshold - определяет пороговую величину для принятия лица "чужим". Значение задается в диапазоне от 0 до 1 и определяет необходимое число дней, в который искомое лицо отсутствовало, чтобы считаться "чужим" по следующей формуле: 30-30*treshold. Например, значение 0.8 можно интерпретировать как "искомый объект появлялся в области поиска в течении (30 - 30 * 0.8 = 6) дней". Все лица, которые появлялись 6 и более дней будут определяться как "свои", остальные - как "чужие",
- op - определяет направление операции поиска.
Допустимые значения:
lt - поиск "своих" лиц (исходя из определения параметром treshold).
gt - поиск "чужих" лиц.
Внимание!
Параметры treshold и op должны использоваться в только связке. Если любой из параметров не задан или содержит некорректное значение, оба будут проигнорированы.
Результатом поиска является JSON следующего вида:
{ "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 - координаты рамки, определяющей положение лица на кадре