...
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 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. |
Important | 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 |
Defines Determines the threshold value to recognize a face as a “stranger”. The value is set in the range from 0 to 1, and it |
defines determines the number of days within which the face was absent to be considered as a “stranger”: 30-30*threshold. 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 |
– Important parameters should 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 |
Defines Determines the search direction.
Allowable values:
lt |
– | —“familiar face” search (based on the threshold parameter) |
. – “stranger” .Sample request:
POST http://127.0.0.1:80/search/stranger/SERVER1/AVDetector.2/EventSupplier/past/future?accuracy=0.7
...
| 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 | from which the video stream |
from.| 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 |
.
