Package google.cloud.vision.v1

Indeks

ImageAnnotator

Layanan yang menjalankan tugas deteksi Google Cloud Vision API pada gambar klien, seperti deteksi wajah, tempat terkenal, logo, label, dan teks. Layanan ImageAnnotator menampilkan entity yang terdeteksi dari gambar.

AsyncBatchAnnotateFiles

rpc AsyncBatchAnnotateFiles(AsyncBatchAnnotateFilesRequest) returns (Operation)

Menjalankan anotasi dan deteksi gambar asinkron untuk daftar file umum, seperti file PDF, yang dapat berisi beberapa halaman dan beberapa gambar per halaman. Progres dan hasil dapat diambil melalui antarmuka google.longrunning.Operations. Operation.metadata berisi OperationMetadata (metadata). Operation.response berisi AsyncBatchAnnotateFilesResponse (hasil).

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

AsyncBatchAnnotateImages

rpc AsyncBatchAnnotateImages(AsyncBatchAnnotateImagesRequest) returns (Operation)

Menjalankan anotasi dan deteksi gambar asinkron untuk daftar gambar.

Progres dan hasil dapat diambil melalui antarmuka google.longrunning.Operations. Operation.metadata berisi OperationMetadata (metadata). Operation.response berisi AsyncBatchAnnotateImagesResponse (hasil).

Layanan ini akan menulis output anotasi gambar ke file json di bucket Google Cloud Storage pelanggan, setiap file json yang berisi proto BatchAnnotateImagesResponse.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

BatchAnnotateFile

rpc BatchAnnotateFiles(BatchAnnotateFilesRequest) returns (BatchAnnotateFilesResponse)

Layanan yang menjalankan deteksi dan anotasi gambar untuk batch file. Sekarang hanya "application/pdf", "image/tiff" dan "image/gif" yang didukung.

Layanan ini akan mengekstrak maksimal 10 frame (gif) atau halaman pertama (pdf atau tiff) dari setiap file yang disediakan dan melakukan deteksi serta anotasi untuk setiap gambar yang diekstrak.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

BatchAnnotateImages

rpc BatchAnnotateImages(BatchAnnotateImagesRequest) returns (BatchAnnotateImagesResponse)

Menjalankan deteksi dan anotasi gambar untuk sekumpulan gambar.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

ProductSearch

