Image Search:Kueri gambar

Metode Konsol

1. Masuk ke Image Search console.

2. Pilih tipe layanan dan instans yang dituju.

3. Klik Image Search.

   Parameter	Parameter API yang sesuai	Deskripsi	Wajib
   Search type	Type	Tersedia dua jenis pencarian: SearchByPic: Mencari gambar serupa berdasarkan gambar yang ditentukan. Ini adalah nilai default. SearchByName: Mencari gambar serupa berdasarkan gambar yang sebelumnya telah ditambahkan.	Ya
   Upload image	PicContent	Konten gambar dalam format Base64. Gambar harus memenuhi persyaratan berikut: Ukuran gambar tidak boleh melebihi 4 MB. Gambar harus dalam format PNG, JPG, JPEG, BMP, GIF, WEBP, TIFF, atau PPM. Latensi transfer kurang dari 5 detik. Untuk product image search dan generic image search, tinggi dan lebar gambar harus antara 100 hingga 4096 piksel, inklusif. Gambar tidak boleh mengandung informasi rotasi.	Ya
   Subject identification	Crop	Menentukan apakah sistem akan mendeteksi subjek dalam gambar yang diunggah selama pencarian. Jika diatur ke true: Sistem melakukan identifikasi subjek, termasuk identifikasi otomatis oleh sistem dan identifikasi subjek kustom. Untuk detailnya, lihat parameter Subject identification method. false: Tidak mendeteksi subjek. Seluruh gambar digunakan untuk pencarian.	Ya
   Subject identification method	N/A	Metode identifikasi subjek: System automatic identification: Sistem secara otomatis mendeteksi subjek dan menggunakannya untuk pencarian. Hasil identifikasi subjek tersedia dalam respons. Custom subject region: Anda dapat menentukan wilayah kustom untuk identifikasi subjek. Formatnya adalah x1,x2,y1,y2, dengan x1,y1 sebagai koordinat titik kiri atas dan x2,y2 sebagai koordinat titik kanan bawah. Jika memilih opsi ini, Anda dapat menyeret kotak untuk memilih wilayah subjek pada gambar. Jika tidak menentukan wilayah kustom, seluruh gambar digunakan untuk pencarian.	Ya
   Image category	CategoryId	Kategori gambar, yaitu CategoryId. Anda dapat menentukan kategori untuk gambar selama pencarian. Untuk informasi lebih lanjut, lihat Category reference. Catatan Untuk product search, jika Anda menetapkan kategori, kategori tersebut yang digunakan. Jika tidak menetapkan kategori, sistem akan memprediksi satu kategori. Kategori yang diprediksi tersedia dalam respons. Untuk pencarian generic, sistem menetapkan kategori ke 88888888, terlepas dari apakah Anda menentukan kategori atau tidak.	Tidak
   Number of results	Num	Jumlah maksimum hasil serupa yang dikembalikan. Nilainya harus dalam rentang 1 hingga 100. Nilai default adalah 10.	Tidak
   Start position of results	Start	Posisi awal hasil serupa yang dikembalikan. Nilainya harus dalam rentang 0 hingga 499. Nilai default adalah 0.	Ya
   Filter condition	Filter	Anda dapat menetapkan kondisi filter untuk hanya mengembalikan hasil gambar yang memenuhi kondisi tersebut. Misalnya, Anda dapat mengembalikan hanya hasil gambar di mana ownerId adalah 1000, atau nama perusahaan adalah "alibaba". Catatan Bidang `int_attr` mendukung operator >, >=, <, <=, =, in, dan not in. Bidang `str_attr` mendukung operator =, !=, in, dan not in. Anda dapat menggunakan AND dan OR untuk menghubungkan beberapa kondisi. Contoh: `int_attr=1000 AND str_attr="value1"`.	Tidak
   Similarity score filter	ScoreThreshold	Setelah Anda menentukan ambang batas skor kemiripan, sistem hanya akan mengembalikan informasi gambar dengan skor kemiripan yang lebih besar dari atau sama dengan ambang batas tersebut. Ambang batas harus dalam rentang 0,00 hingga 1,00, dengan dukungan hingga dua tempat desimal. Nilai default adalah 0,00.	Tidak

