View a markdown version of this page

選択要素 - Amazon Textract
フォームデータ (キーと値のペア)テーブルセル

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

選択要素

Amazon Textract は、ドキュメントページのオプションボタン (ラジオボタン）、チェックボックス、下線、円で囲まれたテキストなどの選択要素を検出できます。選択要素は、フォームデータとテーブルで検出できます。たとえば、フォームで次のテーブルが検出されると、Amazon Textract はテーブルセルのチェックボックスを検出します。

同意する

[Neutral] (ニュートラル)

同意しない

グッドサービス

☑

☐

☐

使いやすい

☐

☑

☐

適正価格

☑

☐

☐

検出された選択要素は、AnalyzeDocument および GetDocumentAnalysis からのレスポンスでブロックオブジェクトとして返されます。

以下は、Amazon Textract でサポートされているさまざまな選択可能なタイプの例を示す表です。

選択可能なタイプ

例

ラジオボタン

はい「いいえ」

[Checkbox] (チェックボックス)

はい ☐ いいえ ☑

下線付き単語

はい いいえ

丸で囲まれた単語

Two buttons labeled "Yes" and "No" for making a binary choice.

クロスアウトされた単語

Two buttons labeled "Yes" and "No", with "No" crossed out in blue.

さらに、Amazon Textract は、暗黙的なクリック可能ファイル、または質問として構造化され、いくつかの回答のいずれかをマークして回答されたクリック可能ファイルを検出できます。これらは、クリック可能ファイルと同じ方法で返されます。

注記

FeatureTypes 入力パラメータを使用して、キーと値のペア、テーブル、またはその両方に関する情報を取得できます。たとえば、テーブルでフィルタリングする場合、レスポンスにはテーブルで検出された選択要素が含まれます。キーと値のペアで検出された選択要素は、レスポンスに含まれません。

選択要素に関する情報は、タイプ のBlockオブジェクトに含まれていますSELECTION_ELEMENT。選択可能な要素のステータスを確認するには、 SELECTION_ELEMENTブロックの SelectionStatusフィールドを使用します。ステータスは SELECTED または NOT_SELECTED のいずれかです。たとえば、前のイメージSelectionStatusの の値は SELECTED です。

SELECTION_ELEMENT Block オブジェクトは、キーと値のペアまたはテーブルセルに関連付けられます。SELECTION_ELEMENT Block オブジェクトには、 Geometryフィールドの選択要素の境界ボックス情報が含まれます。SELECTION_ELEMENT Block オブジェクトはPAGEBlockオブジェクトの子ではありません。

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

キーと値のペアは、フォームで検出された選択要素を表すために使用されます。KEY ブロックには、選択要素のテキストが含まれます。VALUE ブロックには SELECTION_ELEMENT ブロックが含まれています。次の図は、選択要素がブロックオブジェクトでどのように表されるかを示しています。

キーと値のペアのデータ構造を使用したフォーム上の選択要素の表現を示す図。KEY にはテキスト、VALUE には SELECTION_ELEMENT、PAGE が親オブジェクトとして含まれています。

キーと値のペアの詳細については、「」を参照してくださいフォームデータ (キーと値のペア)。

次の JSON スニペットは、選択要素 (男性 ☑) を含むキーと値のペアのキーを示しています。子 ID (Id bd14cfd5-9005-498b-a7f3-45ceb171f0ff) は、選択要素 (男性) のテキストを含む WORD ブロックの ID です。値 ID (Id 24aaac7f-fcce-49c7-a4f0-3688b05586d4) は、VALUEブロックオブジェクトを含むSELECTION_ELEMENTブロックの ID です。

{
    "Relationships": [
        {
            "Type": "VALUE", 
            "Ids": [
                "24aaac7f-fcce-49c7-a4f0-3688b05586d4"  // Value containing Selection Element
            ]
        }, 
        {
            "Type": "CHILD", 
            "Ids": [
                "bd14cfd5-9005-498b-a7f3-45ceb171f0ff"  // WORD - male
            ]
        }
    ], 
    "Confidence": 94.15619659423828, 
    "Geometry": {
        "BoundingBox": {
            "Width": 0.022914813831448555, 
            "Top": 0.08072036504745483, 
            "Left": 0.18966935575008392, 
            "Height": 0.014860388822853565
        }, 
        "Polygon": [
            {
                "Y": 0.08072036504745483, 
                "X": 0.18966935575008392
            }, 
            {
                "Y": 0.08072036504745483, 
                "X": 0.21258416771888733
            }, 
            {
                "Y": 0.09558075666427612, 
                "X": 0.21258416771888733
            }, 
            {
                "Y": 0.09558075666427612, 
                "X": 0.18966935575008392
            }
        ]
    }, 
    "BlockType": "KEY_VALUE_SET", 
    "EntityTypes": [
        "KEY"
    ], 
    "Id": "a118dc43-d5f7-49a2-a20a-5f876d9ffd79"
}

次の JSON スニペットは、Male という単語の WORD ブロックです。WORD ブロックには親 LINE ブロックもあります。

{
    "Geometry": {
        "BoundingBox": {
            "Width": 0.022464623674750328, 
            "Top": 0.07842985540628433, 
            "Left": 0.18863198161125183, 
            "Height": 0.01617223583161831
        }, 
        "Polygon": [
            {
                "Y": 0.07842985540628433, 
                "X": 0.18863198161125183
            }, 
            {
                "Y": 0.07842985540628433, 
                "X": 0.2110965996980667
            }, 
            {
                "Y": 0.09460209310054779, 
                "X": 0.2110965996980667
            }, 
            {
                "Y": 0.09460209310054779, 
                "X": 0.18863198161125183
            }
        ]
    }, 
    "Text": "Male", 
    "BlockType": "WORD", 
    "Confidence": 54.06439208984375, 
    "Id": "bd14cfd5-9005-498b-a7f3-45ceb171f0ff"
},

VALUE ブロックには、SELECTION_ELEMENT ブロックである子 (Id f2f5e8cd-e73a-4e99-a095-053acd3b6bfb) があります。

{
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "f2f5e8cd-e73a-4e99-a095-053acd3b6bfb"  // Selection element
            ]
        }
    ], 
    "Confidence": 94.15619659423828, 
    "Geometry": {
        "BoundingBox": {
            "Width": 0.017281491309404373, 
            "Top": 0.07643391191959381, 
            "Left": 0.2271782010793686, 
            "Height": 0.026274094358086586
        }, 
        "Polygon": [
            {
                "Y": 0.07643391191959381, 
                "X": 0.2271782010793686
            }, 
            {
                "Y": 0.07643391191959381, 
                "X": 0.24445968866348267
            }, 
            {
                "Y": 0.10270800441503525, 
                "X": 0.24445968866348267
            }, 
            {
                "Y": 0.10270800441503525, 
                "X": 0.2271782010793686
            }
        ]
    }, 
    "BlockType": "KEY_VALUE_SET", 
    "EntityTypes": [
        "VALUE"
    ], 
    "Id": "24aaac7f-fcce-49c7-a4f0-3688b05586d4"
}, 
}

