Go to documentation repository
Page History
Ten typ wyszukiwania porównuje każdą rozpoznaną twarz do wszystkich twarzy w bazie danych wykrytych przez 30 ostatnich dni (lub dla obecnej głębokości archiwum, jeśli jest ona krótsza niż 30 dni) oraz ustala liczbę dni, dla których twarz została wykryta na obrazie wideo dla kamery. Wyszukiwanie ustala, czy dana twarz jest "przyjazna" bądź "obca" na podstawie tych kryteriów.
Zapytanie POST może być stosowane w celu rozpoczęcia wyszukiwania (zobacz: Żądanie wyszukiwania); typ wyszukiwania to stranger; pozostała część body pozostaje pusta.
Następujące parametry są dostępne:
| Parametr | Wymagany | Opis |
|---|---|---|
| accuracy | Nie | Ustala wymagany poziom podobieństwa twarzy w zasięgu |
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 - idealne dopasowanie). Jeśli parametr nie jest ustalony, używana jest domyślna wartość (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. Jeśli porównywana twarz była w polu widzenia kamery w danym dniu i została rozpoznana z dokładnością nie mniejszą niż określona, twarz ta jest uznawana za obecną tego dnia; w innym przypadku, algorytm uznaje twarz za nieobecną tego dnia.
| ||||||
| threshold | No | Nie | Określa pułap dla określania twarzy jako “obca”. Wartość może znajdować się w zasięgu od 0 do 1; określa ona liczbę dni, przez które twarz była nieobecna, aby uznać ją za "obcą"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”: 30-30*[threshold. For instance, the value 0.8 means “the required object appeared in the search area within ]. Przykładowo wartość 0.8 oznacza, że "określony obiekt pojawił się w strefie wyszukiwania przez (30 - 30 * 0.8 = 6) days”. All faces that appeared within 6 and more days will be defined as “familiar faces”, others – as “strangers”dni”. Wszystkie twarze, które pojawiły się przez 6 dni lub więcej będą rozpoznane jako "przyjazne"; inne - jako "obce".
| |||||
| op | No | Nie | Określa rodzaj wyszukiwaniaDefines search direction. Allowable valuesmożliwe wartości: lt – “familiar face” search (based on treshold parameter– wyszukuje “przyjazne twarze” (na podstawie parametru threshold). gt – “stranger” search– wyszukuje "obcych". |
Sample requestPrzykładowe zapytanie:
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 responsePrzykładowa odpowiedź:
| 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"
}
} |
| ParameterParametr | DescriptionOpis | ||
|---|---|---|---|
| origin | Camera channel to take analyzed video stream from. | ||
| timestamp | Time stamp of a frame with a face detected by the detection tool. | ||
| Kanał kamery, z którego ma być pozyskiwane zanalizowane wideo. | |||
| timestamp | Znacznik czasu klatki, na której twarz została wykryta przez narzędzie detekcji. | ||
| rate | Wskaźnik wykrywania twarzy jako "obce"; wartość powinna znajdować się w zasięgu | rate | Rate of identifying a face as a “stranger”, the value in the [0,1] range. 1 means a complete strangeroznacza kompletnie obcą twarz. |
| positionCoordinates of a frame border enclosing face on a video frame | Koordynaty krawędzi obramowania okalające twarz na klatce wideo. |
Overview
Content Tools