Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# DetectDocumentText
Mendeteksi teks dalam dokumen input. Amazon Textract dapat mendeteksi baris teks dan kata-kata yang membentuk baris teks. Dokumen input harus berupa gambar dalam format JPEG, PNG, PDF, atau TIFF.`DetectDocumentText`mengembalikan teks terdeteksi dalam array[Block](API_Block.md)objek.
Setiap halaman dokumen memiliki sebagai terkait`Block`jenis HALAMAN. Setiap HALAMAN`Block`objek adalah induk dari LINE`Block`objek yang mewakili baris teks terdeteksi pada halaman. GARIS`Block`objek adalah orang tua untuk setiap kata yang membentuk baris. Kata-kata diwakili oleh`Block`objek tipe WORD.
`DetectDocumentText` adalah operasi tersinkron. Untuk menganalisis dokumen secara asinkron, gunakan[StartDocumentTextDetection](API_StartDocumentTextDetection.md).
Untuk informasi selengkapnya, lihat[Pendeteksi Teks Dokumen](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html).
## Sintaksis Permintaan
```
{
"Document": {
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
}
```
## Parameter Permintaan
Permintaan menerima data berikut dalam format JSON.
** [Document](#API_DetectDocumentText_RequestSyntax) **
Dokumen input sebagai byte yang dikodekan base64 atau objek Amazon S3. Jika Anda menggunakan AWS CLI untuk memanggil operasi Amazon Textract, Anda tidak dapat meneruskan byte citra. Dokumen harus berupa gambar dalam format JPEG atau PNG.
Jika Anda menggunakan AWS SDK untuk memanggil Amazon Textract, Anda mungkin tidak perlu byte citra yang dikodekan base64 yang diteruskan menggunakan`Bytes`Bidang.
Tipe: Objek [Document](API_Document.md)
Diperlukan: Ya
## Sintaksis Respons
```
{
"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
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [Blocks](#API_DetectDocumentText_ResponseSyntax) **
Susunan rangkaian`Block`objek yang berisi teks yang terdeteksi dalam dokumen.
Jenis: Array[Block](API_Block.md)objek
** [DetectDocumentTextModelVersion](#API_DetectDocumentText_ResponseSyntax) **
Jenis: String
** [DocumentMetadata](#API_DetectDocumentText_ResponseSyntax) **
Metadata tentang dokumen. Ini berisi jumlah halaman yang terdeteksi dalam dokumen.
Tipe: Objek [DocumentMetadata](API_DocumentMetadata.md)
## Kesalahan
** AccessDeniedException **
Anda tidak berwenang untuk melakukan tindakan. Gunakan Amazon Resource Name (ARN) dari pengguna resmi atau IAM role untuk melakukan operasi.
Kode Status HTTP: 400
** BadDocumentException **
Amazon Textract tidak dapat membaca dokumen. Untuk informasi selengkapnya tentang batas dokumen di Amazon Textract, lihat[Batas Keras di Amazon Textract](limits.md).
Kode Status HTTP: 400
** DocumentTooLargeException **
Dokumen tidak dapat diproses karena terlalu besar. Ukuran dokumen maksimum untuk operasi sinkron 10 MB. Ukuran dokumen maksimum untuk operasi asinkron adalah 500 MB untuk file PDF.
Kode Status HTTP: 400
** InternalServerError **
Amazon Textract Texact mengalami masalah layanan. Coba lagi panggilan Anda.
Kode Status HTTP: 500
** InvalidParameterException **
Parameter input melanggar batasan. Misalnya, dalam operasi sinkron,`InvalidParameterException`pengecualian terjadi ketika salah satu`S3Object`atau`Bytes`nilai-nilai yang disediakan dalam`Document`parameter permintaan. Validasi parameter Anda sebelum memanggil operasi API lagi.
Kode Status HTTP: 400
** InvalidS3ObjectException **
Amazon Textract Texact tidak dapat mengakses objek S3 yang ditentukan dalam permintaan. untuk informasi selengkapnya,[Konfigurasi Akses ke Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Untuk informasi pemecahan masalah, lihat[Pemecahan Masalah Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Kode Status HTTP: 400
** ProvisionedThroughputExceededException **
Jumlah permintaan melebihi batas throughput Anda. Jika Anda ingin meningkatkan batas ini, hubungi Amazon Textract.
Kode Status HTTP: 400
** ThrottlingException **
Amazon Textract Texact untuk sementara tidak dapat memproses permintaan. Coba lagi panggilan Anda.
Kode Status HTTP: 500
** UnsupportedDocumentException **
Format dokumen input tidak didukung. Dokumen untuk operasi dapat dalam format PNG, JPEG, PDF, atau TIFF.
Kode Status HTTP: 400
## Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu spesifik bahasaAWSSDK, lihat yang berikut ini:
+ [AWSAntarmuka Baris Perintah](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/DetectDocumentText)
+ [AWSSDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/DetectDocumentText)
+ [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/DetectDocumentText)
+ [AWSSDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/DetectDocumentText)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/DetectDocumentText)
+ [AWSSDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/DetectDocumentText)
+ [AWSSDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/DetectDocumentText)
+ [AWSSDK for Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/DetectDocumentText)
+ [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/DetectDocumentText)