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

# テキスト検出およびドキュメント分析レスポンスオブジェクト
<a name="how-it-works-document-layout"></a>

Amazon Textract がドキュメントを処理すると、検出または分析されたテキストの[ブロック](https://docs.aws.amazon.com/textract/latest/APIReference/API_Block.html)オブジェクトのリストが作成されます。各ブロックには、検出された項目に関する情報、その場所、および処理の精度に対する 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)
+ [クエリ](queryresponse.md)
+ [[レイアウト]](layoutresponse.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 は、parent-to-child関係またはキーと値のペアでリンクされているさまざまなタイプの`Block`オブジェクトのリストとしてドキュメントの表現を返します。ドキュメント内のページ数を提供するメタデータも返されます。タイプ の一般的な`Block`オブジェクトの JSON を次に示します`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
    }
}
```

ドキュメントは 1 つ以上の`PAGE`ブロックから作成されます。各ページには、テキストやテーブルの行など、ページで検出されたプライマリ項目の子ブロックのリストが含まれます。詳細については、「[ページ](how-it-works-pages.md)」を参照してください。

オブジェクトのタイプを確認するには、 `BlockType`フィールド`Block`を調べます。

`Block` オブジェクトには、[関係](https://docs.aws.amazon.com/textract/latest/APIReference/API_Relationship.html)`Block`オブジェクトの配列である `Relationships`フィールド内の関連オブジェクトのリストが含まれます。`Relationships` 配列は、CHILD 型または VALUE 型のいずれかです。CHILD 型の配列は、現在のブロックの子である項目を一覧表示するために使用されます。たとえば、現在のブロックが LINE 型の場合、 にはテキスト行を構成する WORD ブロックの IDs のリスト`Relationships`が含まれます。VALUE 型の配列は、キーと値のペアを含めるために使用されます。オブジェクトの `Type`フィールドを調べることで、関係のタイプを判断できます`Relationship`。

子ブロックには、親ブロックオブジェクトに関する情報がありません。

`Block` 情報を表示する例については、「」を参照してください[ドキュメントの同期処理](sync.md)。

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

Amazon Textract オペレーションは、検出された項目の精度に対する Amazon Textract の信頼度を返します。信頼度を取得するには、 `Block` オブジェクトの `Confidence`フィールドを使用します。値が高いほど、信頼度が高いことを示します。シナリオによっては、信頼性の低い検出では、人間による視覚的な確認が必要になる場合があります。

## [Geometry] (ジオメトリ)
<a name="how-it-works-geometry"></a>

Amazon Textract オペレーション (ID 分析を除く) は、ドキュメントページで検出された項目の場所に関する位置情報を返します。場所を取得するには、 `Block` オブジェクトの `Geometry`フィールドを使用します。詳細については、「[ドキュメントページで項目を検索する](text-location.md)」を参照してください。