Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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. 

Note
titleImportant!

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

Note
titleImportant!

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ź:

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


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.