次の JSON は SELECTION_ELEMENT ブロックです。の値は、チェックボックスが選択されているSelectionStatusことを示します。

{
    "Geometry": {
        "BoundingBox": {
            "Width": 0.020316146314144135, 
            "Top": 0.07575977593660355, 
            "Left": 0.22590067982673645, 
            "Height": 0.027631107717752457
        }, 
        "Polygon": [
            {
                "Y": 0.07575977593660355, 
                "X": 0.22590067982673645
            }, 
            {
                "Y": 0.07575977593660355, 
                "X": 0.2462168186903
            }, 
            {
                "Y": 0.1033908873796463, 
                "X": 0.2462168186903
            }, 
            {
                "Y": 0.1033908873796463, 
                "X": 0.22590067982673645
            }
        ]
    }, 
    "BlockType": "SELECTION_ELEMENT", 
    "SelectionStatus": "SELECTED", 
    "Confidence": 74.14942932128906, 
    "Id": "f2f5e8cd-e73a-4e99-a095-053acd3b6bfb"
}

テーブルセル

Amazon Textract は、テーブルセル内の選択要素を検出できます。たとえば、次の表のセルにはチェックボックスがあります。

同意する

[Neutral] (ニュートラル)

同意しない

グッドサービス

☑

☐

☐