Mengelola Products dan ProductSets gambar referensi untuk digunakan dalam penelusuran produk. Kode ini menggunakan model resource berikut:

  • API memiliki kumpulan resource ProductSet, bernama projects/*/locations/*/productSets/*, yang berfungsi sebagai cara untuk memasukkan berbagai produk ke dalam grup untuk membatasi identifikasi.

Secara paralel,

  • API memiliki koleksi resource Product, bernama projects/*/locations/*/products/*

  • Setiap Product memiliki kumpulan resource ReferenceImage, bernama projects/*/locations/*/products/*/referenceImages/*

{i>AddProductToProductSet<i}

rpc AddProductToProductSet(AddProductToProductSetRequest) returns (Empty)

Menambahkan Product ke ProductSet yang ditentukan. Jika Product sudah ada, tidak ada perubahan yang dilakukan.

Satu Produk dapat ditambahkan ke maksimal 100 ProductSets.

Kemungkinan error:

  • Menampilkan NOT_FOUND jika Product atau ProductSet tidak ada.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

CreateProduct

rpc CreateProduct(CreateProductRequest) returns (Product)

Membuat dan menampilkan resource produk baru.

Kemungkinan error:

  • Menampilkan INVALID_ARGUMENT jika display_name tidak ada atau lebih dari 4096 karakter.
  • Menampilkan INVALID_events jika deskripsi melebihi 4096 karakter.
  • Menampilkan INVALID_ARGUMENT jika product_category tidak ada atau tidak valid.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

CreateProductSet

rpc CreateProductSet(CreateProductSetRequest) returns (ProductSet)

Membuat dan menampilkan resource ProductSet baru.

Kemungkinan error:

  • Menampilkan INVALID_ARGUMENT jika display_name tidak ada, atau lebih panjang dari 4096 karakter.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

CreateReferenceImage

rpc CreateReferenceImage(CreateReferenceImageRequest) returns (ReferenceImage)

Membuat dan menampilkan resource ReferenceImage baru.

Kolom bounding_poly bersifat opsional. Jika bounding_poly tidak ditentukan, sistem akan mencoba mendeteksi wilayah yang diinginkan pada gambar yang kompatibel dengan product_category pada produk induk. Jika ditentukan, deteksi SELALU dilewati. Sistem mengonversi poligon menjadi persegi panjang yang tidak diputar.

Perhatikan bahwa pipeline akan mengubah ukuran gambar jika resolusi gambar terlalu besar untuk diproses (di atas 50 MP).

Kemungkinan error:

  • Menampilkan INVALID_ARGUMENT jika image_uri tidak ada atau lebih dari 4096 karakter.
  • Menampilkan INVALID_ARGUMENT jika produk tidak ada.
  • Menampilkan INVALID_ANCHOR jika bounding_poly tidak diberikan, dan tidak ada yang kompatibel dengan product_category produk induk yang terdeteksi.
  • Menampilkan INVALID_ARGUMENT jika bounding_poly berisi lebih dari 10 poligon.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

DeleteProduct

rpc DeleteProduct(DeleteProductRequest) returns (Empty)

Menghapus produk dan gambar referensinya secara permanen.

Metadata produk dan semua gambarnya akan segera dihapus, tetapi kueri penelusuran terhadap ProductSets yang berisi produk mungkin masih berfungsi sampai semua cache terkait diperbarui.

Kemungkinan error:

  • Menampilkan NOT_FOUND jika produk tidak ada.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

DeleteProductSet

rpc DeleteProductSet(DeleteProductSetRequest) returns (Empty)

Menghapus ProductSet secara permanen. Produk dan ReferenceImages di ProductSet tidak dihapus.

File gambar yang sebenarnya tidak dihapus dari Google Cloud Storage.

Kemungkinan error:

  • Menampilkan NOT_FOUND jika ProductSet tidak ada.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

DeleteReferenceImage

rpc DeleteReferenceImage(DeleteReferenceImageRequest) returns (Empty)

Menghapus gambar referensi secara permanen.

Metadata gambar akan segera dihapus, tetapi kueri penelusuran terhadap ProductSets yang berisi gambar mungkin masih berfungsi hingga semua cache terkait diperbarui.

File gambar yang sebenarnya tidak dihapus dari Google Cloud Storage.

Kemungkinan error:

  • Menampilkan NOT_FOUND jika gambar referensi tidak ada.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

Mendapatkan informasi yang terkait dengan Produk.

Kemungkinan error:

  • Menampilkan NOT_FOUND jika Produk tidak ada.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

GetProductSet

rpc GetProductSet(GetProductSetRequest) returns (ProductSet)

Mendapatkan informasi yang terkait dengan ProductSet.

Kemungkinan error:

  • Menampilkan NOT_FOUND jika ProductSet tidak ada.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

GetReferenceImage

rpc GetReferenceImage(GetReferenceImageRequest) returns (ReferenceImage)

Mendapatkan informasi yang terkait dengan ReferenceImage.

Kemungkinan error:

  • Menampilkan NOT_FOUND jika gambar yang ditentukan tidak ada.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

ImportProductSet

rpc ImportProductSets(ImportProductSetsRequest) returns (Operation)

API asinkron yang mengimpor daftar gambar referensi ke set produk yang ditentukan berdasarkan daftar informasi gambar.

API google.longrunning.Operation dapat digunakan untuk melacak progres dan hasil permintaan. Operation.metadata berisi BatchOperationMetadata. (progres) Operation.response berisi ImportProductSetsResponse. (hasil)

Sumber input metode ini adalah file csv di Google Cloud Storage. Untuk format file csv, lihat ImportProductSetsGcsSource.csv_file_uri.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

ListProductSet

rpc ListProductSets(ListProductSetsRequest) returns (ListProductSetsResponse)

Mencantumkan ProductSets dalam urutan yang tidak ditentukan.

Kemungkinan error:

  • Menampilkan INVALID_ARGUMENT jika page_size lebih besar dari 100, atau kurang dari 1.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Mencantumkan produk dalam urutan yang tidak ditentukan.

Kemungkinan error:

  • Menampilkan INVALID_ARGUMENT jika page_size lebih besar dari 100 atau kurang dari 1.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

ListProductsInProductSet

rpc ListProductsInProductSet(ListProductsInProductSetRequest) returns (ListProductsInProductSetResponse)

Mencantumkan Produk di ProductSet, dalam urutan yang tidak ditentukan. Jika ProductSet tidak ada, kolom produk dari respons akan kosong.

Kemungkinan error:

  • Menampilkan INVALID_ARGUMENT jika page_size lebih besar dari 100 atau kurang dari 1.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

ListReferenceImages

rpc ListReferenceImages(ListReferenceImagesRequest) returns (ListReferenceImagesResponse)

Mencantumkan gambar referensi.

Kemungkinan error:

  • Menampilkan NOT_FOUND jika produk induk tidak ada.
  • Menampilkan INVALID_ARGUMENT jika page_size lebih besar dari 100, atau kurang dari 1.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

RemoveProductFromProductSet

rpc RemoveProductFromProductSet(RemoveProductFromProductSetRequest) returns (Empty)

Menghapus Product dari ProductSet yang ditentukan.

Kemungkinan error:

  • Menampilkan NOT_FOUND Jika Produk tidak ditemukan pada ProductSet.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

UpdateProduct

rpc UpdateProduct(UpdateProductRequest) returns (Product)

Membuat perubahan pada resource Produk. Hanya kolom display_name, description, dan labels yang dapat diperbarui saat ini.

Jika label diperbarui, perubahan tidak akan tercermin dalam kueri hingga waktu indeks berikutnya.

Kemungkinan error:

  • Menampilkan NOT_FOUND jika Produk tidak ada.
  • Menampilkan INVALID_events jika display_name ada dalam update_mask, tetapi tidak ada di permintaan atau lebih dari 4096 karakter.
  • Menampilkan INVALID_ARGUMENT jika deskripsi ada di update_mask, tetapi lebih dari 4096 karakter.
  • Menampilkan INVALID_ARGUMENT jika product_category ada di update_mask.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

UpdateProductSet

rpc UpdateProductSet(UpdateProductSetRequest) returns (ProductSet)

Membuat perubahan pada resource ProductSet. Hanya display_name yang dapat diperbarui saat ini.

Kemungkinan error:

  • Menampilkan NOT_FOUND jika ProductSet tidak ada.
  • Menampilkan INVALID_ARGUMENT jika display_name ada di update_mask tetapi tidak ada dari permintaan atau lebih dari 4096 karakter.
Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

AddProductToProductSetRequest

Pesan permintaan untuk metode AddProductToProductSet.

Kolom
name

string

Nama resource untuk ProductSet yang akan diubah.

Formatnya adalah: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID

product

string

Nama resource untuk Product yang akan ditambahkan ke ProductSet ini.

Formatnya adalah: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

AnnotateFileRequest

Permintaan untuk menganotasi satu file, misalnya file PDF, TIFF, atau GIF.

Kolom
input_config

InputConfig

Wajib. Informasi tentang file input.

features[]

Feature

Wajib. Fitur yang diminta.

image_context

ImageContext

Konteks tambahan yang mungkin menyertai gambar dalam file.

pages[]

int32

Halaman file untuk menjalankan anotasi gambar.

Halaman dimulai dari 1, kami berasumsi bahwa halaman pertama file adalah halaman 1. Maksimal 5 halaman didukung per permintaan. Halaman bisa negatif.

Halaman 1 berarti halaman pertama. Halaman 2 berarti halaman kedua. Halaman -1 berarti halaman terakhir. Halaman -2 berarti halaman kedua dari halaman terakhir.

Jika file berupa GIF, bukan PDF atau TIFF, halaman akan merujuk ke frame GIF.

Jika kolom ini kosong, secara default layanan akan melakukan anotasi gambar untuk 5 halaman pertama file.

AnnotateFileResponse

Respons terhadap permintaan anotasi file tunggal. File dapat berisi satu atau beberapa gambar, yang masing-masing memiliki respons tersendiri.

Kolom
input_config

InputConfig

Informasi tentang file yang menghasilkan respons ini.

responses[]

AnnotateImageResponse

Respons individual terhadap gambar yang ditemukan dalam file.

AnnotateImageRequest

Permintaan untuk menjalankan tugas Google Cloud Vision API pada gambar yang diberikan pengguna, dengan fitur yang diminta pengguna, dan dengan informasi konteks.

Kolom
image

Image

Gambar yang akan diproses.

features[]

Feature

Fitur yang diminta.

image_context

ImageContext

Konteks tambahan yang mungkin menyertai gambar.

custom_label_detection_models[]

string

Saat membuat permintaan dengan nilai CUSTOM_LABEL_DETECTION di kolom features.type, kolom CustomLabelDetectionModels harus menentukan model kustom yang akan digunakan. Format nama model meniru URL resource dari model kustom: /projects/PROJECT_ID/models/MODEL_ID atau /models/MODEL_ID jika model tersebut termasuk dalam project saat ini.

AnnotateImageResponse

Respons terhadap permintaan anotasi gambar.

Kolom
face_annotations[]

FaceAnnotation

Jika ada, deteksi wajah telah berhasil diselesaikan.

landmark_annotations[]

EntityAnnotation

Jika ada, deteksi tempat terkenal telah berhasil diselesaikan.

logo_annotations[]

EntityAnnotation

Jika ada, deteksi logo berhasil diselesaikan.

label_annotations[]

EntityAnnotation

Jika ada, deteksi label telah berhasil diselesaikan.

localized_object_annotations[]

LocalizedObjectAnnotation

Jika ada, deteksi objek yang dilokalkan telah berhasil diselesaikan. Nilai ini akan diurutkan secara menurun menurut skor keyakinan.

custom_label_annotations[]

CustomEntityAnnotation

Jika ada, anotasi kustom telah berhasil diselesaikan.

text_annotations[]

EntityAnnotation

Jika ada, deteksi teks (OCR) telah berhasil diselesaikan.

full_text_annotation

TextAnnotation

Jika ada, deteksi teks (OCR) atau deteksi teks dokumen (OCR) telah berhasil diselesaikan. Anotasi ini memberikan hierarki struktural untuk teks yang terdeteksi OCR.

safe_search_annotation

SafeSearchAnnotation

Jika ada, anotasi SafeSearch berhasil diselesaikan.

image_properties_annotation

ImageProperties

Jika ada, properti gambar berhasil diekstrak.

crop_hints_annotation

CropHintsAnnotation

Jika ada, petunjuk pemangkasan telah berhasil diselesaikan.

web_detection

WebDetection

Jika ada, deteksi web telah berhasil diselesaikan,

product_search_results

ProductSearchResults

Jika ada, penelusuran produk telah berhasil diselesaikan.

error

Status

Jika ditetapkan, mewakili pesan error untuk operasi. Perlu diketahui bahwa anotasi gambar yang terisi selalu benar, bahkan saat error disetel.

context

ImageAnnotationContext

Jika ada, informasi kontekstual diperlukan untuk memahami asal gambar ini.

image_quality_annotation

ImageQuality

Jika ada, penghitungan kualitas gambar telah berhasil diselesaikan.

object_attribute_annotations[]

EntityAnnotation

Jika ada, penghitungan atribut objek telah berhasil diselesaikan. Nilai atribut akan diisi di Properti AnotasiEntitas. Contoh: object_attribute_annotations { properties { name: "color" value: "blue" pendapat: 0.1 } properti { name: "color" value: "white" menonton: 0.2 } properti { nama: "material" value: "silk" keterbatasan: 0,3 } }

quality_optimization_result

QualityOptimizationResult

Jika ada, berarti pengoptimalan kualitas gambar berhasil diselesaikan.

localized_barcode_annotations[]

LocalizedBarcodeAnnotation

Jika ada, deteksi kode batang yang dilokalkan telah berhasil diselesaikan.

AsyncAnnotateFileRequest

Permintaan anotasi file offline.

Kolom
input_config

InputConfig

Wajib. Informasi tentang file input.

features[]

Feature

Wajib. Fitur yang diminta.

image_context

ImageContext

Konteks tambahan yang mungkin menyertai gambar dalam file.

output_config

OutputConfig

Wajib. Lokasi output dan metadata yang diinginkan (misalnya, format).

AsyncAnnotateFileResponse

Respons untuk satu permintaan anotasi file offline.

Kolom
output_config

OutputConfig

Lokasi output dan metadata dari AsyncAnnotateFileRequest.

AsyncBatchAnnotateFilesRequest

Beberapa permintaan anotasi file asinkron dikelompokkan menjadi satu panggilan layanan.

Kolom
requests[]

AsyncAnnotateFileRequest

Permintaan anotasi file asinkron individual untuk batch ini.

AsyncBatchAnnotateFilesResponse

Respons terhadap permintaan anotasi file batch asinkron.

Kolom
responses[]

AsyncAnnotateFileResponse

Daftar respons anotasi file, satu untuk setiap permintaan di AsyncBatchAnnotateFilesRequest.

AsyncBatchAnnotateImagesRequest

Meminta anotasi gambar asinkron untuk daftar gambar.

Kolom
requests[]

AnnotateImageRequest

Permintaan anotasi gambar individual untuk batch ini.

output_config

OutputConfig

Wajib. Lokasi output dan metadata yang diinginkan (misalnya, format).

AsyncBatchAnnotateImagesResponse

Respons terhadap permintaan anotasi file batch asinkron.

Kolom
output_config

OutputConfig

Lokasi output dan metadata dari AsyncBatchAnnotateImagesRequest.

BatchAnnotateFilesRequest

Daftar permintaan untuk memberi anotasi file menggunakan BatchAnnotateFiles API.

Kolom
requests[]

AnnotateFileRequest

Daftar permintaan anotasi file. Saat ini kami hanya mendukung satu AnnotateFileRequest di BatchAnnotateFilesRequest.

BatchAnnotateFilesResponse

Daftar respons anotasi file.

Kolom
responses[]

AnnotateFileResponse

Daftar respons anotasi file, setiap respons sesuai dengan setiap AnnotateFileRequest di BatchAnnotateFilesRequest.

BatchAnnotateImagesRequest

Beberapa permintaan anotasi gambar dikelompokkan menjadi satu panggilan layanan.

Kolom
requests[]

AnnotateImageRequest

Permintaan anotasi gambar individual untuk batch ini.

BatchAnnotateImagesResponse

Respons terhadap permintaan anotasi gambar batch.

Kolom
responses[]

AnnotateImageResponse

Setiap respons terhadap permintaan anotasi gambar dalam batch.

BatchOperationMetadata

Metadata untuk operasi batch, seperti status saat ini.

Hal ini disertakan dalam kolom metadata dari Operation yang ditampilkan oleh panggilan GetOperation dari layanan google::longrunning::Operations.

Kolom
state

State

Status operasi batch saat ini.

submit_time

Timestamp

Waktu ketika permintaan batch dikirim ke server.

end_time

Timestamp

Waktu saat permintaan batch selesai dan google.longrunning.Operation.done ditetapkan ke true.

Negara Bagian

Menghitung kemungkinan status yang dapat mencakup permintaan batch.

Enum
STATE_UNSPECIFIED Tidak Valid.
PROCESSING Permintaan sedang aktif diproses.
SUCCESSFUL Permintaan selesai dan setidaknya satu item telah berhasil diproses.
FAILED Permintaan selesai dan tidak ada item yang berhasil diproses.
CANCELLED Permintaan dilakukan setelah longrunning.Operations.CancelOperation dipanggil oleh pengguna. Semua data yang diproses sebelum perintah pembatalan akan ditampilkan seperti yang ditentukan dalam permintaan.

Blokir

Elemen logika pada halaman.

Kolom
property

TextProperty

Informasi tambahan yang terdeteksi untuk blokir.

bounding_box

BoundingPoly

Kotak pembatas untuk blokir. Titik sudut berada dalam urutan dari sudut kiri-atas, kanan-atas, kanan-bawah, kiri-bawah. Jika rotasi kotak pembatas terdeteksi, rotasi akan ditampilkan di sekitar sudut kiri atas seperti yang didefinisikan saat teks dibaca dalam orientasi 'asli'. Contoh:

  • saat teks horizontal, bentuknya akan terlihat seperti ini:
    0----1
    |    |
    3----2
  • saat diputar 180 derajat di sudut kiri atas, menjadi:
    2----3
    |    |
    1----0

dan urutan vertexnya akan tetap (0, 1, 2, 3).

paragraphs[]

Paragraph

Daftar paragraf dalam blok ini (jika blok ini berupa teks jenis).

block_type

BlockType

Jenis blok yang terdeteksi (teks, gambar, dll.) untuk blok ini.

confidence

float

Keyakinan hasil OCR pada blok. Rentang [0, 1].

table

Table

Tabel yang terdeteksi untuk TABLE block_type. Kolom ini secara default tidak ditampilkan, kecuali jika diaktifkan via TextDetectionParams.table_detection_options. bounding_box untuk Blok ini akan menjadi batas yang terdeteksi untuk tabel ini.

key_value_pair

KeyValuePair

Sambungan yang terdeteksi untuk block_type KEY_VALUE_PAIR. Kolom ini secara default tidak ditampilkan kecuali DocumentType ditentukan.

merged_text

string

Semua teks UTF-8 terdeteksi dalam blok ini. Kolom ini secara default tidak ditampilkan, kecuali jika ditentukan dalam TextDetectionParams.block_filter.

BlockType

Jenis blok (teks, gambar, dll.) seperti yang diidentifikasi oleh OCR.

Enum
UNKNOWN Jenis blok yang tidak diketahui.
TEXT Blok teks biasa.
TABLE Blok tabel.
PICTURE Pemblokiran gambar.
RULER Kotak garis horizontal/vertikal.
BARCODE Blok kode batang.
KEY_VALUE_PAIR Blok pasangan nilai kunci.

BoundingPoly

Poligon pembatas untuk anotasi gambar yang terdeteksi.

Kolom
vertices[]

Vertex

Puncak poligon pembatas.

normalized_vertices[]

NormalizedVertex

Verteks poligon pembatas yang dinormalisasi.

ColorInfo

Informasi warna terdiri dari saluran RGB, skor, dan fraksi gambar yang diwarnai oleh warna tersebut dalam gambar.

Kolom
color

Color

Komponen RGB dari warna.

score

float

Skor khusus gambar untuk warna ini. Nilai dalam rentang [0, 1].

pixel_fraction

float

Fraksi piksel yang ditempati warna pada gambar. Nilai dalam rentang [0, 1].

CreateProductRequest

Pesan permintaan untuk metode CreateProduct.

Kolom
parent

string

Project tempat Product harus dibuat.

Formatnya adalah projects/PROJECT_ID/locations/LOC_ID.

product

Product

Produk yang akan dibuat.

product_id

string

ID resource yang disediakan pengguna untuk Produk ini. Jika disetel, server akan mencoba menggunakan nilai ini sebagai ID resource. Jika sudah digunakan, kesalahan akan ditampilkan dengan kode ALREADY_EXISTS. Maksimum 128 karakter. Teks tidak boleh berisi karakter /.

CreateProductSetRequest

Pesan permintaan untuk metode CreateProductSet.

Kolom
parent

string

Project tempat ProductSet harus dibuat.

Formatnya adalah projects/PROJECT_ID/locations/LOC_ID.

product_set

ProductSet

ProductSet yang akan dibuat.

product_set_id

string

ID resource yang disediakan pengguna untuk ProductSet ini. Jika disetel, server akan mencoba menggunakan nilai ini sebagai ID resource. Jika sudah digunakan, kesalahan akan ditampilkan dengan kode ALREADY_EXISTS. Maksimum 128 karakter. Teks tidak boleh berisi karakter /.

CreateReferenceImageRequest

Pesan permintaan untuk metode CreateReferenceImage.

Kolom
parent

string

Nama resource produk membuat gambar referensi.

Formatnya adalah projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.

reference_image

ReferenceImage

Gambar referensi yang akan dibuat. Jika ID gambar ditentukan, ID tersebut akan diabaikan.

reference_image_id

string

ID resource yang disediakan pengguna untuk ReferenceImage yang akan ditambahkan. Jika disetel, server akan mencoba menggunakan nilai ini sebagai ID resource. Jika sudah digunakan, kesalahan akan ditampilkan dengan kode ALREADY_EXISTS. Maksimum 128 karakter. Teks tidak boleh berisi karakter /.

CropHint

Petunjuk pangkas tunggal yang digunakan untuk menghasilkan pemangkasan baru saat menampilkan gambar.

Kolom
bounding_poly

BoundingPoly

Poligon pembatas untuk area pemangkasan. Koordinat kotak pembatas memiliki skala gambar asli.

confidence

float

Keyakinan bahwa area ini penting. Rentang [0, 1].

importance_fraction

float

Fraksi tingkat kepentingan region penting ini dalam kaitannya dengan gambar asli.

CropHintsAnnotation

Kumpulan petunjuk crop yang digunakan untuk membuat pemangkasan baru saat menampilkan gambar.

Kolom
crop_hints[]

CropHint

Hasil petunjuk pangkas.

CropHintsParams

Parameter untuk permintaan anotasi petunjuk pangkas.

Kolom
aspect_ratios[]

float

Rasio aspek dalam float, merepresentasikan rasio lebar dan tinggi gambar. Misalnya, jika rasio aspek yang diinginkan adalah 4/3, nilai float yang sesuai harus 1,33333. Jika tidak ditentukan, pemangkasan terbaik akan ditampilkan. Jumlah rasio aspek yang diberikan dibatasi hingga maksimum 16; rasio aspek apa pun yang diberikan setelahnya akan diabaikan.

CustomEntityAnnotation

CustomEntityAnnotation berisi anotasi yang diprediksi menggunakan model kustom Vision.

Kolom
model

string

Mengidentifikasi model kustom yang digunakan untuk membuat anotasi ini. Format nama model adalah URL resource dari mode kustom yang dikueri: /projects/PROJECT_ID/models/MODEL_ID, atau /models/MODEL_ID jika model tersebut milik project saat ini.

label

string

Label yang diprediksi oleh model kustom.

score

float

Skor keyakinan label menurut model kustom.

DeleteProductRequest

Pesan permintaan untuk metode DeleteProduct.

Kolom
name

string

Nama resource produk yang akan dihapus.

Formatnya adalah: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

DeleteProductSetRequest

Pesan permintaan untuk metode DeleteProductSet.

Kolom
name

string

Nama resource ProductSet yang akan dihapus.

Formatnya adalah: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID

DeleteReferenceImageRequest

Pesan permintaan untuk metode DeleteReferenceImage.

Kolom
name

string

Nama resource gambar referensi yang akan dihapus.

Formatnya adalah:

projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID

DocumentParsingParams

Parameter untuk fitur DOCUMENT_PARSING.

Kolom
disable_orientation_detection

bool

Menonaktifkan deteksi orientasi sehingga teks yang dirotasi tidak akan terdeteksi.

table_detection_options

TableDetectionOptions

Mengontrol perilaku deteksi tabel. Deteksi tabel dinonaktifkan jika kolom ini tidak ditetapkan.

document_type

string

Tentukan jenis dokumen yang diketahui untuk deteksi struktur yang lebih dalam. Nilai yang valid saat ini adalah "invoice" atau "general".

DominantColorsAnnotation

Kumpulan warna dominan dan skornya yang sesuai.

Kolom
colors[]

ColorInfo

Nilai warna RGB dengan skor dan fraksi pikselnya.

EntityAnnotation

Kumpulan fitur entitas yang terdeteksi.

Kolom
mid

string

ID entity buram. Beberapa ID mungkin tersedia di Search API Grafik Pengetahuan Google.

locale

string

Kode bahasa untuk lokalitas tempat description tekstual entitas dinyatakan.

description

string

Deskripsi tekstual entitas, yang dinyatakan dalam bahasa locale.

score

float

Skor hasil secara keseluruhan. Rentang [0, 1].

confidence
(deprecated)

float

Tidak digunakan lagi. Sebagai gantinya, gunakan score. Keakuratan deteksi entity dalam gambar. Misalnya, untuk gambar yang mendeteksi entitas "Menara Eiffel", kolom ini merepresentasikan keyakinan bahwa ada menara dalam kueri gambar. Rentang [0, 1].

topicality

float

Relevansi label ICA (Image Content Annotation) terhadap gambar. Misalnya, relevansi "menara" cenderung lebih tinggi untuk gambar yang berisi "Menara Eiffel" yang terdeteksi daripada gambar yang berisi bangunan menjulang tinggi yang terdeteksi, meskipun keyakinan bahwa ada menara di setiap gambar mungkin sama. Rentang [0, 1].

bounding_poly

BoundingPoly

Region gambar entity ini berasal. Tidak diproduksi untuk fitur LABEL_DETECTION.

locations[]

LocationInfo

Informasi lokasi untuk entity yang terdeteksi. Beberapa elemen LocationInfo dapat muncul karena satu lokasi dapat mengindikasi suasana dalam gambar, dan lokasi lain dapat menunjukkan lokasi tempat gambar diambil. Informasi lokasi biasanya tersedia untuk tempat terkenal.

properties[]

Property

Beberapa entitas mungkin memiliki kolom Property (nama/nilai) opsional yang disediakan pengguna. Seperti, skor atau string yang memenuhi syarat untuk entity.

FaceAnnotation

Objek anotasi wajah berisi hasil deteksi wajah.

Kolom
bounding_poly

BoundingPoly

Poligon pembatas di sekitar wajah. Koordinat kotak pembatas memiliki skala gambar asli. Kotak pembatas dihitung untuk "membingkai" wajah sesuai dengan ekspektasi manusia. Hal ini didasarkan pada hasil penanda. Perhatikan bahwa satu atau beberapa koordinat x dan/atau y mungkin tidak dibuat di BoundingPoly (poligon tidak akan dibatasi) jika hanya sebagian wajah yang muncul dalam gambar yang akan dianotasi.

fd_bounding_poly

BoundingPoly

Poligon pembatas fd_bounding_poly lebih rapat daripada boundingPoly, dan hanya mencakup bagian kulit wajah saja. Biasanya digunakan untuk menghilangkan wajah dari analisis gambar yang mendeteksi "jumlah kulit" yang terlihat pada gambar. Fitur ini tidak didasarkan pada hasil penanda, melainkan hanya pada deteksi wajah awal saja, sehingga

fd

berimbuhan (face detection).

landmarks[]

Landmark

Landmark wajah yang terdeteksi.

roll_angle

float

Sudut roll, yang menunjukkan besarnya rotasi wajah searah/berlawanan arah jarum jam, bersifat relatif terhadap sumbu vertikal gambar di sekitar sumbu yang tegak lurus terhadap wajah. Rentang [-180,180].

pan_angle

float

Sudut yaw, yang menunjukkan sudut kiri/kanan ke mana wajah menghadap, bersifat relatif terhadap bidang vertikal yang tegak lurus terhadap gambar. Rentang [-180,180].

tilt_angle

float

Sudut kemiringan, yang menunjukkan sudut ke atas/ke bawah ke mana wajah menghadap, bersifat relatif terhadap bidang horizontal gambar. Rentang [-180,180].

detection_confidence

float

Keyakinan deteksi. Rentang [0, 1].

landmarking_confidence

float

Keyakinan landmark wajah. Rentang [0, 1].

joy_likelihood

Likelihood

Kemungkinan sukacita.

sorrow_likelihood

Likelihood

Kemungkinan berduka.

anger_likelihood

Likelihood

Kemungkinan marah.

surprise_likelihood

Likelihood

Kemungkinan kaget.

under_exposed_likelihood

Likelihood

Kemungkinan kurang terekspos.

blurred_likelihood

Likelihood

Kemungkinan buram.

headwear_likelihood

Likelihood

Kemungkinan aksesori kepala.

Penanda

Penanda khusus wajah (misalnya, fitur wajah).

Kolom
type

Type

Jenis penanda wajah.

position

Position

Posisi penanda wajah.

Jenis

Jenis (fitur) penanda wajah. Kiri dan kanan ditentukan dari sudut pandang penampil gambar tanpa mempertimbangkan proyeksi pantulan yang biasa pada foto. Jadi, LEFT_EYE biasanya adalah mata kanan orang tersebut.

Enum
UNKNOWN_LANDMARK Penanda wajah tidak diketahui terdeteksi. Tidak boleh diisi.
LEFT_EYE Mata kiri.
RIGHT_EYE Mata kanan.
LEFT_OF_LEFT_EYEBROW Bagian kiri dari alis kiri.
RIGHT_OF_LEFT_EYEBROW Bagian kanan dari alis kiri.
LEFT_OF_RIGHT_EYEBROW Bagian kiri dari alis kanan.
RIGHT_OF_RIGHT_EYEBROW Bagian kanan dari alis kanan.
MIDPOINT_BETWEEN_EYES Titik tengah di antara mata.
NOSE_TIP Ujung hidung.
UPPER_LIP Bibir atas.
LOWER_LIP Bibir bawah.
MOUTH_LEFT Mulut bagian kiri.
MOUTH_RIGHT Mulut bagian kanan.
MOUTH_CENTER Mulut bagian tengah.
NOSE_BOTTOM_RIGHT Hidung, kanan bawah.
NOSE_BOTTOM_LEFT Hidung, kiri bawah.
NOSE_BOTTOM_CENTER Hidung, tengah bawah.
LEFT_EYE_TOP_BOUNDARY Mata kiri, batas atas.
LEFT_EYE_RIGHT_CORNER Mata kiri, sudut kanan.
LEFT_EYE_BOTTOM_BOUNDARY Mata kiri, batas bawah.
LEFT_EYE_LEFT_CORNER Mata kiri, sudut kiri.
RIGHT_EYE_TOP_BOUNDARY Mata kanan, batas atas.
RIGHT_EYE_RIGHT_CORNER Mata kanan, sudut kanan.
RIGHT_EYE_BOTTOM_BOUNDARY Mata kanan, batas bawah.
RIGHT_EYE_LEFT_CORNER Mata kanan, sudut kiri.
LEFT_EYEBROW_UPPER_MIDPOINT Alis kiri, titik tengah atas.
RIGHT_EYEBROW_UPPER_MIDPOINT Alis kanan, titik tengah atas.
LEFT_EAR_TRAGION Tragion telinga kiri.
RIGHT_EAR_TRAGION Tragion telinga kanan.
LEFT_EYE_PUPIL Pupil mata kiri.
RIGHT_EYE_PUPIL Pupil mata kanan.
FOREHEAD_GLABELLA Glabella dahi.
CHIN_GNATHION Gnathion dagu.
CHIN_LEFT_GONION Gonion kiri dagu.
CHIN_RIGHT_GONION Gonion kanan dagu.

Fitur

Jenis deteksi Google Cloud Vision API yang akan dijalankan, dan jumlah hasil maksimum yang akan ditampilkan untuk jenis tersebut. Beberapa objek Feature dapat dispesifikasi dalam daftar features.

Kolom
type

Type

Jenis fitur.

max_results

int32

Menetapkan jumlah maksimum hasil dari jenis ini. Tidak berlaku untuk TEXT_DETECTION, DOCUMENT_TEXT_DETECTION, atau CROP_HINTS.

model

string

Model yang akan digunakan untuk fitur. Nilai yang didukung: "builtin/stable" (default jika tidak disetel) dan "builtin/latest".

Jenis

Jenis fitur Google Cloud Vision API yang akan diekstrak.

Enum
TYPE_UNSPECIFIED Jenis fitur belum ditetapkan.
FACE_DETECTION Menjalankan deteksi wajah.
LANDMARK_DETECTION Menjalankan deteksi tempat terkenal.
LOGO_DETECTION Menjalankan deteksi logo.
LABEL_DETECTION Menjalankan deteksi label.
TEXT_DETECTION Menjalankan deteksi teks / pengenalan karakter optik (OCR). Deteksi teks dioptimalkan untuk area teks dalam gambar yang lebih besar; jika gambar berupa dokumen, gunakan DOCUMENT_TEXT_DETECTION.
DOCUMENT_TEXT_DETECTION Jalankan OCR dokumen teks padat. Gunakan prioritas saat DOCUMENT_TEXT_DETECTION dan TEXT_DETECTION keduanya ada
SAFE_SEARCH_DETECTION Menjalankan SafeSearch untuk mendeteksi konten yang berpotensi tidak aman atau tidak diinginkan.
IMAGE_PROPERTIES Menghitung kumpulan properti gambar, seperti warna dominan di gambar.
CROP_HINTS Menjalankan petunjuk pangkas.
WEB_DETECTION Menjalankan deteksi web.
CUSTOM_LABEL_DETECTION Menjalankan deteksi label kustom.
OBJECT_LOCALIZATION Menjalankan pelokalan untuk deteksi objek.
IMAGE_QUALITY Menjalankan pencetak kualitas.
OBJECT_ATTRIBUTES Menghitung atribut objek yang terdeteksi dalam gambar. Empat domain objek didukung. Pilih melalui Feature.model (wajib): "builtin/apparel", "builtin/car", "builtin/food", atau "builtin/wildlife".
QUALITY_OPTIMIZATION Menjalankan algoritma pengoptimalan kualitas. Ada tiga jenis operasi: COMPRESSION, ENHANCEMENT, dan QUALITY_SCORE. Parameter COMPRESSION dan ENHANCEMENT, serta pilihan model QUALITY_SCORE dapat ditentukan dalam image_context.quality_optimize_params.
BARCODE_DETECTION Menjalankan deteksi dan pengenalan kode batang.
DOCUMENT_PARSING Menjalankan algoritma penguraian dokumen untuk mengekstrak data terstruktur seperti tabel dan formulir. Hasilnya ditemukan di full_text_annotation -> page -> block dengan jenis TABLE untuk tabel atau KEY_VALUE_PAIR untuk key-value pair dalam formulir.

GcsDestination

Lokasi Google Cloud Storage tempat output akan ditulis.

Kolom
uri

string

URI Google Cloud Storage tempat hasil akan disimpan. Hasil akan berformat JSON dan didahului oleh URI input yang sesuai. Kolom ini dapat mewakili satu file, atau awalan untuk beberapa output. Awalan harus diakhiri dengan /.

Contoh:

Jika ada beberapa output, setiap respons tetap berupa AnnotateFileResponse, yang masing-masing berisi beberapa subset daftar lengkap AnnotateImageResponse. Beberapa output dapat terjadi jika, misalnya, JSON output terlalu besar dan meluber ke beberapa file sharding.

GcsSource

Lokasi Google Cloud Storage tempat input akan dibaca.

Kolom
uri

string

URI Google Cloud Storage untuk file input. Hanya boleh berupa objek Google Cloud Storage. Karakter pengganti saat ini tidak didukung.

GetProductRequest

Pesan permintaan untuk metode GetProduct.

Kolom
name

string

Nama resource Produk yang akan didapatkan.

Formatnya adalah: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

GetProductSetRequest

Pesan permintaan untuk metode GetProductSet.

Kolom
name

string

Nama resource ProductSet yang akan didapatkan.

Formatnya adalah: projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID

GetReferenceImageRequest

Pesan permintaan untuk metode GetReferenceImage.

Kolom
name

string

Nama resource ReferenceImage yang akan didapatkan.

Formatnya adalah:

projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID.

Gambar

Image klien untuk menjalankan tugas Google Cloud Vision API.

Kolom
content

bytes

Konten gambar, direpresentasikan sebagai aliran byte. Catatan: Seperti semua kolom bytes, protobuffer menggunakan representasi biner murni, sedangkan representasi JSON menggunakan base64.

source

ImageSource

Lokasi gambar Google Cloud Storage, atau URL gambar yang dapat diakses secara publik. Jika content dan source disediakan untuk sebuah gambar, content akan diprioritaskan dan digunakan untuk melakukan permintaan anotasi gambar.

ImageAnnotationContext

Jika gambar dibuat dari file (misalnya PDF), pesan ini memberikan informasi tentang sumber gambar tersebut.

Kolom
uri

string

URI file yang digunakan untuk menghasilkan gambar.

page_number

int32

Jika filenya berupa PDF atau TIFF, kolom ini akan memberikan nomor halaman dalam file yang digunakan untuk menghasilkan gambar.

ImageContext

Konteks gambar dan/atau parameter khusus fitur.

Kolom
lat_long_rect

LatLongRect

Tidak digunakan.

language_hints[]

string

Daftar bahasa yang akan digunakan untuk TEXT_DETECTION. Dalam kebanyakan, nilai kosong memberikan hasil terbaik karena memungkinkan deteksi bahasa secara otomatis. Untuk bahasa yang didasarkan pada alfabet Latin, setelan language_hints tidak diperlukan. Dalam kasus yang jarang terjadi, jika bahasa teks dalam gambar diketahui, menyetel petunjuk akan membantu dalam mendapatkan hasil yang lebih baik (meskipun itu akan menjadi penghalang yang signifikan jika petunjuk diberi salah). Deteksi teks menampilkan error jika satu atau beberapa bahasa yang ditentukan bukan salah satu dari bahasa yang didukung.

crop_hints_params

CropHintsParams

Parameter untuk permintaan anotasi petunjuk pangkas.

product_search_params

ProductSearchParams

Parameter untuk penelusuran produk.

web_detection_params

WebDetectionParams

Parameter untuk deteksi web.

text_detection_params

TextDetectionParams

Parameter untuk deteksi teks dokumen.

quality_optimization_params

QualityOptimizationParams

Parameter untuk pengoptimalan kualitas gambar.

document_parsing_params

DocumentParsingParams

Parameter untuk penguraian dokumen.

ImageProperties

Menyimpan properti gambar, seperti warna dominan.

Kolom
dominant_colors

DominantColorsAnnotation

Jika ada, warna dominan akan berhasil diselesaikan.

ImageQuality

Menyimpan skor kualitas gambar, dapat berupa kualitas estetika atau kualitas teknis.

Kolom
quality_score

float

Skor mewakili kualitas estetika/teknis gambar. Skor menggunakan rentang [0, 1]. Nilai yang lebih tinggi berbanding lurus dengan foto yang terlihat lebih profesional. 0 berarti gambar terlihat sangat buruk, 1 berarti gambar dengan kualitas sangat tinggi.

ImageSource

Sumber gambar eksternal (Google Cloud Storage atau lokasi gambar URL web).

Kolom
gcs_image_uri

string

Sebaiknya, gunakan image_uri.

URI Google Cloud Storage untuk form gs://bucket_name/object_name. Pembuatan versi objek tidak didukung. Lihat URI Permintaan Google Cloud Storage untuk info selengkapnya.

image_uri

string

URI gambar sumber. Dapat berupa:

  1. URI Google Cloud Storage dengan format gs://bucket_name/object_name. Pembuatan versi objek tidak didukung. Lihat URI Permintaan Google Cloud Storage untuk info selengkapnya.

  2. URL HTTP/HTTPS gambar yang dapat diakses secara publik. Saat mengambil gambar dari URL HTTP/HTTPS, Google tidak dapat menjamin bahwa permintaan akan dipenuhi. Permintaan Anda mungkin gagal jika host yang ditentukan menolak permintaan tersebut (mis. karena throttling permintaan atau pencegahan DOS), atau jika Google men-throttle permintaan ke situs untuk pencegahan penyalahgunaan. Anda tidak boleh bergantung pada image yang dihosting secara eksternal untuk aplikasi produksi.

Jika gcs_image_uri dan image_uri ditentukan, image_uri akan diprioritaskan.

ImportProductSetsGcsSource

Lokasi Google Cloud Storage untuk file csv yang menyimpan daftar ImportProductSetRequests di setiap baris.

Kolom
csv_file_uri

string

URI Google Cloud Storage dari file csv input.

URI harus diawali dengan gs://.

Format file csv input harus berupa satu gambar per baris. Di setiap baris, terdapat 8 kolom.

  1. gambar-uri
  2. image-id
  3. product-set-id
  4. product-id
  5. product-category
  6. product-display-name
  7. label
  8. bounding-poly

Kolom image-uri, product-set-id, product-id, dan product-category wajib diisi. Semua kolom lainnya bersifat opsional.

Jika ProductSet atau Product yang ditentukan oleh nilai product-set-id dan product-id tidak ada, sistem akan membuat ProductSet atau Product baru untuk gambar. Dalam hal ini, kolom product-display-name merujuk pada display_name, kolom product-category merujuk pada product_category, dan kolom labels merujuk pada product_labels.

Kolom image-id bersifat opsional, tetapi harus unik jika diisi. Jika kosong, sistem akan otomatis menetapkan ID unik untuk image.

Kolom product-display-name bersifat opsional. Jika kosong, sistem akan menetapkan kolom display_name untuk produk ke spasi (" "). Anda dapat mengupdate display_name nanti menggunakan API.

Jika Product dengan product-id yang ditentukan sudah ada, sistem akan mengabaikan kolom product-display-name, product-category, dan labels.

Kolom labels (opsional) adalah baris yang berisi daftar key-value pair yang dipisahkan koma, dalam format berikut:

"key_1=value_1,key_2=value_2,...,key_n=value_n"

Kolom bounding-poly (opsional) mengidentifikasi satu wilayah minat dari gambar dengan cara yang sama seperti CreateReferenceImage. Jika Anda tidak menerangkan kolom bounding-poly, sistem akan mencoba mendeteksi wilayah minat secara otomatis.

Maksimal satu kolom bounding-poly yang diizinkan per baris. Jika gambar berisi beberapa wilayah minat, tambahkan baris ke file CSV yang menyertakan informasi produk yang sama, dan nilai bounding-poly untuk setiap wilayah minat.

Kolom bounding-poly harus berisi angka genap yang dipisahkan koma, dalam format "p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y". Gunakan bilangan bulat non-negatif untuk poligon pembatas absolut, dan nilai float dengan nilai [0, 1] untuk poligon pembatas yang dinormalisasi.

Sistem akan mengubah ukuran gambar jika resolusi gambar terlalu besar untuk diproses (lebih besar dari 20 MP).

ImportProductSetsInputConfig

Konten input untuk metode ImportProductSets.

Kolom
gcs_source

ImportProductSetsGcsSource

Lokasi Google Cloud Storage untuk file csv yang menyimpan daftar ImportProductSetRequests di setiap baris.

ImportProductSetsRequestt

Pesan permintaan untuk metode ImportProductSets.

Kolom
parent

string

Project tempat ProductSets seharusnya diimpor.

Formatnya adalah projects/PROJECT_ID/locations/LOC_ID.

input_config

ImportProductSetsInputConfig

Konten input untuk daftar permintaan.

ImportProductSetsResponse

Pesan respons untuk metode ImportProductSets.

Pesan ini ditampilkan oleh metode google.longrunning.Operations.GetOperation di kolom google.longrunning.Operation.response yang ditampilkan.

Kolom
reference_images[]

ReferenceImage

Daftar reference_images yang berhasil diimpor.

statuses[]

Status

Status rpc untuk setiap permintaan ImportProductSet, termasuk keberhasilan dan kesalahan.

Jumlah status di sini sesuai dengan jumlah baris dalam file csv, dan status[i] menyimpan status keberhasilan atau kegagalan pemrosesan baris ke-i csv, mulai dari baris 0.

InputConfig

Lokasi input dan metadata yang diinginkan.

Kolom
gcs_source

GcsSource

Lokasi Google Cloud Storage untuk membaca input.

content

bytes

Konten file, direpresentasikan sebagai aliran byte. Catatan: Seperti semua kolom bytes, protobuffer menggunakan representasi biner murni, sedangkan representasi JSON menggunakan base64.

Saat ini, kolom ini hanya berfungsi untuk permintaan BatchAnnotateFiles saja. Kode ini tidak berfungsi untuk permintaan AsyncBatchAnnotateFiles.

mime_type

string

Jenis file. Saat ini hanya "application/pdf" dan "image/tiff" yang didukung. Karakter pengganti tidak didukung.

KeyValuePair

Proto untuk pasangan nilai kunci.

Kolom
key

string

Nilai string kunci.

key_block

Block

Blok kunci pada pasangan yang berisi kotak pembatas yang dinormalisasi dan teks tombol.

value_block

Block

Blok nilai pada pasangan yang berisi kotak pembatas dan teks nilai yang telah dinormalisasi, mencakup struktur yang berpotensi lebih dalam di dalam teks nilai.

value_type

string

Jenis nilai. String yang valid adalah sebagai berikut:

"generic" - Untuk teks generik yang dipetakan ke sebuah nilai. "number" - untuk jenis numerik "id" - untuk pengenal generik. "currency" - untuk nilai mata uang. "date" - untuk tanggal. "time" - untuk nilai waktu dan durasi. "date_range" - untuk rentang tanggal. "address" - untuk nilai alamat (dapat panjang). "orang" - untuk nama orang atau tanda pengenal pribadi lainnya. "phone" - untuk nomor telepon.

normalized_key

string

(Opsional) Tombol teks yang dinormalisasi jika teks bersifat umum dan diklasifikasikan.

Misalnya, 'TOTAL DUE' akan dinormalkan menjadi 'Total amount

LatLongRect

Persegi ditentukan berdasarkan pasangan min dan maks dari LatLng.

Kolom
min_lat_lng

LatLng

Pasangan lintang/bujur min.

max_lat_lng

LatLng

Pasangan lintang/bujur maks.

Kecenderungan

Representasi probabilitas yang dikelompokkan dimaksudkan untuk memberikan hasil yang sangat stabil kepada klien pada seluruh upgrade model.

Enum
UNKNOWN Tingkat probabilitas tidak diketahui.
VERY_UNLIKELY Sangat tidak mungkin gambar tersebut berada dalam orientasi vertikal yang ditentukan.
UNLIKELY Tidak mungkin bahwa gambar termasuk dalam orientasi vertikal yang ditentukan.
POSSIBLE Ada kemungkinan gambar tersebut termasuk dalam orientasi vertikal yang ditentukan.
LIKELY Kemungkinan gambar tersebut termasuk dalam orientasi vertikal yang ditentukan.
VERY_LIKELY Sangat mungkin bahwa gambar tersebut termasuk dalam orientasi vertikal yang ditentukan.

ListProductSetsRequest

Pesan permintaan untuk metode ListProductSets.

Kolom
parent

string

Project tempat ProductSets akan dicantumkan.

Formatnya adalah projects/PROJECT_ID/locations/LOC_ID.

page_size

int32

Jumlah maksimum item untuk ditampilkan. Default 10, maksimum 100.

page_token

string

next_page_token yang ditampilkan dari permintaan Daftar sebelumnya, jika ada.

ListProductSetsResponse

Pesan respons untuk metode ListProductSets.

Kolom
product_sets[]

ProductSet

Daftar ProductSet.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya, atau kosong jika tidak ada lagi hasil dalam daftar.

ListProductsInProductSetRequest

Pesan permintaan untuk metode ListProductsInProductSet.

Kolom
name

string

Resource ProductSet yang digunakan untuk mengambil Produk.

Formatnya adalah: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID

page_size

int32

Jumlah maksimum item untuk ditampilkan. Default 10, maksimum 100.

page_token

string

next_page_token yang ditampilkan dari permintaan Daftar sebelumnya, jika ada.

ListProductsInProductSetResponse

Pesan respons untuk metode ListProductsInProductSet.

Kolom
products[]

Product

Daftar Produk.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya, atau kosong jika tidak ada lagi hasil dalam daftar.

ListProductsRequest

Pesan permintaan untuk metode ListProducts.

Kolom
parent

string

Project ATAU ProductSet tempat Produk harus dicantumkan.

Format: projects/PROJECT_ID/locations/LOC_ID

page_size

int32

Jumlah maksimum item untuk ditampilkan. Default 10, maksimum 100.

page_token

string

next_page_token yang ditampilkan dari permintaan Daftar sebelumnya, jika ada.

ListProductsResponse

Pesan respons untuk metode ListProducts.

Kolom
products[]

Product

Daftar produk.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya, atau kosong jika tidak ada lagi hasil dalam daftar.

ListReferenceImagesRequest

Pesan permintaan untuk metode ListReferenceImages.

Kolom
parent

string

Nama resource produk yang berisi gambar referensi.

Formatnya adalah projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.

page_size

int32

Jumlah maksimum item untuk ditampilkan. Default 10, maksimum 100.

page_token

string

Token yang mengidentifikasi halaman hasil yang akan ditampilkan. Ini adalah nilai nextPageToken yang ditampilkan dalam permintaan daftar gambar referensi sebelumnya.

Jika tidak ditentukan, default ke halaman pertama.

ListReferenceImagesResponse

Pesan respons untuk metode ListReferenceImages.

Kolom
reference_images[]

ReferenceImage

Daftar gambar referensi.

page_size

int32

Jumlah maksimum item untuk ditampilkan. Default 10, maksimum 100.

next_page_token

string

next_page_token yang ditampilkan dari permintaan Daftar sebelumnya, jika ada.

LocalizedBarcodeAnnotation

Kumpulan kode batang yang terdeteksi dengan kotak pembatas.

Kolom
format

string

Format kode batang menjelaskan format dari sebuah kode batang. Format yang didukung adalah: CODE_128: Jenis kode 128. CODE_39: Jenis kode 39. CODE_93: Jenis kode 93. CODABAR: Jenis Codabar. DATA_MATRIX: Jenis Matriks Data 2D. ITF: Jenis ITF. EAN_13: jenis EAN-13. EAN_8: jenis EAN-8. QR_CODE: Jenis kode QR 2D. UPC_A: Jenis UPC-A. UPC_E: Jenis UPC-E. PDF417: Jenis PDF417. AZTEC: Jenis kode Aztec 2D. DATABAR: Jenis kode DataBar GS1.

value_format

string

Format nilai kode batang menjelaskan format nilai yang dienkode pada kode batang. Format nilai yang didukung adalah: CONTACT_INFO: Informasi kontak. EMAIL: Alamat email. ISBN: ID ISBN. PHONE: Nomor telepon PRODUCT: Produk. SMS: Pesan SMS. TEXT: String teks. URL: Alamat URL. Wi-Fi: Informasi Wi-Fi. GEO: Pelokalan geografis (panjang dan lintang). CALENDAR_EVENT: Acara kalender. DRIVER_LICENSE: Surat izin mengemudi.

value

string

Nilai kode batang yang merupakan nilai ASCII yang tertangkap di kode batang. Kode batang dapat mengenkode nilai terstruktur, misalnya, 'MEBKM:TITLE:Google;URL:https://www.google.com;;'.

confidence

float

Nilai tingkat keyakinan dari hasil. Rentang [0, 1].

bounding_poly

BoundingPoly

Region gambar kode batang ini berada. Kolom ini wajib diisi.

LocalizedObjectAnnotation

Kumpulan objek yang terdeteksi dengan kotak pembatas.

Kolom
mid

string

ID objek yang harus sejajar dengan bagian tengah EntityAnnotation.

language_code

string

Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

name

string

Nama objek, dinyatakan dalam bahasa language_code.

score

float

Skor hasil. Rentang [0, 1].

bounding_poly

BoundingPoly

Region gambar yang berisi logo ini. Kolom ini wajib diisi.

LocationInfo

Informasi lokasi entitas yang terdeteksi.

Kolom
lat_lng

LatLng

koordinat lokasi lintang/bujur.

NormalizedVertex

verteks mewakili titik 2D pada gambar. CATATAN: koordinat verteks yang dinormalisasi akan relatif terhadap gambar asli dan memiliki rentang dari 0 hingga 1.

Kolom
x

float

Koordinat x.

y

float

Koordinat y.

OperationMetadata

Berisi metadata untuk operasi BatchAnnotateImages.

Kolom
state

State

Status operasi batch saat ini.

create_time

Timestamp

Waktu saat permintaan batch diterima.

update_time

Timestamp

Waktu saat hasil operasi terakhir diperbarui.

Negara Bagian

Status operasi batch.

Enum
STATE_UNSPECIFIED Tidak valid.
CREATED Permintaan diterima.
RUNNING Permintaan sedang aktif diproses.
DONE Batch processing selesai.
CANCELLED Batch processing dibatalkan.

OutputConfig

Lokasi output dan metadata yang diinginkan.

Kolom
gcs_destination

GcsDestination

Lokasi Google Cloud Storage yang menjadi tujuan penulisan output.

batch_size

int32

Jumlah maksimum proto respons untuk dimasukkan ke setiap file JSON output di Google Cloud Storage. Rentang yang valid adalah [1, 100]. Jika tidak ditentukan, nilai defaultnya adalah 20.

Misalnya, untuk satu file pdf dengan 100 halaman, 100 proto respons akan dibuat. Jika batch_size = 20, 5 file JSON yang masing-masing berisi 20 proto respons akan ditulis dengan awalan gcs_destination.uri.

Saat ini, batch_size hanya berlaku untuk GcsDestination, dengan potensi dukungan di masa mendatang untuk konfigurasi output lainnya.

Halaman

Halaman yang terdeteksi dari OCR.

Kolom
property

TextProperty

Informasi tambahan terdeteksi di halaman.

width

int32

Lebar halaman. Untuk PDF, satuannya adalah poin. Untuk gambar (termasuk TIFF), satuannya adalah piksel.

height

int32

Tinggi halaman. Untuk PDF, satuannya adalah poin. Untuk gambar (termasuk TIFF), satuannya adalah piksel.

blocks[]

Block

Daftar blok teks, gambar, dll. pada halaman ini.

confidence

float

Keyakinan hasil OCR pada halaman. Rentang [0, 1].

merged_text

string

Semua teks UTF-8 terdeteksi di halaman ini. Kolom ini secara default tidak ditampilkan, kecuali jika ditentukan dalam TextDetectionParams.page_filter.

Paragraf

Unit struktural teks yang mewakili sejumlah kata dalam urutan tertentu.

Kolom
property

TextProperty

Informasi tambahan terdeteksi untuk paragraf.

bounding_box

BoundingPoly

Kotak pembatas untuk paragraf. Titik sudut berada dalam urutan dari sudut kiri-atas, kanan-atas, kanan-bawah, kiri-bawah. Jika rotasi kotak pembatas terdeteksi, rotasi akan ditampilkan di sekitar sudut kiri atas seperti yang didefinisikan saat teks dibaca dalam orientasi 'asli'. Misalnya: * saat teks horizontal, tampilannya mungkin seperti ini: 0----1 | | 3----2 * saat diputar 180 derajat mengitari sudut kiri atas menjadi: 2----3 | | 1----0 dan urutan titik sudut akan tetap (0, 1, 2, 3).

words[]

Word

Daftar kata dalam paragraf ini.

confidence

float

Keyakinan hasil OCR untuk paragraf Rentang [0, 1].

merged_text

string

Semua teks UTF-8 terdeteksi dalam paragraf ini. Kolom ini secara default tidak ditampilkan, kecuali jika ditetapkan dalam TextDetectionParams.paragraph_filter.

Posisi

Posisi 3D dalam gambar, yang utama digunakan untuk penanda Deteksi wajah. Posisi yang valid harus memiliki koordinat x dan y. Koordinat posisi memiliki skala yang sama dengan gambar asli.

Kolom
x

float

Koordinat x.

y

float

Koordinat y.

z

float

Koordinat z (atau kedalaman).

Produk

Produk berisi ReferenceImages.

Kolom
name

string

Nama resource produk.

Formatnya adalah: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.

Kolom ini diabaikan saat membuat produk.

display_name

string

Nama yang diberikan pengguna untuk Produk ini. tidak boleh kosong. Panjang maksimal 4096 karakter.

description

string

Metadata yang disediakan pengguna untuk disimpan dengan produk ini. Panjang maksimal 4096 karakter.

product_category

string

Kategori untuk produk yang diidentifikasi oleh gambar referensi. Nama ini harus berupa "produk rumah tangga", "pakaian", atau "mainan".

Kolom ini tidak dapat diubah.

product_labels[]

KeyValue

Key-value pair yang dapat dilampirkan ke produk. Pada saat kueri, batasan dapat ditentukan berdasarkan product_labels.

Perhatikan bahwa nilai bilangan bulat dapat diberikan sebagai string, misalnya "1199". Hanya string dengan nilai bilangan bulat yang dapat cocok dengan batasan berbasis rentang yang akan segera didukung.

Beberapa nilai dapat ditetapkan pada kunci yang sama. Satu produk mungkin memiliki hingga 100 product_labels.

KeyValue

Label produk direpresentasikan sebagai key-value pair.

Kolom
key

string

Kunci label yang dilampirkan ke produk. Tidak boleh kosong dan tidak boleh melebihi 128 byte.

value

string

Nilai label yang dilampirkan ke produk. Tidak boleh kosong dan tidak boleh melebihi 128 byte.

ProductSearchParams

Parameter untuk permintaan penelusuran produk.

Kolom
bounding_poly

BoundingPoly

Poligon pembatas di sekitar area yang diinginkan pada gambar. Opsional. Jika tidak ditentukan, diskresi sistem akan diterapkan.

product_set

string

Nama resource ProductSet akan ditelusuri untuk gambar yang mirip.

Formatnya adalah: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID.

product_categories[]

string

Daftar kategori produk yang akan ditelusuri. Saat ini, kami hanya mempertimbangkan kategori pertama, dan "peralatan rumah tangga", "pakaian", atau "mainan" harus ditentukan.

filter

string

Ekspresi pemfilteran. Hal ini dapat digunakan untuk membatasi hasil penelusuran berdasarkan label Produk. Saat ini kami mendukung AND dari OR dari ekspresi key-value, yang setiap ekspresi dalam OR harus memiliki kunci yang sama.

Misalnya, "(warna = merah OR warna = biru) AND merek = Google" dapat diterima, tetapi tidak "(warna = merah OR merek = Google)" atau "warna: merah".

ProductSearchResults

Hasil untuk permintaan penelusuran produk.

Kolom
index_time

Timestamp

Stempel waktu indeks yang memberikan hasil ini. Perubahan yang dilakukan setelah ini tidak akan ditampilkan dalam hasil saat ini.

results[]

Result

Daftar hasil, satu untuk setiap kecocokan produk.

product_grouped_results[]

GroupedResult

Daftar hasil yang dikelompokkan berdasarkan produk yang terdeteksi dalam gambar kueri. Setiap entri sesuai dengan satu poligon pembatas di gambar kueri, dan berisi produk yang cocok khusus untuk region tersebut. Mungkin ada kecocokan produk duplikat dalam union dari semua hasil per-produk.

GroupedResult

Informasi tentang produk yang mirip dengan satu produk dalam gambar kueri.

Kolom
bounding_poly

BoundingPoly

Poligon pembatas di sekitar produk yang terdeteksi dalam gambar kueri.

results[]

Result

Daftar hasil, satu untuk setiap kecocokan produk.

object_annotations[]

ObjectAnnotation

Daftar prediksi generik untuk objek dalam kotak pembatas.

ObjectAnnotation

Prediksi objek yang ada di kotak pembatas.

Kolom
mid

string

ID objek yang harus sejajar dengan bagian tengah EntityAnnotation.

language_code

string

Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

name

string

Nama objek, dinyatakan dalam bahasa language_code.

score

float

Skor hasil. Rentang [0, 1].

Hasil

Informasi tentang suatu produk.

Kolom
product

Product

Produk.

score

float

Tingkat keyakinan pada kecocokan, mulai dari 0 (tidak yakin) hingga 1 (sangat yakin).

image

string

Nama resource gambar dari produk yang paling cocok dengan kueri.

ProductSet

ProductSet berisi Produk. ProductSet dapat berisi maksimal 1 juta gambar referensi. Jika batas terlampaui, pengindeksan berkala akan gagal.

Kolom
name

string

Nama resource ProductSet.

Formatnya adalah: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID.

Kolom ini diabaikan saat membuat ProductSet.

display_name

string

Nama yang diberikan pengguna untuk ProductSet ini. tidak boleh kosong. Panjang maksimal 4096 karakter.

index_time

Timestamp

Hanya output. Waktu saat ProductSet ini terakhir diindeks. Hasil kueri akan mencerminkan semua pembaruan sebelum waktu ini. Jika ProductSet ini belum pernah diindeks, stempel waktu ini adalah nilai default "1970-01-01T00:00:00Z".

Kolom ini diabaikan saat membuat ProductSet.

index_error

Status

Hanya output. Jika terjadi error saat mengindeks kumpulan produk, kolom ini akan diisi.

Kolom ini diabaikan saat membuat ProductSet.

Properti

Property terdiri dari pasangan nama/nilai yang diberikan pengguna.

Kolom
name

string

Nama properti.

value

string

Nilai properti.

uint64_value

uint64

Nilai properti numerik.

confidence

float

Nilai dalam rentang [0..1]. Tingkat keyakinan nilai properti ini.

mid

string

ID nilai properti yang tidak transparan. Beberapa ID mungkin tersedia di API Penelusuran Pustaka Pengetahuan Google. Contoh properti untuk jas biru adalah: Property { name: 'color' value: 'blue' mid: '/m/01g5v' // For color blue }

QualityOptimizationParams

Parameter untuk pengoptimalan kualitas gambar.

Kolom
type

Type

Pilih satu jenis pengoptimalan.

compression_config

CompressionConfig

Tentukan konfigurasi kompresi.

enhancement_config

EnhancementConfig

Tentukan konfigurasi peningkatan otomatis.

quality_score_config

QualityScoreConfig

Tentukan konfigurasi skor kualitas.

CompressionConfig

Konfigurasi untuk COMPRESSION.

Kolom
target_quality

float

Dalam rentang [0, 1]. Targetkan kualitas setelah kompresi. 1 berarti lossless dibandingkan dengan gambar input, 0 berarti tidak ada persyaratan kualitas minimum.

EnhancementConfig

Konfigurasi untuk ENHANCMENT. Jika tidak menentukan enhancement_config, nilai default sharpening_level sama dengan 0,5, auto_hdr_level sama dengan 0,5 dan upscale_ratio sama dengan 1 akan digunakan. Jika ingin menyesuaikan salah satu dari tiga parameter, Anda perlu menentukan keseluruhan ImprovementConfig. Misalnya, jika Anda ingin menggunakan auto_hdr_level yang lebih tinggi, yang biasanya akan membuat gambar lebih terang, dan mempertahankan tingkat ketajaman dan rasio peningkatan yang sama seperti default, Anda dapat mengatur konfigurasi sebagai: enhancement_config { sharpening_level: 0.5 auto_hdr_level: 1.0 upscale_ratio: 1 }

Kolom
sharpening_level

float

Dalam rentang [0,1]. Tingkat penajaman, 0 berarti tidak ada penajaman, 1 berarti penajaman terbesar. Jumlah defaultnya adalah 0.5.

auto_hdr_level

float

Dalam rentang [0,1]. Level HDR Otomatis, 0 berarti tidak ada HDR otomatis, 1 berarti AutoHDR terbesar. Jumlah defaultnya adalah 0.5.

upscale_ratio

float

Dalam rentang [1, 2]. Melakukan peningkatan skala, nilai defaultnya adalah 1, yang berarti tidak ada peningkatan skala. Jika ditentukan, tinggi dan lebar output akan sama dengan tinggi dan lebar dikalikan upscale-ratio.

QualityScoreConfig

Konfigurasi untuk QUALITY_SKOR.

Kolom
quality_model

string

Tentukan model yang akan digunakan. Nilai default adalah string kosong, dan skor estetika yang akan ditampilkan. Model kualitas lain yang didukung adalah "skor bawaan/teknis", yang akan menampilkan kualitas teknis gambar.

Jenis

Pengoptimalan kualitas jenis enum.

Enum
TYPE_UNSPECIFIED Tidak valid. Pelanggan harus memilih satu Jenis.
COMPRESSION Kurangi ukuran file gambar. Parameter mendetail yang ditentukan di CompressionConfig. Jika pelanggan tidak menentukan CompressionConfig, hal ini akan mengurangi ukuran file gambar tanpa mengurangi kualitas gambar. Jika pelanggan menentukan CompressionConfig, kami akan mengurangi ukuran file dengan tetap mempertahankan CompressionParams.target_quality.
ENHANCEMENT Hilangkan noise, pertajam, HDR, dan peningkatan skala. Parameter mendetail yang ditentukan di EnhancementConfig. Jika pelanggan tidak menentukan EnhancementConfig, mereka akan melakukan peningkatan (kualitas) gambar menggunakan nilai default. Jika upscale_ratio tidak ditentukan, gambar output akan memiliki resolusi yang sama dengan gambar input.
QUALITY_SCORE Skor kualitas kueri untuk gambar. Parameter mendetail yang ditentukan dalam QualityScoreConfig. Jika pelanggan tidak menentukan QualityScoreConfig, skor estetika gambar akan ditampilkan.

QualityOptimizationResult

Menyimpan byte gambar yang telah ditingkatkan kualitasnya.

Kolom
quality_optimization_type

Type

Jenis pengoptimalan yang diperlukan.

image

bytes

Byte gambar yang dioptimalkan.

mime_type

string

Jenis MIME pada gambar output.

ReferenceImage

ReferenceImage mewakili gambar produk dan metadatanya yang terkait, seperti kotak pembatas.

Kolom
name

string

Nama resource gambar referensi.

Formatnya adalah:

projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID.

Kolom ini diabaikan saat membuat gambar referensi.

uri

string

URI Google Cloud Storage gambar referensi.

URI harus diawali dengan gs://.

Wajib.

bounding_polys[]

BoundingPoly

Poligon pembatas di sekitar area minat pada gambar referensi. Opsional. Jika kolom ini kosong, sistem akan mencoba mendeteksi wilayah yang diinginkan. Maksimal 10 poligon pembatas akan digunakan.

Bentuk yang disediakan diubah menjadi persegi panjang yang tidak diputar. Setelah dikonversi, tepi kecil persegi panjang harus lebih besar dari atau sama dengan 300 piksel. Rasio aspek harus 1:4 atau lebih kecil (artinya, 1:3 tidak masalah; 1:5 tidak disarankan).

RemoveProductFromProductSetRequest

Pesan permintaan untuk metode RemoveProductFromProductSet.

Kolom
name

string

Nama resource untuk ProductSet yang akan diubah.

Formatnya adalah: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID

product

string

Nama resource untuk Produk yang akan dihapus dari ProductSet ini.

Formatnya adalah: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

SafeSearchAnnotation

Kumpulan fitur yang terkait dengan gambar dihitung dengan metode computer vision melalui kategori penelusuran aman (misalnya, dewasa, spoofing, medis, kekerasan).

Kolom
adult

Likelihood

Mewakili kemungkinan konten khusus dewasa untuk gambar. Konten dewasa dapat memuat elemen seperti ketelanjangan, gambar atau kartun porno, atau aktivitas seksual.

spoof

Likelihood

Kemungkinan spoofing. Ada kecenderungan modifikasi dibuat pada versi kanonis gambar untuk membuatnya tampak lucu atau menyinggung.

medical

Likelihood

Kemungkinan ini adalah gambar medis.

violence

Likelihood

Kemungkinan gambar ini berisi konten kekerasan.

racy

Likelihood

Kemungkinan gambar permintaan berisi konten cabul. Konten yang tidak pantas mungkin mencakup (tetapi tidak terbatas pada) pakaian minim atau tembus pandang, ketelanjangan yang ditutupi secara strategis, pose cabul atau provokatif, atau close-up dari bagian tubuh sensitif.

Simbol

Representasi simbol tunggal.

Kolom
property

TextProperty

Informasi tambahan terdeteksi untuk simbol.

bounding_box

BoundingPoly

Kotak pembatas untuk simbol. Titik sudut berada dalam urutan dari sudut kiri-atas, kanan-atas, kanan-bawah, kiri-bawah. Jika rotasi kotak pembatas terdeteksi, rotasi akan ditampilkan di sekitar sudut kiri atas seperti yang didefinisikan saat teks dibaca dalam orientasi 'asli'. Misalnya: * saat teks horizontal, tampilannya mungkin seperti ini: 0----1 | | 3----2 * saat diputar 180 derajat mengitari sudut kiri atas menjadi: 2----3 | | 1 ---- 0 dan urutan titik sudut akan tetap (0, 1, 2, 3).

text

string

Representasi aktual UTF-8 dari simbol.

confidence

float

Tingkat keyakinan hasil OCR untuk simbol tersebut. Rentang [0, 1].

Tabel

Representasi tabel yang mirip dengan struktur tabel HTML.

Kolom
header_rows[]

TableRow

Baris header tabel

body_rows[]

TableRow

Baris isi tabel

TableCell

Representasi sel di dalam tabel.

Kolom
row_span

int32

Jumlah baris yang membentang dalam sel ini.

col_span

int32

Jumlah kolom yang direntangkan oleh sel ini.

text_block

Block

Blok teks untuk sel ini juga berisi kotak pembatas yang dinormalisasi untuk sel dan struktur yang lebih dalam di dalam sel jika ada.

text

string

Nilai teks gabungan dari sel ini menghilangkan informasi struktural yang lebih dalam tidak seperti text_block. Hal ini berguna untuk sel sederhana.

TableRow

Baris sel tabel.

Kolom
cells[]

TableCell

Sel yang membentuk baris ini.

TableBoundHint

Petunjuk pada kotak pembatas tabel di halaman untuk penguraian tabel.

Kolom
page_number

int32

Nomor halaman opsional untuk input multi-halaman berlaku untuk petunjuk ini. Jika tidak tersedia, petunjuk ini akan berlaku untuk semua halaman secara default. Nilai ini berindeks 1.

bounding_box

BoundingPoly

Petunjuk kotak pembatas untuk tabel pada halaman ini. Koordinat harus dinormalkan ke [0,1] dan kotak pembatas harus berupa persegi panjang yang sejajar dengan sumbu.

TableDetectionOptions

Opsi untuk deteksi tabel.

Kolom
table_bound_hints[]

TableBoundHint

Petunjuk kotak pembatas tabel opsional yang dapat diberikan untuk kasus kompleks yang tidak dapat ditemukan oleh algoritma kami.

TextAnnotation

TextAnnotation berisi representasi terstruktur dari teks yang diekstrak OCR. Hierarki struktur teks yang diekstrak OCR adalah seperti ini: TextAnnotation -> Halaman -> Blok -> Paragraf -> Kata -> Simbol Setiap komponen struktural, mulai dari Halaman, selanjutnya dapat memiliki propertinya sendiri. Properti menjelaskan bahasa yang terdeteksi, jeda, dll.. Silakan merujuk ke definisi pesan TextAnnotation.TextProperty di bawah untuk detail selengkapnya.

Kolom
pages[]

Page

Daftar halaman yang terdeteksi oleh OCR.

text

string

Teks UTF-8 terdeteksi di halaman.

DetectedBreak

Awal atau akhir yang terdeteksi dari sebuah komponen struktural.

Kolom
type

BreakType

Jenis jeda yang terdeteksi.

is_prefix

bool

True jika jeda menambahkan elemen.

BreakType

Enum untuk menunjukkan jenis jeda yang ditemukan. Baris baru, spasi, dll.

Enum
UNKNOWN Jenis label jeda yang tidak diketahui.
SPACE Spasi reguler.
SURE_SPACE Spasi pasti (sangat lebar).
EOL_SURE_SPACE Jeda penggabungan baris.
HYPHEN Tanda hubung baris akhir yang tidak ada dalam teks; tidak terjadi bersamaan dengan SPACE, LEADER_SPACE, atau LINE_BREAK.
LINE_BREAK Jeda baris yang mengakhiri paragraf.

DetectedLanguage

Bahasa yang terdeteksi untuk komponen struktural.

Kolom
language_code

string

Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

confidence

float

Keyakinan bahasa yang terdeteksi. Rentang [0, 1].

TextProperty

Informasi tambahan terdeteksi pada komponen struktural.

Kolom
detected_languages[]

DetectedLanguage

Daftar bahasa yang terdeteksi bersama dengan tingkat keyakinan.

detected_break

DetectedBreak

Mendeteksi awal atau akhir dari awal segmen teks.

TextDetectionParams

Parameter untuk deteksi teks. Ini digunakan untuk mengontrol fitur TEXT_DETECTION dan DOCUMENT_TEXT_DETECTION.

Kolom
disable_orientation_detection

bool

Menonaktifkan deteksi orientasi sehingga teks yang dirotasi tidak akan terdeteksi. Hanya didukung untuk DOCUMENT_TEXT_DETECTION.

disable_text_annotations

bool

Menonaktifkan kolom text_annotations lama. Hanya full_text_annotations yang akan ditampilkan.

page_filter

FieldMask

Mengontrol data yang ditampilkan di tingkat halaman dalam full_text_annotation. Default jika tidak disetel: Semua kolom disertakan

block_filter

FieldMask

Mengontrol data yang ditampilkan pada tingkat blok dalam full_text_annotation. Default jika tidak disetel: Semua kolom disertakan kecuali merged_text.

paragraph_filter

FieldMask

Mengontrol data yang ditampilkan pada tingkat paragraf dalam full_text_annotation. Default jika tidak disetel: Semua kolom disertakan kecuali merged_text

word_filter

FieldMask

Mengontrol data yang ditampilkan pada tingkat kata dalam full_text_annotation. Default jika tidak disetel: Semua kolom disertakan kecuali merged_text

symbol_filter

FieldMask

Mengontrol data yang ditampilkan pada tingkat simbol dalam full_text_annotation. Default jika tidak disetel: Semua kolom disertakan kecuali bounding_box

UpdateProductRequest

Pesan permintaan untuk metode UpdateProduct.

Kolom
product

Product

Resource Product yang menggantikan resource pada server. product.name tidak dapat diubah.

update_mask

FieldMask

FieldMask yang menentukan kolom yang akan diperbarui. Jika update_mask tidak ditentukan, semua kolom yang dapat diubah akan diperbarui. Jalur penyamaran yang valid mencakup product_labels, display_name, dan description.

UpdateProductSetRequest

Pesan permintaan untuk metode UpdateProductSet.

Kolom
product_set

ProductSet

Resource ProductSet yang menggantikan resource pada server.

update_mask

FieldMask

FieldMask yang menentukan kolom yang akan diperbarui. Jika update_mask tidak ditentukan, semua kolom yang dapat diubah akan diperbarui. Jalur menyamarkan yang valid adalah display_name.

Vertex

verteks mewakili titik 2D pada gambar. CATATAN: koordinat verteks memiliki skala yang sama dengan gambar asli.

Kolom
x

int32

Koordinat x.

y

int32

Koordinat y.

WebDetection

Informasi yang relevan untuk gambar dari Internet.

Kolom
web_entities[]

WebEntity

Menampilkan entity yang disimpulkan dari gambar serupa di Internet.

full_matching_images[]

WebImage

Gambar yang sepenuhnya cocok dari Internet. Dapat menyertakan salinan gambar kueri yang telah diubah ukurannya.

partial_matching_images[]

WebImage

Sebagian gambar yang cocok dari Internet. Gambar tersebut cukup mirip karena sama-sama memiliki beberapa fitur titik kunci. Misalnya, gambar asli kemungkinan akan memiliki kecocokan sebagian dengan gambar yang dipangkas.

pages_with_matching_images[]

WebPage

Menampilkan halaman web yang memuat gambar yang cocok dari Internet.

visually_similar_images[]

WebImage

Hasil gambar yang mirip secara visual.

best_guess_labels[]

WebLabel

Perkiraan terbaik layanan terkait topik gambar permintaan. Inferensi dari gambar yang mirip pada web terbuka.

WebEntity

Entity disimpulkan dari gambar serupa di Internet.

Kolom
entity_id

string

ID entity tersembunyi.

score

float

Skor relevansi keseluruhan untuk entitas. Tidak dinormalisasi dan tidak dapat dibandingkan di berbagai kueri gambar.

description

string

Deskripsi kanolikalisasi dari entitas, dalam Bahasa Inggris.

WebImage

Metadata untuk gambar online.

Kolom
url

string

URL gambar hasil.

score

float

(Tidak digunakan lagi) Skor relevansi keseluruhan untuk gambar.

WebLabel

Label untuk memberikan metadata tambahan bagi deteksi web.

Kolom
label

string

Label untuk metadata tambahan.

language_code

string

Kode bahasa untuk BCP-47 label, seperti "en-US" atau "sr-Latn". Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

WebPage

Metadata untuk halaman web.

Kolom
url

string

URL halaman web hasil.

score

float

(Tidak digunakan lagi) Skor relevansi keseluruhan untuk halaman web.

page_title

string

Judul untuk halaman web, dapat berisi markup HTML.

full_matching_images[]

WebImage

Gambar yang sepenuhnya cocok pada halaman. Dapat menyertakan salinan gambar kueri yang telah diubah ukurannya.

partial_matching_images[]

WebImage

Sebagian gambar yang cocok pada halaman. Gambar tersebut cukup mirip karena sama-sama memiliki beberapa fitur titik kunci. Misalnya, gambar asli kemungkinan akan memiliki kecocokan sebagian dengan gambar yang dipangkas.

WebDetectionParams

Parameter untuk permintaan deteksi web.

Kolom
include_geo_results

bool

Menyertakan hasil yang berasal dari informasi geografis dalam gambar.

Word

Representasi kata.

Kolom
property

TextProperty

Informasi tambahan yang terdeteksi untuk kata tersebut.

bounding_box

BoundingPoly

Kotak pembatas untuk kata. Titik sudut berada dalam urutan dari sudut kiri-atas, kanan-atas, kanan-bawah, kiri-bawah. Jika rotasi kotak pembatas terdeteksi, rotasi akan ditampilkan di sekitar sudut kiri atas seperti yang didefinisikan saat teks dibaca dalam orientasi 'asli'. Misalnya: * saat teks horizontal, tampilannya mungkin seperti ini: 0----1 | | 3----2 * saat diputar 180 derajat mengitari sudut kiri atas menjadi: 2----3 | | 1----0 dan urutan titik sudut akan tetap (0, 1, 2, 3).

symbols[]

Symbol

Daftar simbol dalam kata. Urutan simbol mengikuti urutan pembacaan alamiahnya.

confidence

float

Tingkat keyakinan hasil OCR untuk kata tersebut. Rentang [0, 1].

merged_text

string

Semua teks UTF-8 terdeteksi dalam kata ini. Kolom ini secara default tidak ditampilkan, kecuali jika ditentukan dalam TextDetectionParams.word_filter.