Setelah membuat set produk dan kumpulan produk telah diindeks, Anda dapat membuat kueri untuk set produk tersebut menggunakan Cloud Vision API.
Product search yang cocok
Anda dapat menemukan produk yang serupa dengan gambar tertentu dengan meneruskan URI Google Cloud Storage, URL web, atau string berenkode base64 ke Product Search Vision API. Lihat Batas Penggunaan untuk mengetahui informasi kuota dan ukuran permintaan maksimum.
Lihat topik Memahami respons penelusuran & multi-deteksi untuk contoh deteksi produk tunggal dan multi-deteksi produk dalam gambar.
Menelusuri menggunakan gambar lokal
Contoh berikut membaca file lokal dan membuat kueri API dengan menyertakan bagian dari byte gambar mentah (gambar berenkode base64) dalam permintaan.
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- BASE64_ENCODED_IMAGE: Representasi
base64 (string ASCII) dari data gambar biner Anda. String ini akan terlihat seperti
string berikut:
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- PROJECT_ID: ID project Google Cloud Anda.
- LOCATION_ID: ID lokasi yang valid. ID lokasi yang valid adalah:
us-west1
,us-east1
,europe-west1
, danasia-east1
. - PRODUCT_SET_ID: ID untuk set produk tempat Anda ingin menjalankan operasi.
Pertimbangan khusus kolom:
features.maxResults
- Jumlah hasil maksimum yang akan ditampilkan.imageContext.productCategories
- Kategori produk yang akan ditelusuri. Saat ini Anda hanya dapat menentukan satu kategori produk (peralatan rumah tangga, pakaian, mainan, barang kemasan, dan umum ).imageContext.filter
- (Opsional) Ekspresi pemfilteran nilai kunci (atau beberapa ekspresi) untuk label produk. Format: "key
=value
". Memfilter key-value pair dapat ditautkan dengan ekspresi AND atau OR: "color
=blue
DAN,style
=mens
", atau "color
=blue
ATAUcolor
=black
". Jika menggunakan ekspresi ORsemua kunci dalam ekspresi harus sama singkat ini.
Metode HTTP dan URL:
POST https://vision.googleapis.com/v1/images:annotate
Isi JSON permintaan:
{ "requests": [ { "image": { "content": base64-encoded-image }, "features": [ { "type": "PRODUCT_SEARCH", "maxResults": 5 } ], "imageContext": { "productSearchParams": { "productSet": "projects/project-id/locations/location-id/productSets/product-set-id", "productCategories": [ "apparel" ], "filter": "style = womens" } } } ] }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: project-id" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://vision.googleapis.com/v1/images:annotate"
PowerShell
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1/images:annotate" | Select-Object -Expand Content
Jika permintaan berhasil, server akan menampilkan kode status HTTP 200 OK
dan
respons dalam format JSON.
JSON respons mencakup dua jenis hasil berikut:
productSearchResults
- Berisi daftar produk yang cocok untuk seluruh gambar. Dalam respons sampel, produk yang cocok adalah: product_id65, product_id35, product_id34, product_id62, product_id32.productGroupedResults
- Berisi koordinat kotak pembatas dan item yang cocok untuk setiap produk yang diidentifikasi dalam gambar. Dalam respons berikut, hanya ada satu produk yang diidentifikasi, diikuti dengan produk yang cocok dalam sampel kumpulan produk: product_id65, product_id35, product_id34, product_id93, product_id62.
Perhatikan bahwa meskipun ada tumpang tindih di kedua jenis hasil, mungkin juga ada perbedaan (misalnya, product_id32 dan product_id93 dalam respons).
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Vision API Product Search, lihat library klien Vision API Product Search. Untuk informasi selengkapnya, lihat dokumentasi referensi API Go Product Search Vision API.
Untuk mengautentikasi ke Product Search Vision API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Vision API Product Search, lihat library klien Vision API Product Search. Untuk informasi selengkapnya, lihat dokumentasi referensi API Java Product Search Vision API.
Untuk mengautentikasi ke Product Search Vision API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Vision API Product Search, lihat library klien Vision API Product Search. Untuk informasi selengkapnya, lihat dokumentasi referensi API Node.js Product Search Vision API.
Untuk mengautentikasi ke Product Search Vision API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Vision API Product Search, lihat library klien Vision API Product Search. Untuk informasi selengkapnya, lihat dokumentasi referensi API Python Product Search Vision API.
Untuk mengautentikasi ke Product Search Vision API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Bahasa tambahan
C# : Ikuti Petunjuk penyiapan C# di halaman library klien, lalu kunjungi Dokumentasi referensi Product Search Vision API untuk .NET.
PHP : Ikuti Petunjuk penyiapan PHP di halaman library klien, lalu kunjungi Dokumentasi referensi Product Search Vision API untuk PHP.
Ruby : Ikuti Petunjuk penyiapan Ruby di halaman library klien, lalu kunjungi Dokumentasi referensi Vision API Product Search untuk Ruby.
Telusuri menggunakan gambar jarak jauh
Anda juga memiliki opsi untuk menemukan produk yang serupa pada gambar yang diberikan dengan menentukan URI Google Cloud Storage ke gambar tersebut.
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- CLOUD_STORAGE_IMAGE_URI: jalur ke file gambar
yang valid di bucket Cloud Storage. Anda setidaknya harus memiliki hak istimewa baca ke file tersebut.
Contoh:
gs://storage-bucket/filename.jpg
- PROJECT_ID: ID project Google Cloud Anda.
- LOCATION_ID: ID lokasi yang valid. ID lokasi yang valid adalah:
us-west1
,us-east1
,europe-west1
, danasia-east1
. - PRODUCT_SET_ID: ID untuk set produk tempat Anda ingin menjalankan operasi.
Pertimbangan khusus kolom:
features.maxResults
- Jumlah hasil maksimum yang akan ditampilkan.imageContext.productCategories
- Kategori produk yang akan ditelusuri. Saat ini Anda hanya dapat menentukan satu kategori produk (peralatan rumah tangga, pakaian, mainan, barang kemasan, dan umum ).imageContext.filter
- (Opsional) Ekspresi pemfilteran nilai kunci (atau beberapa ekspresi) untuk label produk. Format: "key
=value
". Memfilter key-value pair dapat ditautkan dengan ekspresi AND atau OR: "color
=blue
DAN,style
=mens
", atau "color
=blue
ATAUcolor
=black
". Jika menggunakan ekspresi ORsemua kunci dalam ekspresi harus sama singkat ini.
Metode HTTP dan URL:
POST https://vision.googleapis.com/v1/images:annotate
Isi JSON permintaan:
{ "requests": [ { "image": { "source": { "gcsImageUri": "cloud-storage-image-uri" } }, "features": [ { "type": "PRODUCT_SEARCH", "maxResults": 5 } ], "imageContext": { "productSearchParams": { "productSet": "projects/project-id/locations/location-id/productSets/product-set-id", "productCategories": [ "apparel" ], "filter": "style = womens" } } } ] }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: project-id" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://vision.googleapis.com/v1/images:annotate"
PowerShell
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1/images:annotate" | Select-Object -Expand Content
Jika permintaan berhasil, server akan menampilkan kode status HTTP 200 OK
dan
respons dalam format JSON.
JSON respons mencakup dua jenis hasil berikut:
productSearchResults
- Berisi daftar produk yang cocok untuk seluruh gambar. Dalam respons sampel, produk yang cocok adalah: product_id65, product_id35, product_id34, product_id62, product_id32.productGroupedResults
- Berisi koordinat kotak pembatas dan item yang cocok untuk setiap produk yang diidentifikasi dalam gambar. Dalam respons berikut, hanya ada satu produk yang diidentifikasi, diikuti dengan produk yang cocok dalam sampel kumpulan produk: product_id65, product_id35, product_id34, product_id93, product_id62.
Perhatikan bahwa meskipun ada tumpang tindih di kedua jenis hasil, mungkin juga ada perbedaan (misalnya, product_id32 dan product_id93 dalam respons).
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Vision API Product Search, lihat library klien Vision API Product Search. Untuk informasi selengkapnya, lihat dokumentasi referensi API Go Product Search Vision API.
Untuk mengautentikasi ke Product Search Vision API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Vision API Product Search, lihat library klien Vision API Product Search. Untuk informasi selengkapnya, lihat dokumentasi referensi API Java Product Search Vision API.
Untuk mengautentikasi ke Product Search Vision API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Vision API Product Search, lihat library klien Vision API Product Search. Untuk informasi selengkapnya, lihat dokumentasi referensi API Node.js Product Search Vision API.
Untuk mengautentikasi ke Product Search Vision API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Vision API Product Search, lihat library klien Vision API Product Search. Untuk informasi selengkapnya, lihat dokumentasi referensi API Python Product Search Vision API.
Untuk mengautentikasi ke Product Search Vision API, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Bahasa tambahan
C# : Ikuti Petunjuk penyiapan C# di halaman library klien, lalu kunjungi Dokumentasi referensi Product Search Vision API untuk .NET.
PHP : Ikuti Petunjuk penyiapan PHP di halaman library klien, lalu kunjungi Dokumentasi referensi Product Search Vision API untuk PHP.
Batu Delima : Ikuti Petunjuk penyiapan Ruby di halaman library klien, lalu kunjungi Dokumentasi referensi Vision API Product Search untuk Ruby.