Strutture dei dati di riconoscimento del viso

Questo articolo illustra le strutture di dati usate nel servizio Viso per le operazioni di riconoscimento del viso. Queste strutture di dati contengono dati su visi e persone.

È possibile provare le funzionalità di riconoscimento dei volti in modo rapido e semplice usando Vision Studio.

Attenzione

L'accesso al servizio Viso è limitato in base ai criteri di idoneità e utilizzo per supportare i principi di IA responsabile. Il servizio Viso è disponibile solo per i clienti e i partner gestiti da Microsoft. Usare il modulo di assunzione riconoscimento del viso per richiedere l'accesso. Per altre informazioni, vedere la pagina Viso con accesso limitato.

Strutture di dati usate con Identify

L'API Face Identify usa strutture di dati del contenitore per contenere i dati di riconoscimento del viso sotto forma di oggetti Person . Esistono tre tipi di contenitori, elencati dai meno recenti ai più recenti. È consigliabile usare sempre quello più recente.

PersonGroup

PersonGroup è la struttura di dati contenitore più piccola.

  • È necessario specificare un modello di riconoscimento quando si crea un PersonGroup. Quando vengono aggiunti visi a tale PersonGroup, tale modello viene usato per elaborarli. Questo modello deve corrispondere alla versione del modello con Face ID dall'API di rilevamento.
  • È necessario chiamare l'API Train per fare in modo che i nuovi dati del viso riflettano nei risultati dell'API Di identificazione. Sono inclusi l'aggiunta/rimozione di visi e l'aggiunta/rimozione di persone.
  • Per la sottoscrizione di livello gratuito, può contenere fino a 1000 persone. Per l'abbonamento a pagamento S0 può avere fino a 10.000 persone.

PersonGroupPerson rappresenta una persona da identificare. Può contenere fino a 248 visi.

Gruppo di persone di grandi dimensioni

LargePersonGroup è una struttura di dati successiva introdotta per supportare fino a 1 milione di entità (per la sottoscrizione di livello S0). È ottimizzato per supportare dati su larga scala. Condivide la maggior parte delle funzionalità di PersonGroup: è necessario specificare un modello di riconoscimento in fase di creazione e chiamare l'API Train prima dell'uso.

Person Directory

PersonDirectory è la struttura dei dati più recente di questo tipo. Supporta una scalabilità maggiore e una maggiore accuratezza. Ogni risorsa Viso di Azure ha una singola struttura di dati PersonDirectory predefinita. Si tratta di un elenco semplice di oggetti PersonDirectoryPerson , che può contenere fino a 75 milioni.

PersonDirectoryPerson rappresenta una persona da identificare. Aggiornato dal modello PersonGroupPerson , consente di aggiungere visi da modelli di riconoscimento diversi alla stessa persona. Tuttavia, l'operazione Di identificazione può corrispondere solo ai visi ottenuti con lo stesso modello di riconoscimento.

DynamicPersonGroup è una struttura di dati leggera che consente di fare riferimento in modo dinamico a un PersonGroupPerson. Non richiede l'operazione Di training: una volta aggiornati i dati, è possibile usarli con l'API Di identificazione.

È anche possibile usare un elenco di ID persona sul posto per l'operazione Di identificazione. In questo modo è possibile specificare un gruppo più ristretto da cui identificare. È possibile eseguire questa operazione manualmente per migliorare le prestazioni di identificazione in gruppi di grandi dimensioni.

Le strutture di dati precedenti possono essere usate insieme. Ad esempio:

  • In un sistema di controllo di accesso, PersonDirectory potrebbe rappresentare tutti i dipendenti di una società, ma un DynamicPersonGroup più piccolo potrebbe rappresentare solo i dipendenti che hanno accesso a un singolo piano dell'edificio.
  • In un sistema di onboarding in anteprima, PersonDirectory potrebbe rappresentare tutti i clienti della compagnia aerea, ma DynamicPersonGroup rappresenta solo i passeggeri di un determinato volo. Un elenco di ID persona sul posto potrebbe rappresentare i passeggeri che hanno apportato una modifica dell'ultimo minuto.

Per altre informazioni, vedere la guida pratica persondirectory.

Strutture di dati usate con Trova simile

A differenza dell'API Di identificazione, l'API Find Similar è progettata per essere usata nelle applicazioni in cui la registrazione di Person è difficile da configurare (ad esempio, immagini del viso acquisite dall'analisi video o da un'analisi di album fotografici).

FaceList

FaceList rappresenta un elenco semplice di visi persistenti. Può contenere 1.000 visi.

LargeFaceList

LargeFaceList è una versione successiva che può contenere fino a 1.000.000 visi.

Passaggi successivi

Ora che si ha familiarità con le strutture dei dati del viso, scrivere uno script che li usa nell'operazione Di identificazione.