Para realizar uma checagem da padronização de imagem de face, usa-se o método check_icao, que avalia a qualidade da foto da face de acordo com o padrão ISO/IEC 19794-5, ICAO. Este padrão foi criado com o intuito de permitir que máquinas façam a análise de imagens de face de forma automática mais eficientemente, portanto, verificar se a foto que será enviada para o sistema está de acordo com este padrão aprimorará o seu uso do BioPass ID.
Para o corpo da requisição, será necessário enviar um texto em formato JSON contendo a string base64 da imagem que deseja checar. Um exemplo pode ser visto abaixo:
{
"Check": {
"Image": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAY"
}
}Já para o header, insira o tipo de conteúdo e sua chave de subscrição, substituindo <API-KEY>, conforme o exemplo abaixo:
{
'Content-Type': 'application/json',
'Ocp-Apim-Subscription-Key': '<API-KEY>'
}Para a requisição, especifique que é um método de tipo POST, a URL https://api.biopassid.com/quality/check_icao , o header e o corpo conforme os exemplos dados. É possível verificar abaixo como ficaria uma requisição desse tipo, escrito em Python, mas que pode ser verificada em diversas outras linguagens de programação em nossa documentação:
import http.client
import json
conn = http.client.HTTPSConnection("hml-api.biopassid.com")
payload = json.dumps({
"Check": {
"Image": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAY"
}
})
headers = {
'Content-Type': 'application/json',
'Ocp-Apim-Subscription-Key': '52ac87259c6e46e78525cb47e469c4ce'
}
conn.request("POST", "/quality/check_icao", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))Caso receba a mensagem 200 (OK) em sua resposta, isso significa que a requisição foi concluída com sucesso. O conteúdo da resposta será um objeto ICAO que conterá com detalhes o resultado do exame.
Primeiramente, ele conterá uma variável FaceImageConformed, que conterá um código numérico que se refere ao posicionamento da face na foto. O significado de cada valor pode ser observado na tabela abaixo:
Código | Descrição |
-1 | Erro no processamento da imagem |
0 | Nenhum problema foi encontrado |
1 | Face não detectada |
2 | Nenhum landmark foi identificado |
3 | Face está deslocada à esquerda |
4 | Face está deslocada à direita |
5 | Face está deslocada para cima |
6 | Face está deslocada para baixo |
7 | Face está longe |
Em seguida, a variável IsAllConformed conterá um valor booleano que indica se a foto está completamente de acordo com todos os requerimentos impostos pelo padrão ICAO.
Por fim, haverá um objeto Requirements que mostra para cada requerimento se ele foi cumprido (através da variável booleana IsConformed) e o nível de certeza (de 0 a 100, através da variável Confidence). Uma tabela com cada requerimento e o que ele significa pode ser vista abaixo:
Requisito | Descrição |
Blurred | A foto não pode estar embaçada |
LookingAway | O indivíduo tem que estar olhando diretamente para câmera |
InkMarked | A foto não pode ter marcas de tinta |
UnnaturalSkin | A foto deve mostrar o tom de pele natural do indivíduo |
TooDarkLight | A foto deve possuir brilho adequado |
WashedOut | A foto de deve possuir nível de contraste adequado |
Pixelation | A foto não deve apresentar pixelização |
HairAcrossEyes | Os olhos não podem ser obstruidos pelo cabelo do indivíduo |
EyesClosed | Os olhos devem estar abertos |
VariedBackground | A foto deve ser retirada com o fundo uniforme |
Roll_Pitch_Yaw | A cabeça do indivíduo deve estar voltada para câmera e em posição frontal |
FlashReflectionOnSkin | A foto não pode apresentar reflexos do flash na pele do indivíduo |
RedEyes | A foto não pode apresentar olhos vermelhos |
ShadowsBehindHead | A foto não pode apresentar sombras atrás do indivíduo |
ShadowsAcrossFace | A foto não pode apresentar sombras na face do indivíduo |
DarkTintedLenses | O indivíduo não pode estar usando óculos escuros |
FlashReflectionOnLenses | A foto não pode apresentar reflexos nas lente do óculos do indivíduo |
FramesTooHeavy | O indivíduo não pode estar usando óculos de armação pesada |
FramesCoveringEyes | A armação dos óculos do indivíduo não pode cobrir os seus olhos |
Hat_Cap | O indivíduo não pode utilizar chapéu ou boné na foto |
VeilOverFace | Caso esteja vestindo véu, este não pode cobrir a face do indivíduo |
MouthOpen | A boca do indivíduo deve estar fechada |
OtherFaces | O indivíduo deve estar sozinho na foto |
Por fim, um exemplo de como ficaria a resposta do sistema para a requisição feita no exemplo pode ser observada abaixo:
{
"ICAO": {
"FaceImageConformed": 0,
"IsAllConformed": false,
"Requirements": {
"Blurred": {
"IsConformed": true,
},
"LookingAway": {
"IsConformed": true,
},
"InkMarked": {
"IsConformed": true,
},
"UnnaturalSkin": {
"IsConformed": true,
},
"TooDarkLight": {
"IsConformed": false,
},
"WashedOut": {
"IsConformed": true,
},
"Pixelation": {
"IsConformed": true,
},
"HairAcrossEyes": {
"IsConformed": true,
},
"EyesClosed": {
"IsConformed": true,
},
"VariedBackground": {
"IsConformed": true,
},
"Roll_Pitch_Yaw": {
"IsConformed": false,
},
"FlashReflectionOnSkin": {
"IsConformed": true,
},
"RedEyes": {
"IsConformed": true,
},
"ShadowsBehindHead": {
"IsConformed": true,
},
"ShadowsAcrossFace": {
"IsConformed": true,
},
"DarkTintedLenses": {
"IsConformed": true,
},
"FlashReflectionOnLenses": {
"IsConformed": true,
},
"FramesTooHeavy": {
"IsConformed": true,
},
"FramesCoveringEyes": {
"IsConformed": false,
},
"Hat_Cap": {
"IsConformed": true,
},
"VeilOverFace": {
"IsConformed": true,
},
"MouthOpen": {
"IsConformed": true,
},
"OtherFaces": {
"IsConformed": true,
}
}
}
}