Guía Search

Los Servicios de Search (búsqueda) tienen como finalidad hacer una consulta 1:N con respecto a una colección proporcionada, es decir, con una imagen proporcionada se hace búsqueda dentro de la colección con el fin de encontrar algún tipo de coincidencia. Esto es útil cuando se quieren hacer procesos de autenticación (inicio de sesión) de personas previamente registradas.

¿Qué servicios realizan un Search?

Actualmente, se ofrecen cinco servicios que realizan este proceso, los cuales son:

• Search 1:N
• Search 1:N | Live
• Search 1:N | Crops
• Face Detect
• Face Verify

Estos servicios comparten el mismo propósito, generar una búsqueda de personas previamente creadas en un Collection con el fin de encontrar coincidencias.

Similitudes en los servicios

Los servicios antes mencionados cuentan con algunas similitudes en su estructura, a continuación mostraremos un JSON explicando 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 Collection, este parámetro llamado code, se genera al crear una Collection de manera adecuada.
• min_score: Este parámetro, un número entre 0.5 y 1.0, establece la tolerancia mínima de coincidencia permitida al momento de hacer una comparación 1:N entre el FaceMap y los FaceHash que se encuentran en el Collection. Esta función determina si el rostro ya existe o no en dicha colección.
• search_mode: Este parámetro determina la modalidad en que se va a realizar la búsqueda del rostro en la colección. Existen dos posibles parámetros válidos, i) FAST para hacer una búsqueda rápida y, ii) ACCURATE para hacer consultas mucho más precisas en la colección; este último valor aumenta los tiempos de respuesta del servicio, pero garantiza un mejor mapeo para evitar que se añadan rostros duplicados.
• images: Arreglo (en inglés Array) de imágenes, todas las imágenes deben ser de la misma persona, deben estar en formato Base 64 y se pueden enviar máximo tres (3) imágenes.

Diferencias en los servicios

Cada servicio tiene un uso particular dependiendo de la necesidad o caso de uso aplicable. A continuación conocerá las diferencias y los escenarios más comunes:

• Search 1:N: Servicio estándar de búsqueda de coincidencias en la colección, se recomienda usarlo cuando la persona que se tiene certeza que la persona a buscar ya se le hizo una detección de vida con anterioridad y en la colección se guardó de dicha manera.