Go to documentation repository
Previous page Next page
이 검색 유형은 인식된 모든 얼굴을 카메라 데이터베이스의 모든 얼굴과 30일 동안 비교합니다(30일보다 짧은 기간인 경우 현재 아카이브 깊이에 따라 비교됨) 그리고 이 얼굴이 카메라에 의해 인식된 날짜 수를 설정합니다. 이 검색은 지정된 기준에 따라 이 얼굴이 "익숙한 얼굴"인지 "낯선 얼굴"인지 결정합니다.
검색을 시작하려면 POST 요청을 사용합니다(검색 요청 참조). 검색 유형은 "낯선 얼굴(stranger)"으로 설정되며 요청 본문은 비어 있습니다.
다음 매개변수가 사용 가능합니다.
파라미터 | 필수 | 설명 |
---|---|---|
accuracy | No | 얼굴 유사도 수준을 [0,1] 범위 내에서 설정합니다(1은 완전 일치를 의미). 이 매개변수가 설정되지 않으면 기본값(0.9)이 사용됩니다. 비교된 얼굴이 특정 날짜에 카메라의 시야에 있었고 지정된 유사도 수준 이상으로 인식되었다면, 해당 얼굴은 그 날짜에 존재한 것으로 간주됩니다. 그렇지 않으면, 알고리즘은 이 얼굴이 그 날짜에 존재하지 않았다고 판단합니다. Important! 정확도 매개변수 값은 요청 본문에 지정할 수도 있습니다. 이 경우, 본문에 지정된 값이 검색 라인에서 지정된 값보다 우선 적용됩니다. |
threshold | No | 얼굴을 "낯선 얼굴"로 인식하기 위한 임계값을 정의합니다. 이 값은 0에서 1 사이로 설정되며, 얼굴이 "낯선 얼굴"로 간주되기 위한 결측 일수를 정의합니다: 30 - 30 * 임계값. 예를 들어, 0.8의 값은 "필요한 객체가 검색 영역 내에서 (30 - 30 * 0.8 = 6)일 이내에 나타났음을 의미합니다". 6일 이상 나타난 얼굴은 "익숙한 얼굴"로 정의되며, 그 외의 얼굴은 "낯선 얼굴"로 정의됩니다. Important! 임계값(threshold)과 연산자(op) 매개변수는 단독으로 사용될 수 없으며 반드시 함께 사용해야 합니다. 두 매개변수 중 하나라도 설정되지 않거나 잘못된 값이 지정되면 두 매개변수 모두 무시됩니다. |
op | No | 검색 방향을 정의합니다. 허용 가능한 값: lt – "익숙한 얼굴" 검색 (임계값(threshold) 매개변수 기반) 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 | 비디오 프레임에서 얼굴을 둘러싸는 프레임 경계의 좌표 |