View a markdown version of this page

表单数据（Key-Value 对） - Amazon Textract

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

表单数据（Key-Value 对）

亚马逊 Textract 可以以键值对的形式从文档中提取表单数据。例如，在以下文本中，亚马逊 Textract 可以识别密钥（名称:）和值（安娜·卡罗来纳州）。

姓名：安娜·卡罗来纳

检测到的键值对在和的响应中作为 Block 对象返回。 AnalyzeDocument GetDocumentAnalysis 您可以使用FeatureTypes输入参数来检索有关键值对、表或两者的信息。仅对于键值对，请使用该值。FORMS有关示例，请参阅从表单文档中提取 Key-Value 配对。有关如何用Block对象表示文档的一般信息，请参见文本检测和文档分析响应对象。

通过键值对检测找到的日期将与输入文档中检测到的日期完全相同，支持大多数日期格式。

类型为 KEY_VALUE_SET 的块对象是 KEY 或 VALUE 块对象的容器，这些对象存储有关在文档中检测到的链接文本项目的信息。您可以使用该EntityType属性来确定一个方块是密钥还是值。

  • KEY 对象包含有关链接文本密钥的信息。例如，名称：。一个 KEY 区块有两个关系列表。类型为 VALUE 的关系是一个包含与密钥关联的 VALUE 块的 ID 的列表。CHILD 类型的关系是构成密钥文本的 WORD 块的 ID 列表。

  • VALUE 对象包含有关与密钥关联的文本的信息。在前面的示例中，安娜·卡罗来纳是密钥名称:的值。VALUE 区块与标识 WORD 区块的子块列表有关系。每个 WORD 块都包含一个构成值文本的单词。VALUE对象还可以包含有关选定元素的信息。有关更多信息，请参阅 选择元素。

亚马逊 Textract 为 KEY_VALUE_SET 中的密钥和值返回相同的置信度值，因为密钥和值都是成对计算的。它为 WORD 块中的单词返回不同的置信度值。

KEY_VALUE_SE Block T 对象的每个实例都是与当前页面对应的 PAGE Block 对象的子对象。

下图显示了对象如何表示键值对 Name: Ana Carolin a。Block

该图描绘了数据库表的结构，该表的页面包含键和值，其中键是 “名称：”、“Ana” 和 “Carolina” 等字样。

以下示例显示了 JSON 如何表示键值对名称：安娜·卡罗来纳州。

KEY_VALUE_SET对于文档中检测到的每个 KEY 和 VALUE 块，PAGE 块都有类型为 CHILD 块的子块。

{
    "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 区块（52be1777-53f7-42f6-a7cf-6d09bdc15a30）与 VALUE 区块（7ca7ca6-00ef-00ef-4cda-b1aa-5571dfed1a7c）有关系。它还有一个 WORD 方块（c734fca6-c4c4-415c-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 显示，VALUE 区块 7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c 具有构成该值文本的 WORD 块（安娜和卡罗来纳州）的子级 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 显示了 Name: 、 Ana 和 Carolina 这两个词的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"
},