Condividi tramite

Strutture dei dati di riconoscimento del viso

  • Articolo

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

Attenzione

L'accesso al servizio Viso è limitato in base ai criteri di idoneità e utilizzo al fine di supportare i nostri principi di intelligenza artificiale responsabile. Il servizio Viso è disponibile solo per i clienti e i partner gestiti da Microsoft. Usare il modulo di acquisizione riconoscimento volto per richiedere l'accesso. Per altre informazioni, vedere la pagina Accesso limitato dalla funzione Viso.

Strutture di dati usate con Identify

L'API Face Identify usa strutture di dati del contenitore per contenere i dati di riconoscimento volto sotto forma di oggetti Person. Esistono tre tipi di contenitori, elencati dai più vecchi 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, viene usato quel modello 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 si riflettano nei risultati dell'API Identify. 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ò contenere fino a 10.000 persone.

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

Large Person Group

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 di persone.

PersonDirectoryPerson rappresenta una persona da identificare. Aggiornato dal modello PersonGroupPerson, consente di aggiungere più visi da diversi modelli di riconoscimento alla stessa persona. Tuttavia, l'operazione Identify e 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 Train: 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 identify. 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 Find Similar

A differenza dell'API Identify, 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 fino a 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 Identify.