Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # DetectDocumentText Rileva il testo nel documento di input. Amazon Textract è in grado di rilevare le righe di testo e le parole che costituiscono una riga di testo. Il documento di input deve essere un'immagine in formato JPEG, PNG, PDF o TIFF.`DetectDocumentText`restituisce il testo rilevato in una matrice di[Block](API_Block.md)oggetti. Ogni pagina del documento ha come associato`Block`di tipo PAGE. Ogni PAGINA`Block`object è il padre di LINE`Block`oggetti che rappresentano le righe del testo rilevato in una pagina. RIGA DI`Block`object è un genitore per ogni parola che compone la riga. Le parole sono rappresentate da`Block`oggetti di tipo WORD. `DetectDocumentText`è un'operazione sincrona. Per analizzare i documenti in modo asincrono, utilizzare[StartDocumentTextDetection](API_StartDocumentTextDetection.md). Per ulteriori informazioni, consulta[Rilevamento del documento](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html). ## Sintassi della richiesta ``` { "Document": { "Bytes": blob, "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } } } ``` ## Parametri della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [Document](#API_DetectDocumentText_RequestSyntax) ** Il documento di input come byte con codifica base64 o un oggetto Amazon S3. Se usi la CLI di AWS per chiamare le operazioni di Amazon Textract, non puoi passare byte immagine. Il documento deve essere un'immagine in formato JPEG o PNG. Se utilizzi un SDK AWS per chiamare Amazon Textract, potrebbe non essere necessario codificare in base a 64 byte immagine che vengono passati utilizzando il`Bytes`. Tipo: [Document](API_Document.md) oggetto Campo obbligatorio: Sì ## Sintassi della risposta ``` { "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 } } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [Blocks](#API_DetectDocumentText_ResponseSyntax) ** Una matrice di`Block`oggetti che contengono il testo rilevato nel documento. Type: Array di[Block](API_Block.md)oggetti ** [DetectDocumentTextModelVersion](#API_DetectDocumentText_ResponseSyntax) ** Type: Stringa ** [DocumentMetadata](#API_DetectDocumentText_ResponseSyntax) ** Metadati sul documento. Contiene il numero di pagine rilevate nel documento. Tipo: [DocumentMetadata](API_DocumentMetadata.md) oggetto ## Errori ** AccessDeniedException ** Non sei autorizzato a eseguire l'operazione. Utilizzare l'ARN (Amazon Resource Name) di un utente autorizzato o un ruolo IAM per eseguire l'operazione. Codice di stato HTTP: 400 ** BadDocumentException ** Amazon Textract non è in grado di leggere il documento. Per ulteriori informazioni sui limiti dei documenti in Amazon Textract, consulta[Limiti rigidi per Amazon Textract](limits.md). Codice di stato HTTP: 400 ** DocumentTooLargeException ** Il documento non può essere elaborato perché è troppo grande. La dimensione massima dei documenti per operazioni sincrone 10 MB. La dimensione massima del documento per le operazioni asincrone è di 500 MB per i file PDF. Codice di stato HTTP: 400 ** InternalServerError ** Amazon Textract ha riscontrato un problema del servizio. Riprova la chiamata. Codice di stato HTTP: 500 ** InvalidParameterException ** Un parametro di input ha violato un vincolo. Ad esempio, nelle operazioni sincrone, un`InvalidParameterException`eccezione si verifica quando nessuno dei due`S3Object`o`Bytes`i valori sono forniti nel`Document`parametro della richiesta. Convalida il parametro prima di chiamare nuovamente l'operazione API. Codice di stato HTTP: 400 ** InvalidS3ObjectException ** Amazon Textract non è in grado di accedere all'oggetto S3 specificato nella richiesta. Per ulteriori informazioni,[Configura l'accesso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Per informazioni sulla risoluzione dei problemi, consulta[Risoluzione dei problemi Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html) Codice di stato HTTP: 400 ** ProvisionedThroughputExceededException ** Il numero di richieste ha superato il limite di throughput. Per aumentare questo limite, contatta Amazon Textract. Codice di stato HTTP: 400 ** ThrottlingException ** Amazon Textract non è temporaneamente in grado di elaborare la richiesta. Riprova la chiamata. Codice di stato HTTP: 500 ** UnsupportedDocumentException ** Il formato del documento di input non è supportato. I documenti per le operazioni possono essere in formato PNG, JPEG, PDF o TIFF. Codice di stato HTTP: 400 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: + [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/DetectDocumentText) + [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/DetectDocumentText) + [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/DetectDocumentText) + [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/DetectDocumentText) + [AWSSDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/DetectDocumentText) + [SDK AWS per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/DetectDocumentText) + [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/DetectDocumentText) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/DetectDocumentText) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/DetectDocumentText)