Compartilhar via


Estruturas de dados de reconhecimento facial

Este artigo explica as estruturas de dados usadas no serviço de Detecção Facial para operações de reconhecimento facial. Essas estruturas de dados contêm dados em rostos e pessoas.

Cuidado

O acesso ao serviço de Detecção Facial é limitado com base em critérios de qualificação e uso para dar suporte aos nossos princípios de IA responsável. O serviço de Detecção Facial só está disponível para clientes e parceiros gerenciados da Microsoft. Use o Formulário de admissão de reconhecimento facial para solicitar acesso. Para obter mais informações, consulte a página Acesso limitado facial.

Estruturas de dados usadas com o Identificar

A API de Identificação Facial usa estruturas de dados de contêiner para armazenar dados de reconhecimento facial na forma de objetos de Pessoa. Há três tipos de contêineres para isso, listados do mais antigo para o mais recente. É recomendável que você sempre use o mais novo.

PersonGroup

PersonGroup é a menor estrutura de dados de contêiner.

  • Você precisará especificar um modelo de reconhecimento ao criar um PersonGroup. Quando qualquer rosto é adicionado a esse PersonGroup, ele usa esse modelo para processá-los. Esse modelo deve corresponder à versão do modelo com a ID de Detecção Facial da API de detecção.
  • Chame a API de Treinamento para fazer com que novos dados de detecção facial reflitam nos resultados da API de Identificação. Isso inclui adicionar/remover rostos e adicionar/remover pessoas.
  • Para a assinatura de camada gratuita, ela pode conter até 1000 pessoas. Para assinatura paga S0, ela pode ter até 10.000 pessoas.

PersonGroupPerson representa uma pessoa a ser identificada. Pode conter até 248 rostos.

Grande grupo de pessoas

LargePersonGroup é uma estrutura de dados posterior introduzida para dar suporte a até 1 milhão de entidades (para assinatura de camada S0). Ele é otimizado para dar suporte a dados em grande escala. Ele compartilha a maioria dos recursos de PersonGroup: um modelo de reconhecimento precisa ser especificado no momento da criação e a API de Treinamento deve ser chamada antes do uso.

Diretório de Pessoas

PersonDirectory é a estrutura de dados mais recente desse tipo. Ele dá suporte a uma grande escala e maior precisão. Cada recurso de Detecção Facial do Azure tem um único padrão estrutura de dados PersonDirectory. É uma lista simples de objetos PersonDirectoryPerson – pode conter até 75 milhões.

PersonDirectoryPerson representa uma pessoa a ser identificada. Atualizado do modelo PersonGroupPerson, ele permite adicionar rostos de modelos de reconhecimento diferentes à mesma pessoa. No entanto, a operação Identificar só pode corresponder aos rostos obtidos com o mesmo modelo de reconhecimento.

DynamicPersonGroup é uma estrutura de dados leve que permite referenciar dinamicamente um PersonGroupPerson. Ele não requer a operação Treinar: depois que os dados são atualizados, ele está pronto para ser usado com a API de Identificação.

Também poderá usar uma lista de IDs de pessoa no local para a operação Identificar. Isso permite especificar um grupo mais estreito do qual identificar. Faça isso manualmente para melhorar o desempenho de identificação em grupos grandes.

As estruturas de dados acima podem ser usadas em conjunto. Por exemplo:

  • Em um sistema de controle de acesso, o PersonDirectory pode representar todos os funcionários de uma empresa, mas um DynamicPersonGroup menor pode representar apenas os funcionários que têm acesso a um único andar do edifício.
  • Em um sistema de integração de voo, o PersonDirectory poderia representar todos os clientes da companhia aérea, mas o DynamicPersonGroup representa apenas os passageiros em um voo específico. Uma lista de IDs de pessoa no local poderia representar os passageiros que fizeram uma mudança de última hora.

Para obter mais detalhes, consulte a guia de instruções do PersonDirectory.

Estruturas de dados usadas com o Localizar Semelhante

Ao contrário da API de Identificação, a API de Localizar Semelhante foi projetada para ser usada em aplicativos em que o registro de Pessoa é difícil de configurar (por exemplo, imagens de rosto capturadas da análise de vídeo ou de uma análise de álbum de fotos).

FaceList

FaceList representa uma lista simples de rostos persistentes. Pode conter até 1.000 rostos.

LargeFaceList

LargeFaceList é uma versão posterior que pode conter até 1.000.000 rostos.

Próximas etapas

Agora que você está familiarizado com as estruturas de dados de detecção facial, escreva um script que as use na operação Identificar.