

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 文本檢測和文檔分析響應對象
<a name="how-it-works-document-layout"></a>

當 Amazon Textract 處理文檔時，它會創建一個[Block](API_Block.md)對象，用於檢測到或分析的文本。每個區塊都包含有關檢測到的商品的信息、其所在位置以及 Amazon Textract 對處理準確性的信心。

文檔由以下類型的`Block`物件。
+ [頁面](how-it-works-pages.md)
+  [文本的行和單詞](how-it-works-lines-words.md) 
+  [表單數據（鍵值對）](how-it-works-kvp.md) 
+  [表格和單元格](how-it-works-tables.md) 
+ [選擇元素](how-it-works-selectables.md)

塊的內容取決於您調用的操作。如果調用其中一個文本檢測操作，則返回檢測到的文本的頁面、行和單詞。如需詳細資訊，請參閱 [偵測文字](how-it-works-detecting.md)。如果調用其中一個文檔分析操作，則返回有關檢測到的頁面、鍵值對、表格、選擇元素和文本的信息。如需詳細資訊，請參閱 [分析文檔](how-it-works-analyzing.md)。

一些`Block`物件欄位對於這兩類處理方式是相同的。例如，每個塊都有一個唯一的標識符。

如需的範例，示範如何使用`Block`對象，請參閲[教學課程](examples-blocks.md)。

## 文檔佈局
<a name="hows-it-works-blocks-types.title"></a>

Amazon Textract 返回一個文檔的表示形式，其中包含不同類型的`Block`在父子關係或鍵值對中鏈接的對象。還會返回提供文檔中頁數的元數據。以下為典型的`Block`類型 的物件`PAGE`。

```
{
    "Blocks": [
        {
            "Geometry": {
                "BoundingBox": {
                    "Width": 1.0, 
                    "Top": 0.0, 
                    "Left": 0.0, 
                    "Height": 1.0
                }, 
                "Polygon": [
                    {
                        "Y": 0.0, 
                        "X": 0.0
                    }, 
                    {
                        "Y": 0.0, 
                        "X": 1.0
                    }, 
                    {
                        "Y": 1.0, 
                        "X": 1.0
                    }, 
                    {
                        "Y": 1.0, 
                        "X": 0.0
                    }
                ]
            }, 
            "Relationships": [
                {
                    "Type": "CHILD", 
                    "Ids": [
                        "2602b0a6-20e3-4e6e-9e46-3be57fd0844b", 
                        "82aedd57-187f-43dd-9eb1-4f312ca30042", 
                        "52be1777-53f7-42f6-a7cf-6d09bdc15a30", 
                        "7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c"
                    ]
                }
            ], 
            "BlockType": "PAGE", 
            "Id": "8136b2dc-37c1-4300-a9da-6ed8b276ea97"
        }..... 
        
    ], 
    "DocumentMetadata": {
        "Pages": 1
    }
}
```

文件由一或多個`PAGE`區塊。每個頁面都包含頁面上檢測到的主要項目的子塊列表，例如文本行和表格。如需詳細資訊，請參閱 [頁面](how-it-works-pages.md)。

您可以判斷`Block`對象，方法是檢查`BlockType`欄位。

一個`Block`物件包含相關`Block`中的物件`Relationships`字段，它是一個[Relationship](API_Relationship.md)物件。一個`Relationships`數組的類型為「子」或「值」類型。CIDER 類型的數組用於列出作為當前塊子項的項目。例如，如果目前塊類型為 LINE，`Relationships`包含組成文本行的 WORD 塊的 ID 列表。VALUE 類型的陣列用於包含鍵/值對。您可以通過檢查`Type`欄位`Relationship`物件。

子塊沒有關於其父塊對象的信息。

對於顯示`Block`信息，請參閲[使用同步操作處理文檔](sync.md)。

## 信賴度
<a name="how-it-works-confidence"></a>

Amazon Textract 操作會傳回 Amazon Textract 對於商品精確度的可信度百分比。要獲得信心，請使用`Confidence`欄位`Block`物件。值越大代表置信度越大。根據不同的場景，可信度低的檢測可能需要人類的視覺確認。

## Geometry
<a name="how-it-works-geometry"></a>

Amazon Textract 操作（身份分析除外）會返回有關文檔頁面上檢測到商品位置的位置信息。若要獲取位置，請使用`Geometry`欄位`Block`物件。如需詳細資訊，請參閱「」[文檔頁面上的項目位置](text-location.md) 

# 頁面
<a name="how-it-works-pages"></a>

