Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

이 검색 유형은 인식된 모든 얼굴을 카메라 데이터베이스의 모든 얼굴과 30일 동안 비교합니다(30일보다 짧은 기간인 경우 현재 아카이브 깊이에 따라 비교됨) 그리고 이 얼굴이 카메라에 의해 인식된 날짜 수를 설정합니다. 이 검색은 지정된 기준에 따라 이 얼굴이 "익숙한 얼굴"인지 "낯선 얼굴"인지 결정합니다.

검색을 시작하려면 POST 요청을 사용합니다(검색 요청 참조). 검색 유형은 "낯선 얼굴(stranger)"으로 설정되며 요청 본문은 비어 있습니다.

다음 매개변수가 사용 가능합니다.

파라미터필수설명
accuracyNo

얼굴 유사도 수준을 [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:

ParameterRequiredDescription
accuracyNo

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. 

Note
titleImportant!

The accuracy parameter value can also be specified in the request body. In this case, it has higher priority over the value specified in the search line정확도 매개변수 값은 요청 본문에 지정할 수도 있습니다. 이 경우, 본문에 지정된 값이 검색 라인에서 지정된 값보다 우선 적용됩니다.


thresholdNo

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일 이상 나타난 얼굴은 "익숙한 얼굴"로 정의되며, 그 외의 얼굴은 "낯선 얼굴"로 정의됩니다.

Note
titleImportant!

The threshold and op parameters should only be used together. If any of parameters is not set or has incorrect value, then both parameters will be ignored임계값(threshold)과 연산자(op) 매개변수는 단독으로 사용될 수 없으며 반드시 함께 사용해야 합니다. 두 매개변수 중 하나라도 설정되지 않거나 잘못된 값이 지정되면 두 매개변수 모두 무시됩니다.


opNoDefines 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설명명
originCamera channel to take analyzed video stream from.
timestampTime stamp of a frame with a face detected by the detection tool.
분석된 비디오 스트림을 가져올 카메라 채널
timestamp얼굴 인식 도구로 얼굴이 감지된 프레임의 타임스탬프
rate얼굴이 "낯선 얼굴"로 인식될 확률, rateRate 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.비디오 프레임에서 얼굴을 둘러싸는 프레임 경계의 좌표