Go to documentation repository
Documentation for Axxon Next 4.5.0. Documentation for other versions of Axxon Next is available too.
Previous page Next page
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 [0,1] (1 - idealne dopasowanie). Jeśli parametr nie jest ustalony, używana jest domyślna wartość (0.9). 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. Uwaga! Wartość parametru accuracy może być określona także w body zapytania (począwszy od wersji 4.3.0.7914). W takim przypadku ma ona wyższy priorytet niż wartość ustalona w inny sposób. |
threshold | 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ą": 30-30*[threshold]. Przykładowo wartość 0.8 oznacza, że "określony obiekt pojawił się w strefie wyszukiwania przez (30 - 30 * 0.8 = 6) dni”. Wszystkie twarze, które pojawiły się przez 6 dni lub więcej będą rozpoznane jako "przyjazne"; inne - jako "obce". Uwaga! Parametry threshold oraz op powinny być stosowane wyłącznie wspólnie. Jeśli którykolwiek z parametrów nie jest ustalony lub ma niepoprawną wartość, wszystkie parametry będą zignorowane. |
op | Nie | Określa rodzaj wyszukiwania. możliwe wartości: lt – wyszukuje “przyjazne twarze” (na podstawie parametru threshold). gt – wyszukuje "obcych". |
Przykł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
Przykładowa odpowiedź:
{ "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" } }
Parametr | Opis |
---|---|
origin | 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 [0,1]. 1 oznacza kompletnie obcą twarz. |
position | Koordynaty krawędzi obramowania okalające twarz na klatce wideo. |