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:

ParametrWymaganyOpis
accuracyNie

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. 

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.


thresholdNie

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".

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.


opNieOkreś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"
      }
}


ParametrOpis
originKanał kamery, z którego ma być pozyskiwane zanalizowane wideo.
timestampZnacznik czasu klatki, na której twarz została wykryta przez narzędzie detekcji.
rateWskaźnik wykrywania twarzy jako "obce"; wartość powinna znajdować się w zasięgu [0,1]. 1 oznacza kompletnie obcą twarz.
positionKoordynaty krawędzi obramowania okalające twarz na klatce wideo.