SearchFaces - Amazon Rekognition

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

SearchFaces

指定された入力顔 ID について、その顔が属するコレクション内の一致する顔を検索します。フェイス ID は、コレクションにフェイスを追加するときにIndexFacesオペレーション. この操作は、入力面のフィーチャを指定されたコレクション内の面と比較します。

注記

また、フェースをインデックス化せずにフェースを検索するには、SearchFacesByImageオペレーション.

操作応答は、一致する面の配列を、類似度が最も高い類似度スコアで順に返します。具体的には、見つかった各顔一致のメタデータの配列です。メタデータとともに、応答にはconfidenceの値で、特定の面が入力面に一致するという信頼度を示します。

例については、「フェイス ID を使用したフェイスの検索」を参照してください。

このオペレーションには rekognition:SearchFaces アクションを実行するアクセス許可が必要です。

リクエストの構文

{ "CollectionId": "string", "FaceId": "string", "FaceMatchThreshold": number, "MaxFaces": number }

リクエストパラメータ

リクエストは以下のデータを JSON 形式で受け入れます。

コレクション ID

顔が属するコレクションの ID。

タイプ: 文字列

長さの制限: 最小長は 1 です。 最大長は 255 です。

パターン: [a-zA-Z0-9_.\-]+

: 必須 はい

フェイス ID

コレクション内で一致するものを検索する顔の ID。

タイプ: 文字列

パターン: [0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

: 必須 はい

フェイスマッチングスレッショルド

返される顔一致の最小信頼度を指定するオプションの値。たとえば、一致の信頼度が 70% 未満の場合は、一致を返さないでください。デフォルト値は 80% です。

タイプ: 浮動小数点

有効範囲: 最小値は 0 です。最大値は 100 です。

: 必須 いいえ

MaxFaces

返される顔の最大数。この操作は、一致の信頼度が最も高い面の最大数を返します。

タイプ: 整数

有効範囲: 最小値は 1 です。最大値は 4096 の最大値はです。

: 必須 いいえ

レスポンスの構文

{ "FaceMatches": [ { "Face": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Confidence": number, "ExternalImageId": "string", "FaceId": "string", "ImageId": "string" }, "Similarity": number } ], "FaceModelVersion": "string", "SearchedFaceId": "string" }

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

フェイスマッチ

入力面に一致した面の配列と、一致の信頼度です。

タイプ: の配列FaceMatchobjects

FaceModelVersion

入力コレクションに関連付けられている顔検出モデルのバージョン番号 (CollectionId).

タイプ: 文字列

検索されたフェイス ID

コレクション内で一致を検索した顔の ID。

タイプ: 文字列

パターン: [0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Errors

AccessDeniedException

アクションを実行する権限がありません。

HTTP ステータスコード: 400

InternalServerError

Amazon Rekognition でサービスの問題が発生しました。もう一度やり直してください。

HTTP ステータスコード: 500

InvalidParameterException

入力パラメータが制約に違反しています。API オペレーションを再度呼び出す前にパラメータを検証します。

HTTP ステータスコード: 400

ProvisionedThroughputExceededException

お客様のスループット制限を超えたリクエストの数。この上限を引き上げる場合は、Amazon Rekognition itionまでお問い合わせください。

HTTP ステータスコード: 400

ResourceNotFoundException

リクエストで指定されたリソースが見つかりません。

HTTP ステータスコード: 400

ThrottlingException

Amazon Rekognition は一時的にリクエストを処理できませんでした。もう一度やり直してください。

HTTP ステータスコード: 500

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。