Go to documentation repository
이 검색 유형은 인식된 모든 얼굴을 카메라 데이터베이스의 모든 얼굴과 30일 동안 비교합니다(30일보다 짧은 기간인 경우 현재 아카이브 깊이에 따라 비교됨) 그리고 이 얼굴이 카메라에 의해 인식된 날짜 수를 설정합니다. 이 검색은 지정된 기준에 따라 이 얼굴이 "익숙한 얼굴"인지 "낯선 얼굴"인지 결정합니다.
검색을 시작하려면 POST 요청을 사용합니다(검색 요청 참조). 검색 유형은 "낯선 얼굴(stranger)"으로 설정되며 요청 본문은 비어 있습니다.
다음 매개변수가 사용 가능합니다.
파라미터 | 필수 | 설명 |
---|---|---|
accuracy | No | 얼굴 유사도 수준을 [0,1] 범위 내에서 설정합니다(1은 완전 일치를 의미). 이 매개변수가 설정되지 않으면 기본값(0.9)이 사용됩니다. 비교된 얼굴이 특정 날짜에 카메라의 시야에 있었고 지정된 유사도 수준 이상으로 인식되었다면, 해당 얼굴은 그 날짜에 존재한 것으로 간주됩니다. 그렇지 않으면, 알고리즘은 이 얼굴이 그 날짜에 존재하지 않았다고 판단합니다. |
This search type compares every recognized face with all faces in the camera database over 30 days (or for the current archive depth if it is less than 30 days) and sets the number of days over which this face was recognized by the camera. The search decides if this is a “familiar face” or a “stranger” by the specified criteria.
The POST request is used for search start (see 검색 요청), search type is stranger, request body is empty.
The following parameters are available:
Parameter | Required | Description | |||||
---|---|---|---|---|---|---|---|
accuracy | No | Sets face similarity level in the range [0,1] (1 means complete match). If this parameter is not set, then the default value (0.9) is in use. If the compared face was in the camera field of view on a specific day and it was recognized with accuracy that is not less than specified one, then this face is considered to be present on that day. Otherwise, the algorithm considers this face was absent on that day.
| |||||
threshold | No | Defines the threshold value to recognize a face as a “stranger”. The value is set in the range from 0 to 1 and it defines the number of days within which the face was absent to be considered as a “stranger”얼굴을 "낯선 얼굴"로 인식하기 위한 임계값을 정의합니다. 이 값은 0에서 1 사이로 설정되며, 얼굴이 "낯선 얼굴"로 간주되기 위한 결측 일수를 정의합니다: 30 - 30 * threshold임계값. For instance예를 들어, the value 0.8 means “the required object appeared in the search area within 0.8의 값은 "필요한 객체가 검색 영역 내에서 (30 - 30 * 0.8 = 6) days”. All faces that appeared within 6 and more days will be defined as “familiar faces”, others – as “strangers”일 이내에 나타났음을 의미합니다". 6일 이상 나타난 얼굴은 "익숙한 얼굴"로 정의되며, 그 외의 얼굴은 "낯선 얼굴"로 정의됩니다.
| |||||
op | No | Defines search direction검색 방향을 정의합니다. Allowable values허용 가능한 값: lt – “familiar face” search (based on threshold parameter). gt – “stranger” search."익숙한 얼굴" 검색 (임계값(threshold) 매개변수 기반) gt – "낯선 얼굴" 검색 |
샘플 요청Sample request:
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
Sample response샘플 응답:
Code Block |
---|
{ "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" } } |
Parameter파라미터 | Description설명명 | ||
---|---|---|---|
origin | Camera channel to take analyzed video stream from. | ||
timestamp | Time stamp of a frame with a face detected by the detection tool. | ||
분석된 비디오 스트림을 가져올 카메라 채널 | |||
timestamp | 얼굴 인식 도구로 얼굴이 감지된 프레임의 타임스탬프 | ||
rate | 얼굴이 "낯선 얼굴"로 인식될 확률, | rate | Rate of identifying a face as a “stranger”, the value in the [0,1] range. 1 means a complete stranger범위의 값. 1은 완전한 낯선 얼굴을 의미합니다. |
positionCoordinates of a frame border enclosing face on a video frame. | 비디오 프레임에서 얼굴을 둘러싸는 프레임 경계의 좌표 |