翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Textract レスポンスオブジェクト
Amazon Textract オペレーションは、実行するオペレーションに応じて異なるタイプのオブジェクトを返します。テキストを検出し、一般文書を分析する場合、この操作は Block オブジェクトを返します。請求書または領収書を分析するために、オペレーションは expenseDocuments オブジェクトを返します。アイデンティティドキュメントを分析するために、この操作は IdentityDocumentFields オブジェクトを返します。これらの応答オブジェクトの詳細については、以下のセクションを参照してください。
**Topics**
+ [テキスト検出および文書分析応答オブジェクト](how-it-works-document-layout.md)
+ [請求書および領収書応答オブジェクト](expensedocuments.md)
+ [ID ドキュメントの応答オブジェクト](identitydocumentfields.md)
# テキスト検出および文書分析応答オブジェクト
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)。
## ドキュメントレイアウト
Amazon Textract は、ドキュメントの表現をさまざまなタイプのリストとして返します。`Block`親子関係またはキーと値のペアでリンクされているオブジェクト。ドキュメント内のページ数を示すメタデータも返されます。以下に、一般的な JSON を示します。`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
}
}
```
ドキュメントは、1 つ以上のもので作成されます。`PAGE`ブロック。各ページには、テキスト行や表など、ページで検出されたプライマリアイテムの子ブロックのリストが含まれています。詳細については、「[ページ](how-it-works-pages.md)」を参照してください。
のタイプを判断できます。`Block`オブジェクトを検査して`BlockType`フィールド。
ある`Block`オブジェクトには関連のリストが含まれています。`Block`のオブジェクト`Relationships`フィールド。これは、の配列です。[Relationship](API_Relationship.md)オブジェクト。ある`Relationships`配列は CHILD 型または VALUE 型のいずれかです。CHILD 型の配列は、現在のブロックの子である項目を一覧表示するために使用されます。たとえば、現在のブロックのタイプが LINE の場合、`Relationships`テキスト行を構成する WORD ブロックの ID のリストが含まれます。VALUE 型の配列は、キーと値のペアを格納するために使用されます。関係のタイプを調べて、関係の種類を判断できます。`Type`のフィールド`Relationship`オブジェクト。
子ブロックには、親ブロックオブジェクトに関する情報がありません。
示す例については`Block`詳細については、を参照してください。[同期操作によるドキュメントの処理](sync.md)。
## Confidence
Amazon Textract オペレーションは、検出された商品の精度に対する Amazon Textract の信頼度のパーセンテージを返します。信頼を得るには、`Confidence`のフィールド`Block`オブジェクト。値が高いほど、信頼度が高いことを示します。シナリオによっては、信頼性の低い検出では、人間による視覚的な確認が必要になる場合があります。
## ジオメトリ
Amazon Textract オペレーションは、ID 分析を除き、ドキュメントページ上で検出されたアイテムの場所に関する位置情報を返します。場所を取得するには、`Geometry`のフィールド`Block`オブジェクト。詳細については、「」を参照してください。[ドキュメントページ上のアイテムの場所](text-location.md)
# ページ
ドキュメントは 1 ページ以上で構成されます。ある[Block](API_Block.md)型のオブジェクト`PAGE`ドキュメントの各ページに存在します。ある`PAGE`ブロックオブジェクトには、ドキュメントページで検出されたテキスト行、キーと値のペア、およびテーブルの子 ID のリストが含まれます。
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/textract/latest/dg/images/hieroglyph-pages.png)
の JSON`PAGE`block は次の例のようになります。
```
{
"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 オペレーションによって返されるオブジェクト。
# テキストの行と単語
Amazon Textract オペレーションによって返される検出されたテキストは、[Block](API_Block.md)オブジェクト。これらのオブジェクトは、文書ページで検出されたテキスト行またはテキスト単語を表します。次のテキストは、複数の単語から作成された 2 行のテキストを示しています。
これはテキストです。
2 つの別々の行で。
検出されたテキストは`Text`のフィールド`Block`オブジェクト。-`BlockType`フィールドでは、テキストがテキスト行 (LINE) または単語 (WORD) のどちらであるかを指定します。ある*単語*スペースで区切られていない、1 個以上の 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は1つ以上の単語を持つことができるため、`Relationships`LINE ブロックの配列は、テキスト行を構成する子の WORD ブロックの ID を格納します。
次の図は、この線の仕組みを示しています。*Hello world*のテキスト*Hello world お元気ですか？*で表される。`Block`オブジェクト。
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/textract/latest/dg/images/hieroglyph-text-detection.png)
以下に、からの JSON 出力を示します。`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"
},
```
以下は、「Hello, World」という行を構成する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,*:
```
{
"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"
},
```
# フォームデータ (キーと値のペア)
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 型のブロックオブジェクトは、文書内で検出されたリンクされたテキストアイテムに関する情報を格納する KEY または VALUE ブロックオブジェクトのコンテナです。♪`EntityType`属性を使用して、ブロックがKEYかVALUEかを決定します。
+ ある*キー*オブジェクトには、リンクテキストのキーに関する情報が含まれています。たとえば、*名前:*。KEY ブロックには 2 つのリレーションシップリストがあります。VALUE 型の関係は、キーに関連付けられた VALUE ブロックの ID を含むリストです。CHILD 型の関係は、キーのテキストを構成する WORD ブロックの ID のリストです。
+ ある*値*オブジェクトには、キーに関連付けられているテキストに関する情報が含まれています。前の例では、以下のようになっています。*アナ・カロライナ*キーの値はです。*名前:*。VALUE ブロックは、WORD ブロックを識別する CHILD ブロックのリストとの関係を持ちます。各 WORD ブロックには、値のテキストを構成する単語の 1 つが含まれています。ある`VALUE`オブジェクトには、選択した要素に関する情報を含めることもできます。詳細については、「[選択エレメント](how-it-works-selectables.md)」を参照してください。
KEY\$1VALUE\$1SET の各インスタンス`Block`オブジェクトはページの子です`Block`現在のページに対応するオブジェクト。
次の図は、キーと値のペアの仕組みを示しています。*名前: アナ・カロライナ*で表される。`Block`オブジェクト。
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/textract/latest/dg/images/hieroglyph-key-value-set.png)
次の例は、キーと値のペアの仕組みを示しています。*名前: アナ・カロライナ*は JSON で表されます。
PAGE ブロックにはタイプの CHILD ブロックがあります`KEY_VALUE_SET`ドキュメント内で検出された KEY および VALUE ブロックごとに。
```
{
"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ブロック (52be177-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 に、値のテキストを構成する単語ブロックの 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"
},
```
# テーブル
Amazon Textract は、テーブルおよびテーブル内のセルを抽出できます。たとえば、フォームで次のテーブルが検出されると、Amazon Textract は 4 つのセルを含むテーブルを検出します。
| [Name] (名前) | Address |
| --- | --- |
| アナ・カロライナ | 123 Any Town |
検出されたテーブルは次のように返されます。[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)。
次の図は、表内の 1 つのセルがどのように表されるかを示しています。`Block`オブジェクト。
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/textract/latest/dg/images/hieroglyph-table-cell.png)
セルの内容`WORD`検出された単語のブロック、および`SELECTION_ELEMENT`チェックボックスなどの選択要素のブロック。
次に、4 つのセルがある前のテーブルの部分 JSON を示します。
PAGE ブロックオブジェクトには、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 は、テーブルに 4 つのセルがあることを示しています。`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"
},
```
表のセルの [ブロックタイプ] は [セル] です。-`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 Any Town*は行 2、列 2 にあります。セルブロックオブジェクトには、この情報が`RowIndex`そして`ColumnIndex`フィールド。子リストには、セル内のテキストを含む WORD Block オブジェクトの ID が含まれます。リスト内の単語は、セルの左上からセルの右下まで、検出された順に表示されます。前の例では、セルに値 e9108c8e-0167-4482-989e-8b6cd3c3653e を持つ子 ID があります。次の出力は、E9108c8e-0167-4482-989e-8b6cd3c3653e のワードブロックに対するものです。
```
"Geometry": {...},
"Text": "Name",
"TextType": "Printed",
"BlockType": "WORD",
"Confidence": 99.81139373779297,
"Id": "e9108c8e-0167-4482-989e-8b6cd3c3653e"
},
```
# 選択エレメント
Amazon Textract では、ドキュメントページのオプションボタン (ラジオボタン) やチェックボックスなどの選択要素を検出できます。選択エレメントはで検出できます[フォームデータ](how-it-works-kvp.md)そしてで[テーブル](how-it-works-tables.md)。たとえば、フォームで次の表が検出されると、Amazon Textract はテーブルのセル内のチェックボックスを検出します。
| | | | |
| --- |--- |--- |--- |
| | **同意** | **普通** | **反対する** |
| **優れたサービス** | ☑ | ☐ | ☐ |
| **使いやすさ** | ☐ | ☑ | ☐ |
| **公正価格** | ☑ | ☐ | ☐ |
検出された選択要素は、次のように返されます。[Block](API_Block.md)からの応答内のオブジェクト[AnalyzeDocument](API_AnalyzeDocument.md)そして[GetDocumentAnalysis](API_GetDocumentAnalysis.md)。
**注記**
♪`FeatureTypes`キーと値のペア、テーブル、またはその両方に関する情報を取得するための入力パラメータ。たとえば、テーブルでフィルタリングすると、テーブルで検出された選択エレメントが応答に含まれます。キーと値のペアで検出された選択要素は、応答に含まれません。
選択要素に関する情報は、`Block`型のオブジェクト`SELECTION_ELEMENT`。選択可能な要素のステータスを確認するには、`SelectionStatus`のフィールド`SELECTION_ELEMENT`ブロック。このステータスは、*選択された*または*NOT\$1SELECTED*。たとえば、の値`SelectionStatus`前のイメージは*選択された*。
ある`SELECTION_ELEMENT` `Block`オブジェクトは、キーと値のペアまたはテーブルセルのいずれかに関連付けられています。ある`SELECTION_ELEMENT` `Block`オブジェクトには、選択エレメントのバウンディングボックス情報が`Geometry`フィールド。ある`SELECTION_ELEMENT` `Block`オブジェクトは a の子ではありません`PAGE` `Block`オブジェクト。
## フォームデータ (キーと値のペア)
キーと値のペアは、フォーム上で検出された選択要素を表すために使用されます。-`KEY`block には、選択要素のテキストが含まれます。-`VALUE`ブロックには SELECTION\$1ELEMENT ブロックが含まれます。次の図は、選択要素がどのように表示されるかを示しています。[Block](API_Block.md)オブジェクト。
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/textract/latest/dg/images/hieroglyph-key-value-set-selectable.png)
キーと値のペアの詳細については、「」を参照してください。[フォームデータ (キーと値のペア)](how-it-works-kvp.md)。
次の JSON スニペットは、選択要素 () を含むキーと値のペアのキーを示しています。**male ☑**). 子 ID (ID bd14cfd5-9005-498b-a7f3-45ceb171f0ff) は、選択要素のテキストを含む単語ブロックのIDです (*男性*). 値ID (ID 24aaac7f-fcce-49c7-a4f0-3688b05586d4) は、`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 ブロックです。*男*。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\$1ELEMENT ブロックである子 (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\$1ELEMENT ブロックです。の価値`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 は、テーブルセル内の選択要素を検出できます。たとえば、次の表のセルにはチェックボックスがあります。
| | | | |
| --- |--- |--- |--- |
| | **同意** | **普通** | **反対する** |
| **優れたサービス** | ☑ | ☐ | ☐ |
| **使いやすさ** | ☐ | ☑ | ☐ |
| **公正価格** | ☑ | ☐ | ☐ |
ある`CELL`ブロックには子を含めることができます。`SELECTION_ELEMENT`選択エレメントのオブジェクト、および子エレメントのオブジェクト`WORD`検出されたテキストのブロック。
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/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`チェックボックスが含まれるセルのオブジェクト (ID c63ad40d-5a14-4646-a8df-2d4304213dbc) を指定します。*優れたサービス*次のようになります。子供も含まれます`Block`（Id = 26d122fd-c5f4-4b53-92c4-0ae92730ee1e）とは`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"
}
```
SELECTION\$1ELEMENT`Block`チェックボックスのオブジェクトは次のとおりです。の価値`SelectionStatus`チェックボックスがオンになっていることを示します。
```
{
"Geometry": {.......},
"BlockType": "SELECTION_ELEMENT",
"SelectionStatus": "SELECTED",
"Confidence": 88.79517364501953,
"Id": "26d122fd-c5f4-4b53-92c4-0ae92730ee1e"
}
```
# 請求書および領収書応答オブジェクト
AnalyzeExpense API に請求書または領収書を送信すると、一連の expenseDocuments オブジェクトが返されます。各 expenseDocument は、`LineItemGroups`そして`SummaryFields`。ほとんどの請求書および領収書には、仕入先名、受入番号、受入日、合計金額などの情報が含まれています。AnalyzeExpense はこの情報を`SummaryFields`。領収書と請求書には、購入した商品に関する詳細も含まれています。AnalyzeExpense API はこの情報を`LineItemGroups`。-`ExpenseIndex`フィールドは、経費を一意に識別し、適切なものを関連付けます`SummaryFields`そして`LineItemGroups`その費用で検出されました。
AnalyzeExpense レスポンスの最も詳細なデータレベルは、`Type`,`ValueDetection`, および`LabelDetection`(オプション). 個々のエンティティは次のとおりです。
+ [[Type] (タイプ)](how-it-works-type.md): ハイレベルで検出される情報の種類を示します。
+ [ラベル検出](how-it-works-labeldetection.md)：ドキュメントのテキスト内の関連する値のラベルを参照します。`LabelDetection`はオプションで、ラベルが書き込まれた場合にのみ返されます。
+ [値検出](how-it-works-valuedetection.md): 返されるラベルまたは型の値を参照します。
AnalyzeExpense API も検出します。`ITEM`,`QUANTITY`, および`PRICE`正規化されたフィールドとしてラインアイテム内。SKU や詳細な説明など、領収書画像上の行項目に他のテキストがある場合は、次のようにJSONに含まれます。`EXPENSE_ROW`以下の例に示すように、
```
{
"Type": {
"Text": "EXPENSE_ROW",
"Confidence": 99.95216369628906
},
"ValueDetection": {
"Text": "Banana 5 $2.5",
"Geometry": {
…
},
"Confidence": 98.11214447021484
}
```
上の例は、AnalyzeExpense API が 2.5 ドルで販売された 5 つのバナナに関するラインアイテム情報を含む領収書の行全体を返す方法を示しています。
# [Type] (タイプ)
以下に、キーと値のペアの標準型または正規化されたタイプの例を示します。
```
{
"PageNumber": 1,
"Type": {
"Text": "VENDOR_NAME",
"Confidence": 70.0
},
"ValueDetection": {
"Geometry": { ... },
"Text": "AMAZON",
"Confidence": 87.89806365966797
}
}
```
領収書には「ベンダー名」が明示的にリストされていませんでした。ただし、経費の分析 API は文書を領収書として認識し、値「AMAZON」をタイプとして分類しました。`VENDOR_NAME`。
# ラベル検出
以下は、顧客ドキュメントページに表示されるテキストの例です。
```
{
"PageNumber": 1,
"Type": {
"Text": "OTHER",
"Confidence": 70.0
},
"LabelDetection": {
"Geometry": { ... },
"Text": "CASHIER",
"Confidence": 88.19171142578125
},
"ValueDetection": {
"Geometry": { ... },
"Text": "Mina",
"Confidence": 87.89806365966797
}
}
```
例文書には「CASHIER Mina」が含まれていました。経費の分析 API は、現状の値を抽出して、`LabelDetection`。レシートに「キー」が明示的に表示されていない「ベンダー名」などの暗黙的な値については、`LabelDetection`AnalyzeExpense 要素には含まれません。このような場合、AnalyzeExpense API は返されません。`LabelDetection`。
# 値検出
以下に、キーと値のペアの「値」の例を示します。
```
{
"PageNumber": 1,
"Type": {
"Text": "OTHER",
"Confidence": 70.0
},
"LabelDetection": {
"Geometry": { ... },
"Text": "CASHIER",
"Confidence": 88.19171142578125
},
"ValueDetection": {
"Geometry": { ... },
"Text": "Mina",
"Confidence": 87.89806365966797
}
}
```
この例では、文書には「CASHIER Mina」が含まれていました。AnalyzeExpense API はキャッシャーの値を Mina として検出し、`ValueDetection`。
# ID ドキュメントの応答オブジェクト
AnalyzeID API にアイデンティティドキュメントを送信すると、一連のドキュメントが返されます。`IdentityDocumentField`オブジェクト。これらの各オブジェクトには次のものが含まれます。`Type`, および`Value`。`Type`Amazon Textract が検出した正規化フィールドを記録します。`Value`正規化フィールドに関連付けられたテキストを記録します。
以下に、`IdentityDocumentField`、簡潔にするために短縮されます。
```
{
"DocumentMetadata": {
"Pages": 1
},
"IdentityDocumentFields": [
{
"Type": {
"Text": "first name"
},
"ValueDetection": {
"Text": "jennifer",
"Confidence": 99.99908447265625
}
},
{
"Type": {
"Text": "last name"
},
"ValueDetection": {
"Text": "sample",
"Confidence": 99.99758911132812
}
},
```
IdentityDocumentFields は、長い応答から切り取られた 2 つの例です。検出された型とその型の値の間には区切りがあります。ここでは、それぞれ姓名です。この構造は、含まれているすべての情報で繰り返されます。型が正規化フィールドとして認識されない場合は、「other」としてリストされます。
以下は、運転免許証の正規化されたフィールドのリストです。
+ 名
+ 姓
+ ミドルネーム
+ サフィックス
+ 住所の市区町村
+ 住所の郵便番号
+ 住所の状態
+ 郡
+ ドキュメント番号
+ 有効期限日
+ 生年月日
+ ステート名
+ 発行日
+ class
+ 制限
+ 保証
+ ID タイプ ID
+ ベテラン
+ アドレス
米国パスポートの正規化フィールドのリストを以下に示します。
+ 名
+ 姓
+ ミドルネーム
+ ドキュメント番号
+ 有効期限日
+ 生年月日
+ 生年月日
+ 発行日
+ ID タイプ ID