GetDocumentTextDetection

獲取用於檢測文檔中文本的 Amazon Textract 異步操作的結果。Amazon Textract 可以檢測文本行和構成一行文本的單詞。

您可以通過調用StartDocumentTextDetection，它返回一個作業標識符（JobId。當文本檢測操作完成後，Amazon Textract 會向亞馬遜 Simple Notification Service (Amazon SNS) 主題發佈完成狀態，該主題在初始調用StartDocumentTextDetection。要獲取文本檢測操作的結果，請首先檢查發佈到 Amazon SNS 主題的狀態值是否為SUCCEEDED。如果是這樣，請調用GetDocumentTextDetection，並傳遞作業標識符（JobId）從初始調用到StartDocumentTextDetection。

GetDocumentTextDetection傳回一個Block物件。

每個文檔頁面都有一個關聯的Block類型為頁面。每頁Block物件是 LINE 的父項Block對象，表示頁面上檢測到的文本行。一條線Block對象是構成該行的每個單詞的父項。單詞表示為Block類型為 WORD 的對象。

使用 MaxResults 參數來限制傳回的塊數量。如果結果多於MaxResults，值NextToken在操作響應中包含一個用於取得下一組結果的分頁符記。若要取得下一頁的結果，請調用GetDocumentTextDetection，然後填入NextToken請求參數與上一次調用返回的令牌值GetDocumentTextDetection。

如需詳細資訊，請參閱「」文件文字偵測。

請求語法


{
   "JobId": "string",
   "MaxResults": number,
   "NextToken": "string"
}

請求參數

請求接受採用 JSON 格式的下列資料。

JobId

文字偵測任務的唯一識別符。所以此JobId從傳回StartDocumentTextDetection。一個JobId值僅在 7 天內有效。

類型：字串

長度限制：長度下限為 1。長度上限為 64。

模式：^[a-zA-Z0-9-_]+$

：必要是

MaxResults

每筆分頁呼叫傳回結果的數量上限。您可以指定的最大值為 1,000。如果您指定的值大於 1,000，最多只能傳回 1,000 個結果。預設值為 1,000。

類型：整數

有效範圍：最小值為 1。

：必要否

NextToken

如果之前的響應不完整（因為有更多要檢索的塊），Amazon Textract 會在響應中返回一個分頁令牌。您可以使用此分頁符記來取回下一組塊。

類型：字串

長度限制：長度下限為 1。長度上限為 255。

模式：.*\S.*

：必要否

回應語法


{
   "Blocks": [ 
      { 
         "BlockType": "string",
         "ColumnIndex": number,
         "ColumnSpan": number,
         "Confidence": number,
         "EntityTypes": [ "string" ],
         "Geometry": { 
            "BoundingBox": { 
               "Height": number,
               "Left": number,
               "Top": number,
               "Width": number
            },
            "Polygon": [ 
               { 
                  "X": number,
                  "Y": number
               }
            ]
         },
         "Id": "string",
         "Page": number,
         "Relationships": [ 
            { 
               "Ids": [ "string" ],
               "Type": "string"
            }
         ],
         "RowIndex": number,
         "RowSpan": number,
         "SelectionStatus": "string",
         "Text": "string",
         "TextType": "string"
      }
   ],
   "DetectDocumentTextModelVersion": "string",
   "DocumentMetadata": { 
      "Pages": number
   },
   "JobStatus": "string",
   "NextToken": "string",
   "StatusMessage": "string",
   "Warnings": [ 
      { 
         "ErrorCode": "string",
         "Pages": [ number ]
      }
   ]
}