本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 選擇元素 Amazon Textract 可以檢測選擇元素，如選項按鈕（單選按鈕）和文檔頁面上的複選框。選擇元素可以在[表單數據](how-it-works-kvp.md)和[表](how-it-works-tables.md)。例如，當在表單上檢測到下表時，Amazon Textract 會檢測到表格單元格中的複選框。 | | | | | | --- |--- |--- |--- | | | **同意** | **Neutral** | **不同意** | | **良好的服務** | ☑ | ☐ | ☐ | | **易於使用** | ☐ | ☑ | ☐ | | **合理價格** | ☑ | ☐ | ☐ | 檢測到的選擇元素返回為[Block](API_Block.md)響應中的對象[AnalyzeDocument](API_AnalyzeDocument.md)和[GetDocumentAnalysis](API_GetDocumentAnalysis.md)。 **注意** 您可以使用`FeatureTypes`輸入參數來檢索關於鍵值對、表或兩者的信息。例如，如果對錶進行篩選，則響應包括在表中檢測到的選擇元素。在鍵值對中檢測到的選擇元素不包括在響應中。 有關選擇元素的信息包含在`Block`類型 的物件`SELECTION_ELEMENT`。若要判定可選元素的狀態，請使用`SelectionStatus`欄位`SELECTION_ELEMENT`區塊。狀態可能是*選*或者*未選定*。例如，值為`SelectionStatus`對於上一個圖像是*選*。 一個`SELECTION_ELEMENT` `Block`對象與鍵值對或表格單元格相關聯。一個`SELECTION_ELEMENT` `Block`對象包含選擇元素的邊界框信息`Geometry`欄位。一個`SELECTION_ELEMENT` `Block`對象不是`PAGE` `Block`物件。 ## 表單數據（鍵值對） 鍵值對用於表示在表單上檢測到的選擇元素。所以此`KEY`塊包含選擇元素的文本。所以此`VALUE`塊包含選擇元素塊。下圖顯示選擇元素如何由[Block](API_Block.md)物件。 ![](http://docs.aws.amazon.com/zh_tw/textract/latest/dg/images/hieroglyph-key-value-set-selectable.png) 如需金鑰/值對的詳細資訊，請參[表單數據（鍵值對）](how-it-works-kvp.md)。 下面的 JSON 代碼段顯示了包含選擇元素 (**男性 ☑**。子代碼（編號為標識字符串）是包含選擇元素的文本塊的 ID（*男性*。該值的編號（編號為二十四分之一）是`VALUE`塊，其中包含`SELECTION_ELEMENT`塊物件。 ``` { "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 代碼片段是單詞*男性*。WORD 塊也有一個父線塊。 ``` { "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" }, ``` 值塊有一個子項（編號為 f2f5e8d-e73a-4e99-a095-053），它是選擇元素塊。 ``` { "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 是選擇元素塊。的值`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`塊，用於檢測到的文本。 ![](http://docs.aws.amazon.com/zh_tw/textract/latest/dg/images/hieroglyph-table-cell-selectable.png) 如需表的詳細資訊，請參[資料表](how-it-works-tables.md)。 該表`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" } ``` 儲存格`BLOCK`對象（編號為複選框的單元格）*良好的服務*看起來如下。它包括一個孩子`Block`（編號 = 二十二分之二）`SELECTION_ELEMENT` `Block`物件。 ``` { "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" } ``` 選擇元素`Block`對象如下所示。的值`SelectionStatus`指示已選取核取方塊。 ``` { "Geometry": {.......}, "BlockType": "SELECTION_ELEMENT", "SelectionStatus": "SELECTED", "Confidence": 88.79517364501953, "Id": "26d122fd-c5f4-4b53-92c4-0ae92730ee1e" } ```