Struktury danych rozpoznawania twarzy
W tym artykule opisano struktury danych używane w usłudze rozpoznawania twarzy na potrzeby operacji rozpoznawania twarzy. Te struktury danych przechowują dane na twarzach i osobach.
Uwaga
Dostęp do usługi rozpoznawania twarzy jest ograniczony na podstawie kryteriów kwalifikowalności i użycia w celu obsługi naszych zasad odpowiedzialnej sztucznej inteligencji. Usługa rozpoznawania twarzy jest dostępna tylko dla klientów i partnerów zarządzanych przez firmę Microsoft. Użyj formularza do wprowadzania rozpoznawania twarzy, aby ubiegać się o dostęp. Aby uzyskać więcej informacji, zobacz stronę Dostęp ograniczony do twarzy.
Struktury danych używane z funkcją Identyfikowanie
Interfejs API rozpoznawania twarzy używa struktur danych kontenera do przechowywania danych rozpoznawania twarzy w postaci obiektów Person . W tym celu istnieją trzy typy kontenerów wymienionych od najstarszych do najnowszych. Zalecamy, aby zawsze używać najnowszej.
PersonGroup
PersonGroup to najmniejsza struktura danych kontenera.
- Podczas tworzenia obiektu PersonGroup należy określić model rozpoznawania. Gdy wszystkie twarze zostaną dodane do tej grupy PersonGroup, używa tego modelu do ich przetwarzania. Ten model musi być zgodny z wersją modelu z funkcją Face ID z interfejsu API wykrywania.
- Musisz wywołać interfejs API trenowania, aby nowe dane twarzy odzwierciedlały się w wynikach interfejsu API identyfikowania. Obejmuje to dodawanie/usuwanie twarzy i dodawanie/usuwanie osób.
- W przypadku subskrypcji w warstwie Bezpłatna może pomieścić maksymalnie 1000 osób. W przypadku płatnej subskrypcji S0 może ona mieć do 10 000 osób.
PersonGroupPerson reprezentuje osobę do zidentyfikowania. Może pomieścić do 248 twarzy.
Grupa dużych osób
LargePersonGroup to późniejsza struktura danych wprowadzona do obsługi maksymalnie 1 miliona jednostek (w przypadku subskrypcji warstwy S0). Jest zoptymalizowany pod kątem obsługi danych na dużą skalę. Udostępnia większość funkcji PersonGroup : model rozpoznawania należy określić w czasie tworzenia, a przed użyciem należy wywołać interfejs API trenowania.
Katalog osób
PersonDirectory to najnowsza struktura danych tego typu. Obsługuje większą skalę i większą dokładność. Każdy zasób rozpoznawania twarzy platformy Azure ma jedną domyślną strukturę danych PersonDirectory . Jest to płaska lista obiektów PersonDirectoryPerson — może pomieścić do 20 milionów.
PersonDirectoryPerson reprezentuje osobę do zidentyfikowania. Na podstawie starszego modelu PersonGroupPerson można dodawać twarze z różnych modeli rozpoznawania do tej samej osoby. Jednak operacja Identyfikowanie może być zgodna tylko z twarzami uzyskanymi za pomocą tego samego modelu rozpoznawania.
DynamicPersonGroup to uproszczona struktura danych, która umożliwia dynamiczne odwoływanie się do obiektu PersonDirectoryPerson. Nie wymaga operacji Trenowanie: po zaktualizowaniu danych można go używać z interfejsem API identyfikowania.
Możesz również użyć listy identyfikatorów osób w miejscu dla operacji Identyfikowanie. Dzięki temu można określić bardziej wąską grupę do zidentyfikowania. Można to zrobić ręcznie, aby zwiększyć wydajność identyfikacji w dużych grupach.
Powyższe struktury danych mogą być używane razem. Na przykład:
- W systemie kontroli dostępu usługa PersonDirectory może reprezentować wszystkich pracowników firmy, ale mniejsza grupa DynamicPersonGroup może reprezentować tylko pracowników, którzy mają dostęp do jednego piętra budynku.
- W systemie dołączania lotów osobaDirectory może reprezentować wszystkich klientów firmy lotniczej, ale DynamicPersonGroup reprezentuje tylko pasażerów w danym locie. Lista identyfikatorów osób na miejscu może reprezentować pasażerów, którzy dokonali zmiany w ostatniej chwili.
Aby uzyskać więcej informacji, zapoznaj się z przewodnikiem z instrukcjami dotyczącymi usługi PersonDirectory. Szybkie porównanie elementu LargePersonGroup i PersonDirectory:
| Szczegół | LargePersonGroup | PersonDirectory |
|---|---|---|
| Wydajność | Obiekt LargePersonGroup może pomieścić do 1 miliona obiektów PersonGroupPerson . | Kolekcja może przechowywać do 20 milionów tożsamości PersonDirectoryPerson . |
| Identyfikator PERSONURI | /largepersongroups/{groupId}/persons/{personId} |
(/v1.0-preview-or-above)/persons/{personId} |
| Własność | Obiekty PersonGroupPerson należą wyłącznie do grupy LargePersonGroup , do której należą. Jeśli chcesz, aby ta sama tożsamość została zachowana w wielu grupach, musisz utworzyć osobę w grupie dużej osoby i dodać twarz osoby grupy dużej osoby dla każdej grupy osobno, kończąc się zestawem identyfikatorów osób w kilku grupach. | Obiekty PersonDirectoryPerson są przechowywane bezpośrednio wewnątrz obiektu PersonDirectory jako listy płaskiej. Możesz użyć listy identyfikatorów osób w miejscu, aby zidentyfikować z katalogu osób lub opcjonalnie utworzyć grupę osób dynamicznych i dołączyć hybrydowo osobę do grupy. Utworzony obiekt PersonDirectoryPerson można odwoływać się do wielu elementów DynamicPersonGroup bez duplikowania. |
| Model | Model rozpoznawania jest określany przez grupę LargePersonGroup. Nowe twarze dla wszystkich obiektów PersonGroupPerson stają się skojarzone z tym modelem po dodaniu ich do niego. | Obiekt PersonDirectoryPerson przygotowuje oddzielony magazyn na model rozpoznawania. Model można określić podczas dodawania nowych twarzy, ale interfejs API identyfikowania może być zgodny tylko z twarzami uzyskanymi za pomocą tego samego modelu rozpoznawania, który jest skojarzony z twarzami zapytań. |
| Szkolenia | Musisz wywołać interfejs API trenowania, aby nowe dane twarzy/osoby odzwierciedlały się w wynikach interfejsu API identyfikowania. | Nie ma potrzeby wykonywania wywołań trenowania, ale interfejs API, taki jak Dodawanie twarzy osoby, staje się długotrwałą operacją, co oznacza, że należy użyć nagłówka odpowiedzi "Operation-Location", aby sprawdzić, czy aktualizacja zostanie ukończona. |
| Czyszczenie | Usunięcie grupy dużych osób spowoduje również usunięcie wszystkich przechowywanych obiektów PersonGroupPerson wraz z danymi twarzy. | Usuń grupę osób dynamicznych tylko nie będzie wnioskować PersonDirectoryPerson. Aby usunąć rzeczywistą osobę i dane twarzy, zobacz Usuwanie osoby. |
Struktury danych używane z funkcją Znajdź podobne
W przeciwieństwie do interfejsu API identyfikowania interfejs API znajdź podobne jest używany w aplikacjach, w których rejestracja osoby jest trudna do skonfigurowania (na przykład obrazy twarzy przechwycone z analizy wideo lub analizy albumu fotograficznego).
Lista twarzy
Funkcja FaceList reprezentuje płaską listę utrwalonej twarzy. Może pomieścić 1000 twarzy.
LargeFaceList
LargeFaceList to nowsza wersja, która może zawierać maksymalnie 1000 000 twarzy.
Następny krok
Teraz, gdy znasz struktury danych twarzy, napisz skrypt, który używa ich w operacji Identyfikowanie.