The POST request (see Search request) used for search start must contain binary data of searched face in jpеg format.
The accuracy parameter is a recognition rate from range [0, 1] (1 – complete match). This parameter is specified additionally. Otherwise, the default value 0.9 will be used.
The search result is the following JSON response:
{ "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" } ] }
Parameters:
- origin is a camera channel to take analyzed video stream from.
- timestamp is a time stamp of a video frame with a face detected by the detection tool.
- accuracy is recognition accuracy ranged [0,1], with 1 corresponding to full match.
- position sets coordinates of a frame border enclosing face on a video frame.