API Face search

The POST request (see Search request) used to start a search must contain binary data that contains a JPEG image of the searched face.

Note

All events from the face detection tools are stored in the t_json_event table in the database.
The t_face_vector table stores the vectors of faces recognized by the detection tool.
The t_face_listed table stores the face images added to the list of faces (see Faces).

Parameter	Required	Description
accuracy	No	In the search string or in the body of the request, the accuracy parameter is additionally specified. The accuracy parameter is a recognition accuracy in the range [0, 1] (1—complete match). If you don't specify this parameter, default value 0.9 is used Attention! The parameter value specified in the request body has a higher priority.

Attention!

If the body of the POST request is empty, then the search returns all results for the recognized faces. The value of the accuracy parameter in this case is 0.

Request example:

POST http://127.0.0.1:80/search/face/SERVER1/AVDetector.2/EventSupplier/past/future?accuracy=0.7

GET http://127.0.0.1:80/search/face/2e69ba76-23f1-4d07-a812-fee86e994b8e/result

Response example:

{
   "events" : [
      {
         "accuracy" : 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"
      },
      {
         "accuracy" : 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	Сamera channel from which the video stream is received for analysis
timestamp	Time stamp of a frame in which the detection tool detected a face
accuracy	Recognition accuracy in the range [0; 1], 1—complete match
position	Coordinates of the border that defines the position of the face in the frame

Page tree

Documentation for Axxon One 2.0. Documentation for other versions of Axxon One is available too.