---
title: "Análisis facial"
url: https://docs.catalyst.zoho.com/es/sdk/java/v1/zia-services/face-analytics/
description: "Esta página describe el método para usar la funcionalidad Face Analytics para detectar rostros con criterios específicos en tu aplicación Java con fragmentos de código de ejemplo"
last_updated: 2026-06-09T07:46:16Z
service: Zia Services
type: general
related_links:
  - name: "Face Analytics - API"
    url: /es/api/code-reference/zia-services/face-analytics/#FaceAnalytics
---

# Face Analytics

Zia Face Analytics realiza detección facial en imágenes y analiza las características faciales para proporcionar información como
el género, la edad y la emoción de los rostros detectados.

Puedes aprender más en la [página de ayuda de Face Analytics](https://docs.catalyst.zoho.com/es/zia-services/help/face-analytics/introduction).

Debes proporcionar archivos ._jpg_/._jpeg_ o ._png_ como entrada. Consulta la [documentación de la API](https://docs.catalyst.zoho.com/es/api/code-reference/zia-services/face-analytics/#FaceAnalytics) para los formatos de solicitud y respuesta.

Puedes habilitar o deshabilitar la detección de edad, sonrisa o género estableciendo los atributos como `true`
o `false`. También puedes especificar el modo como `BASIC`,
`MODERATE` o `ADVANCED`. Estos valores son opcionales. Todos los atributos son
detectados y el modo `ADVANCED` se procesa por defecto.

La respuesta devuelve la predicción de los atributos habilitados, las coordenadas y puntos de referencia de las características faciales de cada
rostro, y la puntuación de confianza de cada análisis.

#### Fragmento de código de ejemplo 

**Package Imports**

```java
import com.zc.component.ml.ZCAge; 
import com.zc.component.ml.ZCAnalyseMode;
import com.zc.component.ml.ZCFaceAnalysisData; 
import com.zc.component.ml.ZCFaceAnalyticsOptions; 
import com.zc.component.ml.ZCFaceEmotion; 
import com.zc.component.ml.ZCFaceLandmark; 
import com.zc.component.ml.ZCFacePoints;
import com.zc.component.ml.ZCFaces; 
import com.zc.component.ml.ZCGender; 
import com.zc.component.ml.ZCML;
import java.io.File;

```

```java
File file = new File("{filePath}"); 
//Especifica la ruta del archivo 
//Establece cada detección de atributo como requerida o no requerida, y el modo de detección 
ZCFaceAnalyticsOptions options = ZCFaceAnalyticsOptions.getInstance().setAgeNeeded(false)
.setEmotionNeeded(true).setGenderNeeded(true).setAnalyseMode(ZCAnalyseMode.ADVANCED);
ZCFaceAnalysisData faceData = ZCML.getInstance().analyzeFace(file, options); 
//Llama a analyzeFace() con el archivo y las opciones 
Long facesCount = faceData.getFacesCount(); 
//Para obtener el conteo de rostros en la imagen 
List faces = faceData.getFacesList(); 
for(ZCFaces face : faces)
{ 
//Se ejecuta para cada rostro detectado 
Double faceConfidence = face.getConfidence(); 
//Para obtener la puntuación de confianza de cada análisis 
ZCAge age = face.getAge(); 
//Para obtener la edad del rostro 
ZCGender gender = face.getGender(); 
//Para obtener el género del rostro 
ZCFaceEmotion emotion = face.getEmotion();
//Para obtener información de sonrisa 
ZCFacePoints facePoints = face.getCoordinates(); 
//Para obtener las coordenadas del rostro 
List faceLandmarks = face.getFaceLandmarks(); 
//Para obtener los puntos de referencia de las características faciales 
}

```