Anotasi batch file secara offline

Vision API dapat mendeteksi fitur Vision API apa pun dari file PDF dan TIFF yang disimpan di Cloud Storage.

Deteksi fitur dari PDF dan TIFF harus diminta menggunakan fungsi files:asyncBatchAnnotate, yang menjalankan permintaan offline (asinkron) dan memberikan statusnya menggunakan resource operations.

Output dari permintaan PDF/TIFF ditulis ke file JSON yang dibuat di dalam bucket Cloud Storage yang ditentukan.

Batasan

Vision API menerima file PDF/TIFF hingga 2000 halaman. File yang lebih besar akan menampilkan error.

Autentikasi

Kunci API tidak didukung untuk permintaan files:asyncBatchAnnotate. Baca Menggunakan akun layanan untuk petunjuk tentang cara mengautentikasi dengan akun layanan.

Akun yang digunakan untuk autentikasi harus memiliki akses ke bucket Cloud Storage yang Anda tentukan untuk output (roles/editor atau roles/storage.objectCreator atau lebih tinggi).

Anda dapat menggunakan kunci API untuk membuat kueri status operasi; lihat bagian Menggunakan kunci API untuk mendapatkan petunjuk.

Permintaan deteksi fitur

Saat ini deteksi dokumen PDF/TIFF hanya tersedia untuk file yang disimpan di bucket Cloud Storage. Respons file JSON juga disimpan ke bucket Cloud Storage.

Command-line

Untuk melakukan deteksi teks dokumen PDF/TIFF, buat permintaan POST dan berikan isi permintaan yang sesuai:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
https://vision.googleapis.com/v1/files:asyncBatchAnnotate -d "{
  'requests':[
    {
      'inputConfig': {
        'gcsSource': {
          'uri': 'gs://your-source-bucket-name/folder/multi-page-file.pdf'
        },
        'mimeType': 'application/pdf'
      },
      'features': [
        {
          'type': 'DOCUMENT_TEXT_DETECTION'
        }
      ],
      'outputConfig': {
        'gcsDestination': {
          'uri': 'gs://your-bucket-name/folder/'
        },
        'batchSize': 1
      }
    }
  ]
}"

Di mana:

  • inputConfig - menggantikan kolom image yang digunakan dalam permintaan Vision API lainnya. Permintaan ini berisi dua kolom turunan:

    • gcsSource.uri - Cloud Storage URI dari file PDF atau TIFF (dapat diakses oleh pengguna atau akun layanan yang membuat permintaan)
    • mimeType - salah satu jenis file yang diterima: application/pdf atau image/tiff.
  • outputConfig - menentukan detail output. Kode ni berisi dua kolom turunan:

    • gcsDestination.uri - Cloud Storage URI yang valid. Bucket harus dapat ditulis oleh pengguna atau akun layanan yang membuat permintaan. Nama filenya adalah output-x-to-y, dengan x dan y mewakili nomor halaman PDF/TIFF yang disertakan dalam file output tersebut. Jika file tersebut ada, isinya akan ditimpa.
    • batchSize - menentukan jumlah halaman output yang harus disertakan di setiap output file JSON.

Respons: