---
title: "顔分析"
url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/zia-services/face-analytics/
description: "このページでは、Javaアプリケーションでサンプルコードスニペットを使用してFace Analytics機能で指定された条件に基づいて顔を検出する方法について説明します"
last_updated: 2026-06-09T07:46:16Z
service: Zia Services
type: general
related_links:
  - name: "Face Analytics - API"
    url: /ja/api/code-reference/zia-services/face-analytics/#FaceAnalytics
---

# Face Analytics

Zia Face Analyticsは、画像内の顔検出を実行し、顔の特徴を分析して、検出された顔の性別、年齢、感情などの情報を提供します。

詳細については、[Face Analyticsヘルプページ](https://docs.catalyst.zoho.com/ja/zia-services/help/face-analytics/introduction)をご覧ください。

入力として._jpg_/._jpeg_または._png_ファイルを提供する必要があります。リクエストとレスポンスの形式については、[APIドキュメント](https://docs.catalyst.zoho.com/ja/api/code-reference/zia-services/face-analytics/#FaceAnalytics)を参照してください。

属性を`true`または`false`に設定することで、年齢、笑顔、性別の検出を有効または無効にできます。また、モードを`BASIC`、`MODERATE`、または`ADVANCED`に指定することもできます。これらの値はオプションです。デフォルトでは、すべての属性が検出され、`ADVANCED`モードで処理されます。

レスポンスは、有効化された属性の予測、各顔の顔の特徴の座標とランドマーク、および各分析の信頼度スコアを返します。

#### サンプルコードスニペット 

**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}"); 
//ファイルパスを指定する 
//各属性検出を必須または任意に設定し、検出モードを設定する 
ZCFaceAnalyticsOptions options = ZCFaceAnalyticsOptions.getInstance().setAgeNeeded(false)
.setEmotionNeeded(true).setGenderNeeded(true).setAnalyseMode(ZCAnalyseMode.ADVANCED);
ZCFaceAnalysisData faceData = ZCML.getInstance().analyzeFace(file, options); 
//ファイルとオプションでanalyzeFace()を呼び出す 
Long facesCount = faceData.getFacesCount(); 
//画像内の顔の数を取得する 
List faces = faceData.getFacesList(); 
for(ZCFaces face : faces)
{ 
//検出された各顔に対して実行される 
Double faceConfidence = face.getConfidence(); 
//各分析の信頼度スコアを取得する 
ZCAge age = face.getAge(); 
//顔の年齢を取得する 
ZCGender gender = face.getGender(); 
//顔の性別を取得する 
ZCFaceEmotion emotion = face.getEmotion();
//笑顔情報を取得する 
ZCFacePoints facePoints = face.getCoordinates(); 
//顔の座標を取得する 
List faceLandmarks = face.getFaceLandmarks(); 
//顔の特徴のランドマークを取得する 
}

```