Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # AnalyzeDocument Menganalisis dokumen masukan untuk hubungan antara item yang terdeteksi. Jenis informasi yang dikembalikan adalah sebagai berikut: + Data formulir (pasangan nilai kunci). Informasi terkait dikembalikan dalam dua[Block](API_Block.md)objek, masing-masing jenis`KEY_VALUE_SET`: KUNCI`Block`objek dan NILAI`Block`objek. Misalnya,*Nama: Ana Silva*berisi kunci dan nilai. *Nama:*adalah kuncinya. *Ana Silva*adalah nilai. + Tabel dan data sel tabel. TABEL`Block`objek berisi informasi tentang tabel terdeteksi. SEL`Block`objek dikembalikan untuk setiap sel dalam tabel. + Garis dan kata-kata teks. GARIS`Block`objek berisi satu atau lebih WORD`Block`objek. Semua baris dan kata-kata yang terdeteksi dalam dokumen dikembalikan (termasuk teks yang tidak memiliki hubungan dengan nilai`FeatureTypes`). Elemen seleksi seperti kotak centang dan tombol opsi (tombol radio) dapat dideteksi dalam data formulir dan dalam tabel. SELECTION\$1ELEMENT`Block`objek berisi informasi tentang elemen seleksi, termasuk status seleksi. Anda dapat memilih jenis analisis yang akan dilakukan dengan menentukan`FeatureTypes`daftar. Output dikembalikan dalam daftar`Block`objek. `AnalyzeDocument` adalah operasi tersinkron. Untuk menganalisis dokumen secara asinkron, gunakan[StartDocumentAnalysis](API_StartDocumentAnalysis.md). Untuk informasi selengkapnya, lihat[Analisis Teks Dokumen](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html). ## Sintaksis Permintaan ``` { "Document": { "Bytes": blob, "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } }, "FeatureTypes": [ "string" ], "HumanLoopConfig": { "DataAttributes": { "ContentClassifiers": [ "string" ] }, "FlowDefinitionArn": "string", "HumanLoopName": "string" } } ``` ## Parameter Permintaan Permintaan menerima data berikut dalam format JSON. ** [Document](#API_AnalyzeDocument_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, PNG, PDF, atau TIFF. 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 ** [FeatureTypes](#API_AnalyzeDocument_RequestSyntax) ** Daftar jenis analisis untuk melakukan. Tambahkan TABEL ke daftar untuk mengembalikan informasi tentang tabel yang terdeteksi dalam dokumen input. Tambahkan FORMS untuk mengembalikan data formulir yang terdeteksi. Untuk melakukan kedua jenis analisis, tambahkan TABEL dan FORM ke`FeatureTypes`. Semua baris dan kata yang terdeteksi dalam dokumen disertakan dalam respons (termasuk teks yang tidak terkait dengan nilai`FeatureTypes`). Jenis: Array string Nilai Valid:` TABLES | FORMS` Diperlukan: Ya ** [HumanLoopConfig](#API_AnalyzeDocument_RequestSyntax) ** Menetapkan konfigurasi untuk manusia dalam alur kerja loop untuk menganalisis dokumen. Tipe: Objek [HumanLoopConfig](API_HumanLoopConfig.md) Diperlukan: Tidak ## Sintaksis Respons ``` { "AnalyzeDocumentModelVersion": "string", "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" } ], "DocumentMetadata": { "Pages": number }, "HumanLoopActivationOutput": { "HumanLoopActivationConditionsEvaluationResults": "string", "HumanLoopActivationReasons": [ "string" ], "HumanLoopArn": "string" } } ``` ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200. Layanan mengembalikan data berikut dalam format JSON. ** [AnalyzeDocumentModelVersion](#API_AnalyzeDocument_ResponseSyntax) ** Versi model yang digunakan untuk menganalisis dokumen. Jenis: String ** [Blocks](#API_AnalyzeDocument_ResponseSyntax) ** Item yang terdeteksi dan dianalisis oleh`AnalyzeDocument`. Jenis: Array[Block](API_Block.md)objek ** [DocumentMetadata](#API_AnalyzeDocument_ResponseSyntax) ** Metadata tentang dokumen yang dianalisis. Contohnya adalah jumlah halaman. Tipe: Objek [DocumentMetadata](API_DocumentMetadata.md) ** [HumanLoopActivationOutput](#API_AnalyzeDocument_ResponseSyntax) ** Menunjukkan hasil yang menunjukkan manusia dalam evaluasi loop. Tipe: Objek [HumanLoopActivationOutput](API_HumanLoopActivationOutput.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 ** HumanLoopQuotaExceededException ** Menunjukkan bahwa Anda telah melebihi jumlah maksimum manusia aktif dalam alur kerja loop yang tersedia 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, sebuah`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 di salah satu bahasa khususAWSSDK, lihat yang berikut ini: + [AWSAntarmuka Baris Perintah](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeDocument) + [AWSSDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeDocument) + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeDocument) + [AWSSDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeDocument) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeDocument) + [AWSSDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeDocument) + [AWSSDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeDocument) + [AWSSDK for Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeDocument) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeDocument)