Busqueda
Introducción a los Servicios de Búsqueda: Cómo Funcionan, Tipos y Cómo Usarlos.
Guía de Búsqueda
Los servicios de búsqueda tienen como objetivo realizar una consulta 1:N dentro de una colección proporcionada. En otras palabras, se lleva a cabo una búsqueda en la colección con una imagen dada para encontrar cualquier tipo de coincidencia. Esto es útil en procesos de autenticación (inicio de sesión) para individuos previamente registrados.
¿Qué servicios realizan una búsqueda?
Actualmente, hay cinco servicios que ejecutan este proceso, los cuales son:
Estos servicios comparten el mismo propósito: realizar una búsqueda de individuos previamente creados en una Colección para encontrar coincidencias.
Similitudes en los servicios
Los servicios mencionados anteriormente tienen algunas similitudes en su estructura. A continuación, se muestra un JSON que explica cada uno de los parámetros:
{
"collection_id": "ID_OF_COLLECTION",
"images": [
"base64_encoded_string"
],
"min_score": 0.7,
"search_mode": "FAST/ACCURATE choose one"
}collection_id: Como se mencionó en la explicación de la Colección, este parámetro, llamado
code, se genera al crear correctamente una colección.min_score: Es un número entre 0.5 y 1.0 que establece la tolerancia mínima para una coincidencia en la comparación 1:N entre el FaceMap y el FaceHash dentro de la colección. Determina si el rostro ya existe en la colección o no.
search_mode: Define el modo de búsqueda dentro de la colección. Los valores válidos son: "FAST": Para una búsqueda rápida. "ACCURATE": Para consultas más precisas en la colección, lo que aumenta el tiempo de respuesta pero mejora la exactitud y evita duplicados.
images: Un array de imágenes. Todas deben pertenecer a la misma persona, estar en formato Base64, y se pueden enviar un máximo de tres (3) imágenes.
Diferencias entre los Servicios de Búsqueda
Cada servicio tiene un uso específico según la necesidad o caso de uso. A continuación, se detallan las diferencias y los escenarios más comunes:
Search 1:N: Servicio estándar para buscar coincidencias en la colección. Se recomienda cuando se tiene certeza de que la persona buscada ya ha pasado por una detección de prueba de vida y su información está almacenada en la colección.
Search 1:N | Live: La característica principal de este servicio es que primero realiza una detección de prueba de vida en la imagen antes de buscar coincidencias en la colección. Es útil cuando la persona fue agregada a la colección sin haber pasado por un servicio de detección de prueba de vida en ese momento.
Search 1:N | Crops: Similar al servicio estándar, pero solo acepta imágenes muy pequeñas, con un máximo de 120x120 píxeles. Es ideal en casos donde no es viable aumentar la imagen sin perder resolución.
Face Detect: Servicio para detectar rostros dentro de una imagen. Es ideal para extraer y verificar si una identificación (ID) contiene una foto de una persona para su comparación. Este servicio solo detecta la imagen, por lo que, si se necesita una comparación, se debe usar alguno de los servicios de la guía de comparación.
Face Verify: Realiza una búsqueda 1:1 con respecto a una persona previamente generada dentro de una colección. Si hay coincidencia, devuelve la información de la persona existente.
Otras Guías Relacionadas
Una vez completada esta guía, el siguiente paso es revisar las demás guías disponibles en la documentación:
Last updated