--- title: "実装" url: https://docs.catalyst.zoho.com/ja/zia-services/help/face-analytics/implementation/ description: "Face Analyticsは、Zia AIを活用した構築済みマイクロサービスで、顔検出を実行し、さまざまな顔の属性を予測します。" last_updated: 2026-08-17T12:16:04Z service: Zia Services type: general --- # 実装 このセクションでは、CatalystコンソールでのFace Analyticsの操作のみを説明します。アプリケーションのコードにFace Analyticsを実装する方法については、[SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/zia-services/face-analytics/)および[API](https://docs.catalyst.zoho.com/ja/api/code-reference/zia-services/face-analytics/#FaceAnalytics/)ドキュメントのセクションを参照してください。 前述のとおり、コンソールからCatalystアプリケーションにFace Analyticsを統合するためのコードテンプレートにアクセスでき、また顔が含まれる画像をアップロードして結果を取得することで機能をテストすることもできます。 ### Face Analyticsへのアクセス CatalystコンソールでFace Analyticsにアクセスするには： 1. Catalystコンソールの左ペインで**Zia Services**に移動し、**Face Analytics**をクリックします。 ![face-analytics](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/face-analytics-updated.webp) 2. **Try a Demo**をクリックすると、Face Analytics機能が開きます。 ![catalyst_facean_test_page](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_test_page.webp) ### CatalystコンソールでのFace Analyticsのテスト Catalystのサンプル画像を選択するか、独自の画像をアップロードして、Face Analyticsをテストできます。 サンプル画像をスキャンして結果を表示するには： 1. ボックス内の**Select a Sample Image**をクリックします。 ![catalyst_facean_sample](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_sample.webp) 2. 提供されたサンプルから画像を選択します。 ![catalyst_facean_select_sample](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_select_sample.webp) Face Analyticsが画像内の顔をスキャンし、[属性](https://docs.catalyst.zoho.com/ja/zia-services/help/face-analytics/key-concepts)を分析・予測し、検出された各顔について分析のテキスト結果と各predictionのconfidence scoreをパーセンテージ値で提供します。 ![catalyst_facean_sample_scanned](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_sample_scanned.webp) レスポンスバーの色は、predictionのconfidenceパーセンテージの範囲を示します。赤：0-30%、オレンジ：30-80%、緑：80-100%です。 各顔の一般的な座標とローカライズされたランドマークの座標は、その他の検出結果に加えて、デフォルトでadvancedランドマークローカリゼーションモードのJSON responseで提供されます。**View Response**をクリックして[JSON response](https://docs.catalyst.zoho.com/ja/zia-services/help/face-analytics/key-concepts/#response-format)を表示します。 ![catalyst_facean_sample_json](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_sample_json.webp) 完全なサンプルJSON responseの構造については、[APIドキュメント](https://docs.catalyst.zoho.com/ja/api/code-reference/zia-services/face-analytics/#FaceAnalytics/)を参照してください。 独自の画像をアップロードしてFace Analyticsをテストするには： 1. _Result_セクションの下にある**Upload**をクリックします。 ![catalyst_facean_upload](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_upload.webp) Face Analyticsを閉じた後に再度開く場合は、このボックス内の**Browse Files**をクリックします。 ![catalyst_facean_browse](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_browse.webp) 2. ローカルシステムからファイルをアップロードします。 > **注意:** ファイルは._jpg_/._jpeg_または._png_形式である必要があります。ファイルサイズは10 MBを超えないようにしてください。 コンソールが画像内の顔をスキャンし、検出された顔の4つの属性の分析を表示します。 ![catalyst_facean_image_scanned](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_image_scanned.webp) 前述のとおり、Face Analyticsは画像内で最大10個の顔を検出し、属性を分析できます。サイドの矢印をクリックして、検出された各顔の結果を確認できます。JSON responseにも検出された各顔の結果が含まれます。 ![catalyst/catalyst_facean_image_json](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_image_json.webp) ### Face Analyticsのコードテンプレートへのアクセス Catalystが[Java](https://docs.catalyst.zoho.com/ja/sdk/java/v1/zia-services/face-analytics/)、[Node.js](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/zia-services/face-analytics/)、[Python](https://docs.catalyst.zoho.com/ja/sdk/python/v1/zia-services/face-analytics/)プラットフォーム用に提供するコードテンプレートを使用して、CatalystアプリケーションにFace Analyticsを実装できます。 テストウィンドウの下のセクションからアクセスできます。**Java SDK**、**NodeJS SDK**、または**Python SDK**タブをクリックし、コピーアイコンを使用してコードをコピーします。このコードを、必要な箇所のWebまたはAndroidアプリケーションのコードに貼り付けることができます。 ![catalyst_facean_java](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_java_updated.webp) Javaでは、入力ファイルを新しい`File`として処理できます。`ZCFaceAnalyticsOptions`モジュールにより、各属性の分析を有効または無効にするオプションが提供されます。たとえば、`setAgeNeeded`を`false`に設定すると、Face Analyticsは画像内で検出された顔の年齢prediction結果を提供しません。また、`setAnalyseMode`を使用して、[ランドマークローカリゼーション](https://docs.catalyst.zoho.com/ja/zia-services/help/face-analytics/key-concepts/#facial-landmark-localization)モードを`BASIC`、`MODERATE`、または`ADVANCED`に設定できます。 ![catalyst_facean_node](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_node_updated.webp) Node.jsでは、`facePromise`オブジェクトを使用して入力画像ファイルとそのオプション設定を保持します。`mode`を`basic`、`moderate`、または`advanced`として指定し、属性を`true`または`false`に設定して分析を有効または無効にできます。 ![catalyst_facean_python](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_python.webp) Pythonでは、`analyse_face()`メソッドが引数として入力画像を受け取ります。分析モードを`basic`、`moderate`、または`advanced`として指定することもできます。また、属性`age`、`smile`、`gender`を`true`（検出する）または`false`（検出しない）として指定できます。これらの値はオプションです。デフォルトでは、すべての属性が検出され、`advanced`モードが処理されます。