使いやすい

☐

☑

☐

適正価格

☑

☐

☐

CELL ブロックには、選択要素の子SELECTION_ELEMENTオブジェクトと検出されたテキストの子WORDブロックを含めることができます。

ページ、テーブル、セル、単語、選択要素のコンポーネントを含むページレイアウトの階層構造を示す図。

テーブルの詳細については、「」を参照してくださいテーブル。

前のテーブルの TABLE Block オブジェクトは次のようになります。

{
    "Geometry": {.....}, 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "652c09eb-8945-473d-b1be-fa03ac055928", 
                "37efc5cc-946d-42cd-aa04-e68e5ed4741d", 
                "4a44940a-435a-4c5c-8a6a-7fea341fa295", 
                "2de20014-9a3b-4e26-b453-0de755144b1a", 
                "8ed78aeb-5c9a-4980-b669-9e08b28671d2", 
                "1f8e1c68-2c97-47b2-847c-a19619c02ca9", 
                "9927e1d1-6018-4960-ac17-aadb0a94f4d9", 
                "68f0ed8b-a887-42a5-b618-f68b494a6034", 
                "fcba16e0-6bd7-4ea5-b86e-36e8330b68ea", 
                "2250357c-ae34-4ed9-86da-45dac5a5e903", 
                "c63ad40d-5a14-4646-a8df-2d4304213dbc",   // Cell
                "2b8417dc-e65f-4fcd-aa0f-61a23f1e8cb0", 
                "26c62932-72f0-4dc2-9893-1ae27829c060", 
                "27f291cc-abf4-4c23-aa24-676abe99cb1e", 
                "7e5ce028-1bcd-4d9f-ad42-15ac181c5b47", 
                "bf32e3d2-efa2-4fc1-b09b-ab9cc52ff734"
            ]
        }
    ], 
    "BlockType": "TABLE", 
    "Confidence": 99.99993896484375, 
    "Id": "f66eac36-2e74-406e-8032-14d1c14e0b86"
}

チェックボックス Good Service を含むセルの CELL BLOCK オブジェクト (Id c63ad40d-5a14-4646-a8df-2d4304213dbc) は次のようになります。これには、チェックボックスのSELECTION_ELEMENTBlockオブジェクトである子 Block (Id = 26d122fd-c5f4-4b53-92c4-0ae92730ee1e) が含まれます。

{
    "Geometry": {.....}, 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "26d122fd-c5f4-4b53-92c4-0ae92730ee1e"  // Selection Element
            ]
        }
    ], 
    "Confidence": 79.741689682006836, 
    "RowSpan": 1, 
    "RowIndex": 3, 
    "ColumnIndex": 3, 
    "ColumnSpan": 1, 
    "BlockType": "CELL", 
    "Id": "c63ad40d-5a14-4646-a8df-2d4304213dbc"
}

チェックボックスの SELECTION_ELEMENT Block オブジェクトは次のとおりです。の値は、チェックボックスが選択されているSelectionStatusことを示します。

{
    "Geometry": {.......}, 
    "BlockType": "SELECTION_ELEMENT", 
    "SelectionStatus": "SELECTED", 
    "Confidence": 88.79517364501953, 
    "Id": "26d122fd-c5f4-4b53-92c4-0ae92730ee1e"
}