4. Lihat hasil yang dikembalikan.

   Tabel berikut menjelaskan parameter dalam respons.

   Parameter	Type	Contoh	Deskripsi
   Success	Boolean	true	Menunjukkan apakah permintaan berhasil.
   RequestId	String	36C43E96-8F68-44AA-B1AF-B1F7AB94A6C1	ID permintaan.
   Code	Integer	0	Kode kesalahan: 0 menunjukkan keberhasilan. Nilai bukan nol menunjukkan kegagalan.
   Message	String	success	Pesan kesalahan.
   Head	-	-	Informasi tentang hasil pencarian.
   └DocsReturn	Integer	10	Jumlah hasil yang dikembalikan.
   └DocsFound	Integer	10000	Jumlah hasil yang ditemukan dalam instans.
   └SearchTime	Integer	95	Waktu yang dibutuhkan untuk pencarian, dalam milidetik.
   PicInfo	-	-	Informasi seperti hasil prediksi kategori dan identifikasi subjek.
   └CategoryId	Integer	88888888	Hasil prediksi kategori. Jika kategori ditentukan dalam permintaan, kategori yang ditentukan tersebut dikembalikan.
   └Region	String	280,486,232,351	Hasil identifikasi subjek. Ini adalah wilayah subjek gambar dalam format x1,x2,y1,y2, dengan x1 dan y1 sebagai koordinat titik kiri atas, serta x2 dan y2 sebagai koordinat titik kanan bawah. Jika wilayah subjek ditentukan dalam permintaan, wilayah yang ditentukan tersebut dikembalikan.
   └AllCategories	-	-	Informasi tentang semua kategori yang didukung sistem.
   └└Name	String	Tops	Nama kategori.
   └└Id	Integer	0	ID kategori.
   └MultiRegion	-	-	Kumpulan hasil identifikasi subjek. Catatan Anda harus melakukan upgrade ke versi V3.1.1 untuk menggunakan fitur ini.
   └└Region	String	280,486,232,351	Hasil identifikasi subjek. Ini adalah wilayah subjek gambar dalam format x1,x2,y1,y2, dengan x1 dan y1 sebagai koordinat titik kiri atas, serta x2 dan y2 sebagai koordinat titik kanan bawah. Jika wilayah subjek ditentukan dalam permintaan, wilayah yang ditentukan tersebut dikembalikan.
   Auctions	-	-	Informasi deskriptif untuk semua produk yang dikembalikan.
   └CustomContent	String	Demo Custom Content	Konten kustom.
   └PicName	String	DemoPic	Nama gambar.
   └CategoryId	Integer	0	Kategori gambar.
   └ProductId	String	test	ID produk.
   └SortExprValues	String	7.33136443711219e+24;0	Informasi penilaian sistem. Catatan Bidang ini sudah tidak digunakan lagi. Gunakan Score sebagai gantinya.
   └Score	Float	1	Skor kemiripan gambar. Nilainya dalam rentang 0 hingga 1. Catatan Anda harus melakukan upgrade ke versi V3.1.1 untuk menggunakan fitur ini.
   └IntAttr	Integer	0	Atribut integer.
   └IntAttr2	Integer	0	Atribut integer.
   └IntAttr3	Integer	0	Atribut integer.
   └IntAttr4	Integer	0	Atribut integer.
   └StrAttr	String	demoStrAttr	Atribut string.
   └StrAttr2	String	demoStrAttr	Atribut string.
   └StrAttr3	String	demoStrAttr	Atribut string.
   └StrAttr4	String	demoStrAttr	Atribut string.

Metode API

Anda dapat langsung mengakses layanan melalui HTTP atau HTTPS. Permintaan harus diautentikasi menggunakan mekanisme penandatanganan dan badan permintaan harus diformat sesuai ketentuan. Jumlah maksimum kueri per detik (QPS) ditentukan oleh paket sumber daya yang Anda beli. Untuk informasi lebih lanjut, lihat Search for an image by name atau Search for an image by picture.

Metode SDK (disarankan)

Image Search menyediakan SDK untuk berbagai bahasa pemrograman. Anda tidak perlu mengelola konfigurasi kompleks seperti otentikasi signature atau penyusunan badan permintaan. Jumlah maksimum kueri per detik (QPS) ditentukan oleh paket sumber daya yang Anda beli. Untuk informasi lebih lanjut, lihat SDK reference.