"Familiar face"-"stranger" face search API

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 request), 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 FOV on a specific day and it was recognized with accuracy that is not less than the specified one, then this face is considered to be present on that day. Otherwise, the algorithm considers this face was absent on that day. Attention! 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.
threshold	No	Determines the threshold value to recognize a face as a “stranger”. The value is set in the range from 0 to 1, and it determines the number of days within which the face was absent to be considered as a “stranger”: 30-30threshold. For instance, the value 0.8 means “the required object appeared in the search area within (30 - 30 0.8 = 6) days”. All faces that appeared within 6 and more days will be defined as “familiar faces”, others—as “strangers”. Attention! The threshold and op parameters must only be used together. If any of parameters is not set or has incorrect value, then both parameters will be ignored.
op	No	Determines the search direction. Allowable values: lt—“familiar face” search (based on the threshold parameter) gt—“stranger” search

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:

{
   "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 from which the video stream is received for analysis
timestamp	Time stamp of a frame with a face detected by the detection tool
rate	Rate of identifying a face as a “stranger”, the value in the [0,1] range. 1 means a complete stranger
position	Coordinates of a frame border enclosing face on a video frame

Page tree

Documentation for Axxon One 1.0.