フォームデータ (キーと値のペア)

Amazon Textract は、キーと値のペアとしてドキュメントからフォームデータを抽出できます。たとえば、次のテキストでは、Amazon Textract はキー (名前:) と値 (Ana Carolina) を識別できます。

名前: Ana Carolina

検出されたキーと値のペアは、AnalyzeDocument と GetDocumentAnalysis からのレスポンスでブロックオブジェクトとして返されます。FeatureTypes 入力パラメータを使用して、キーと値のペア、テーブル、またはその両方に関する情報を取得できます。キーと値のペアのみ、値 を使用しますFORMS。例については、フォームドキュメントからのキーと値のペアの抽出を参照してください。オブジェクトによってドキュメントがどのように表されるかに関する一般的な情報についてはBlock、「」を参照してくださいテキスト検出およびドキュメント分析レスポンスオブジェクト。

キーと値のペアの検出で見つかった日付は、入力ドキュメントで検出されたとおりに正確に返され、ほとんどの日付形式がサポートされています。

KEY_VALUE_SET タイプのブロックオブジェクトは、ドキュメント内で検出されたリンクされたテキスト項目に関する情報を保存する KEY または VALUE Block オブジェクトのコンテナです。EntityType 属性を使用して、ブロックが KEY であるか VALUE であるかを判断できます。

Amazon Textract は、KEY と VALUE の両方がペアとして評価されるため、KEY_VALUE_SET の KEY と VALUE の両方に同じ信頼値を返します。単語の異なる信頼値を WORD ブロックで返します。

KEY_VALUE_SET Block オブジェクトの各インスタンスは、現在のページに対応する PAGE Block オブジェクトの子です。

次の図は、キーと値のペアの名前: Ana Carolina がBlockオブジェクトでどのように表されるかを示しています。

次の例は、キーと値のペアの名前: Ana Carolina が JSON で表される方法を示しています。

PAGE ブロックには、ドキュメント内で検出された KEY ブロックと VALUE ブロックKEY_VALUE_SETごとに タイプの CHILD ブロックがあります。

{
    "Geometry": .... 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "2602b0a6-20e3-4e6e-9e46-3be57fd0844b", 
                "82aedd57-187f-43dd-9eb1-4f312ca30042", 
                "52be1777-53f7-42f6-a7cf-6d09bdc15a30", // Key - Name:
                "7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c"  // Value - Ana Caroline 
            ]
        }
    ], 
    "BlockType": "PAGE", 
    "Id": "8136b2dc-37c1-4300-a9da-6ed8b276ea97"  // Page identifier
},

次の JSON は、KEY ブロック (52be1777-53f7-42f6-a7cf-6d09bdc15a30) が VALUE ブロック (7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c) と関係していることを示しています。また、キー (名前:) のテキストを含む WORD ブロック (c734fca6-c4c4-415c-b6c1-30f7510b72ee) の CHILD ブロックもあります。

{
    "Relationships": [
        {
            "Type": "VALUE", 
            "Ids": [
                "7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c"  // Value identifier
            ]
        }, 
        {
            "Type": "CHILD", 
            "Ids": [
                "c734fca6-c4c4-415c-b6c1-30f7510b72ee"  // Name:
            ]
        }
    ], 
    "Confidence": 51.55965805053711, 
    "Geometry": ...., 
    "BlockType": "KEY_VALUE_SET", 
    "EntityTypes": [
        "KEY"
    ], 
    "Id": "52be1777-53f7-42f6-a7cf-6d09bdc15a30"  //Key identifier
},

次の JSON は、VALUE ブロック 7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c に、値のテキスト (Ana と Carolina) を構成する WORD ブロックの IDs の CHILD リストがあることを示しています。

{
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "db553509-64ef-4ecf-ad3c-bea62cc1cd8a", // Ana
                "e5d7646c-eaa2-413a-95ad-f4ae19f53ef3"  // Carolina
            ]
        }
    ], 
    "Confidence": 51.55965805053711, 
    "Geometry": ...., 
    "BlockType": "KEY_VALUE_SET", 
    "EntityTypes": [
        "VALUE"
    ], 
    "Id": "7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c" // Value identifier
}

次の JSON は、Name、Ana、および Carolina という単語のBlockオブジェクトを示しています。

{
    "Geometry": {...}, 
    "Text": "Name:", 
    "TextType": "PRINTED".
    "BlockType": "WORD", 
    "Confidence": 99.56285858154297, 
    "Id": "c734fca6-c4c4-415c-b6c1-30f7510b72ee"
},
 {
    "Geometry": {...}, 
    "Text": "Ana", 
    "TextType": "PRINTED",
    "BlockType": "WORD", 
    "Confidence": 99.52057647705078, 
    "Id": "db553509-64ef-4ecf-ad3c-bea62cc1cd8a"
}, 
{
    "Geometry": {...}, 
    "Text": "Carolina", 
    "TextType": "PRINTED",
    "BlockType": "WORD", 
    "Confidence": 99.84207916259766, 
    "Id": "e5d7646c-eaa2-413a-95ad-f4ae19f53ef3"
},