文件包含一或多個頁面。一個[Block](API_Block.md)類型 的物件`PAGE`存在於文檔的每個頁面。一個`PAGE`塊對象包含文檔頁面上檢測到的文本行、鍵值對和表的子 ID 的列表。

![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/textract/latest/dg/images/hieroglyph-pages.png)


JSON`PAGE`塊結果類似如下。

```
{

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

如果要對 PDF 格式的多頁文檔使用異步操作，則可以通過檢查`Page`欄位`Block`物件。掃描的圖像（JPEG、PNG、PDF 或 TIFF 格式的圖像）被視為單頁文檔，即使圖像上有多個文檔頁面。異步操作總是返回`Page`值為 1，用於掃描的圖像。

頁面總數會返回到`Pages`欄位`DocumentMetadata`。`DocumentMetadata`返回的每個列表`Block`由 Amazon Textract 操作返回的對象。

# 文本的行和單詞
<a name="how-it-works-lines-words"></a>

由 Amazon Textract 操作返回的檢測到的文本將返回到[Block](API_Block.md)物件。這些對象表示在文檔頁面上檢測到的文本行或文本單詞。以下文本顯示了由多個單詞構成的兩行文本。

這是文字。

在兩個單獨的行。

檢測到的文本將在`Text`欄位`Block`物件。所以此`BlockType`字段確定文本是一行文本 (LINE) 還是單詞 (WORD)。一個*字*是一或多個 ISO 基本拉丁腳本字符，不以空格分隔。一個*線*是製表符分隔和連續單詞的字符串。

 此外，Amazon Textract 將確定一段文本是手寫還是使用`TextTypes`欄位。這些分別作為手寫和印刷返回。

其他`Block`屬性對於所有塊類型（例如 ID、置信度和幾何信息）都是通用的。如需詳細資訊，請參閱 [文本檢測和文檔分析響應對象](how-it-works-document-layout.md)。

要僅檢測行和單詞，您可以使用[DetectDocumentText](API_DetectDocumentText.md)或者[StartDocumentTextDetection](API_StartDocumentTextDetection.md)。如需詳細資訊，請參閱 [偵測文字](how-it-works-detecting.md)。要獲取檢測到的文本（行和單詞）以及有關它與文檔其他部分（如表格）相關的信息，您可以使用[AnalyzeDocument](API_AnalyzeDocument.md)或者[StartDocumentAnalysis](API_StartDocumentAnalysis.md)。如需詳細資訊，請參閱 [分析文檔](how-it-works-analyzing.md)。

`PAGE`、`LINE`，以及`WORD`塊在父-子關係中彼此相關。一個`PAGE`塊是所有`LINE`塊文檔頁面上的對象。因為 LINE 可以有一個或多個單詞，`Relationships`數組存儲組成文本行的子 WORD 塊的 ID。

下圖顯示*Hello world.*在文字*Hello world.* *你怎麼樣*表示為`Block`物件。

![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/textract/latest/dg/images/hieroglyph-text-detection.png)




以下為來自`DetectDocumentText`當句子*Hello world.* *你怎麼樣*被檢測到。第一個示例是文檔頁面的 JSON。請注意孩子 ID 如何使您能夠在文檔中導航。

```
{
    "Geometry": {...}, 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "d7fbd604-d609-4d69-857d-247a3f591238", // Line - Hello, world.
                "b6c19a93-6493-4d8e-958f-853c8f7ca055" //  Line - How are you?
            ]
        }
    ], 
    "BlockType": "PAGE", 
    "Id": "56ec1d77-171f-4881-9852-2b5b7e761608"
},
```

以下是組成行「你好，世界」的 LINE 塊的 JSON：

```
{
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "7f97e2ca-063e-47a8-981c-8beee31afc01", // Word - Hello,
                "4b990aa0-af96-4369-b90f-dbe02538ed21"  // Word - world.
            ]
        }
    ], 
    "Confidence": 99.63229370117188, 
    "Geometry": {...}, 
    "Text": "Hello, world.", 
    "BlockType": "LINE", 
    "Id": "d7fbd604-d609-4d69-857d-247a3f591238"
},
```

以下是 WORD 塊的 JSON*Hello last*：

```
{
    "Geometry": {...}, 
    "Text": "Hello,", 
    "TextType": "PRINTED",
    "BlockType": "WORD", 
    "Confidence": 99.74746704101562, 
    "Id": "7f97e2ca-063e-47a8-981c-8beee31afc01"
},
```

最後的 JSON 是單詞的 WORD 塊*世界。*：

```
{
    "Geometry": {...}, 
    "Text": "world.",
    "TextType": "PRINTED",
    "BlockType": "WORD", 
    "Confidence": 99.5171127319336, 
    "Id": "4b990aa0-af96-4369-b90f-dbe02538ed21"
},
```

# 表單數據（鍵值對）
<a name="how-it-works-kvp"></a>

Amazon Textract 可以從文件中提取表單數據作為鍵/值對。例如，在以下的文字中，Amazon Textract 可以識別金鑰 (*名稱:*）和一個值（*安娜·卡羅萊納州*。

名稱: 安娜·卡羅萊納州

檢測到的金鑰值組返回為[Block](API_Block.md)響應中的對象[AnalyzeDocument](API_AnalyzeDocument.md)和[GetDocumentAnalysis](API_GetDocumentAnalysis.md)。您可以使用`FeatureTypes`輸入參數來檢索關於鍵值對、表或兩者的信息。僅對於鍵值對，請使用值`FORMS`。如需範例，請參閱 [從表單文檔中提取鍵值對](examples-extract-kvp.md)。如需文件如何由`Block`對象，請參閲[文本檢測和文檔分析響應對象](how-it-works-document-layout.md)。

類型為 KEY\$1VALUE\$1SET 的塊對象是用於存儲文檔中檢測到的鏈接文本項的信息的鍵或值塊對象的容器。您可以使用`EntityType`屬性來確定塊是 KEY 還是值。
+ 一個*鍵*物件包含鏈接文字鍵的資訊。例如：*名稱:*。KEY 塊有兩個關係列表。VALUE 類型的關係是一個列表，其中包含與該鍵相關聯的 VALUE 塊的 ID。類型的關係是組成鍵文本的 WORD 塊的 ID 列表。
+ 一個*值*物件包含與鍵相關的文字的資訊。在上述範例中，*安娜·卡羅萊納州*是鍵的值。*名稱:*。VALUE 塊與標識 WORD 塊的子塊列表存在關係。每個 WORD 塊包含組成值文本的單詞之一。一個`VALUE`物件也可以包含選取元素的資訊。如需詳細資訊，請參閱 [選擇元素](how-it-works-selectables.md)。

鍵值集的每個實例`Block`物件是 PAGE 的子項`Block`對象，該對應於當前頁面。

下圖顯示鍵/值對*名稱: 安娜·卡羅萊納州*表示為`Block`物件。

![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/textract/latest/dg/images/hieroglyph-key-value-set.png)


以下範例會示範鍵/值對*名稱: 安娜·卡羅萊納州*由 JSON 表示。

頁面塊具有類型為`KEY_VALUE_SET`對於文檔中檢測到的每個鍵和值塊。

```
{
    "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 顯示了密鑰塊（52be1777-53f7-4f6-4f6-a7c）與值塊有關係（7ca7Ca6-00EF -41a-51a-5571a7c）。它還有一個用於單詞塊的子塊（c734fca6-c4c4-415-b6c1-30f7510b72ee），其中包含密鑰的文本（*名稱:*。

```
{
    "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 顯示值塊 7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c 具有組成值文本的字塊的子 ID 列表 (*安娜*和*卡羅萊納州*。

```
{
    "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 顯示了`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"
},
```

# 資料表
<a name="how-it-works-tables"></a>

Amazon Textract 可以提取表格中的表格和單元格。例如，當在表單上檢測到下表時，Amazon Textract 會檢測到包含四個單元格的表格。


| 名稱 | Address | 
| --- | --- | 
|  安娜·卡羅萊納州  |  123 任何城市  | 

檢測到的表返回為[Block](API_Block.md)響應中的對象[AnalyzeDocument](API_AnalyzeDocument.md)和[GetDocumentAnalysis](API_GetDocumentAnalysis.md)。您可以使用`FeatureTypes`輸入參數來檢索關於鍵值對、表或兩者的信息。僅對於表格，請使用值`TABLES`。如需範例，請參閱 [將資料表導出為 CSV 檔](examples-export-table-csv.md)。如需文件如何由`Block`對象，請參閲[文本檢測和文檔分析響應對象](how-it-works-document-layout.md)。

下圖顯示表中的單個單元格如何由`Block`物件。

![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/textract/latest/dg/images/hieroglyph-table-cell.png)


單元格包含`WORD`用於檢測到的單詞的塊，以及`SELECTION_ELEMENT`塊的選擇元素（如複選框）。

以下是前面的表（包含四個單元格）的部分 JSON。

頁面塊對象具有 TABLE 塊和檢測到的每行文本的子塊 ID 的列表。

```
{
    "Geometry": {...}, 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "f2a4ad7b-f21d-4966-b548-c859b84f66a4",   // Line - Name
                "4dce3516-ffeb-45e0-92a2-60770e9cb744",   // Line  - Address 
                "ee506578-768f-4696-8f4b-e4917e429f50",   // Line - Ana Carolina
                "33fc7223-411b-4399-8a90-ccd3c5a2c196",   // Line  - 123 Any Town
                "3f9665be-379d-4ae7-be44-d02f32b049c2"    // Table
            ]
        }
    ], 
    "BlockType": "PAGE", 
    "Id": "78c3ce84-ae70-418e-add7-27058418adf6"
},
```

TABLE 塊包含表中單元格的子 ID 列表。TABLE 塊還包括文檔中表位置的幾何信息。下面的 JSON 顯示該表包含四個單元格，這些單元格在`Ids`陣列。

```
{
    "Geometry": {...}, 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "505e9581-0d1c-42fb-a214-6ff736822e8c", 
                "6fca44d4-d3d3-46ab-b22f-7fca1fbaaf02", 
                "9778bd78-f3fe-4ae1-9b78-e6d29b89e5e9", 
                "55404b05-ae12-4159-9003-92b7c129532e"
            ]
        }
    ], 
    "BlockType": "TABLE", 
    "Confidence": 92.5705337524414, 
    "Id": "3f9665be-379d-4ae7-be44-d02f32b049c2"
},
```

表單元格的塊類型為 CELL。所以此`Block`對象包含與表中其他單元格相比的有關單元格位置的信息。它還包括單元格在文檔上位置的幾何信息。在上述範例中，`505e9581-0d1c-42fb-a214-6ff736822e8c`是包含單詞的單元格的子 ID*名稱*。以下示例是單元格的信息。

```
{
    "Geometry": {...}, 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "e9108c8e-0167-4482-989e-8b6cd3c3653e"
            ]
        }
    ], 
    "Confidence": 100.0, 
    "RowSpan": 1, 
    "RowIndex": 1, 
    "ColumnIndex": 1, 
    "ColumnSpan": 1, 
    "BlockType": "CELL", 
    "Id": "505e9581-0d1c-42fb-a214-6ff736822e8c"
},
```

每個單元格在表中都有一個位置，第一個單元格是 1,1。在上述範例中，值為*名稱*位於第 1 行，第 1 列。具有值的單元格*123 任何城市*位於第 2 行，第 2 列。單元格塊對象包含此信息在`RowIndex`和`ColumnIndex`和 欄位之間沒有任何差異。子列表包含包含單元格中的文本的 WORD 塊對象的 ID。列表中的單詞按照檢測到的順序，從單元格的左上角到單元格右下角。在上面的示例中，單元格具有一個子 ID，其值為 e9108c8e-0167-4482-989e-8c3e。下面的輸出是用於 ID 值為 E9108c8e-0167-4482-989-89-8cd3e 的字詞塊：

```
"Geometry": {...}, 
"Text": "Name", 
"TextType": "Printed",
"BlockType": "WORD",
"Confidence": 99.81139373779297, 
"Id": "e9108c8e-0167-4482-989e-8b6cd3c3653e"
},
```

# 選擇元素
<a name="how-it-works-selectables"></a>

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`物件。

## 表單數據（鍵值對）
<a name="how-it-works-selectable-kvp"></a>

鍵值對用於表示在表單上檢測到的選擇元素。所以此`KEY`塊包含選擇元素的文本。所以此`VALUE`塊包含選擇元素塊。下圖顯示選擇元素如何由[Block](API_Block.md)物件。

![\[alt text not found\]](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"
}
```

## 表格
<a name="how-it-works-selectable-table"></a>

Amazon Textract 可以檢測表格單元格中的選擇元素。例如，下表中的單元格具有複選框。


|  |  |  |  | 
| --- |--- |--- |--- |
|     |  **同意**  |  **Neutral**  |  **不同意**  | 
|  **良好的服務**  |  ☑  |  ☐  |  ☐  | 
|  **易於使用**  |  ☐  |  ☑  |  ☐  | 
|  **合理價格**  |  ☑  |  ☐  |  ☐  | 

一個`CELL`塊可以包含子項`SELECTION_ELEMENT`選擇元素的對象，以及子`WORD`塊，用於檢測到的文本。

![\[alt text not found\]](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"
}
```