Image Search:Kueri gambar

Metode Konsol

1. Masuk ke Konsol Image Search.

2. Pilih tipe layanan dan instans yang dituju.

3. Klik Image Search. Pada tab Image Search, konfigurasikan parameter pencarian di sebelah kiri, lalu klik Confirm untuk mencari. Hasil pencarian akan ditampilkan dalam format JSON pada bagian Response parameters di sebelah kanan, mencakup bidang seperti score (skor kemiripan), productId, dan picName.

   Parameter	Parameter API	Deskripsi	Wajib
   Tipe pencarian	Type	Tipe pencarian. Nilai yang valid: SearchByPic: Mencari gambar yang mirip dengan gambar yang diberikan. Ini adalah opsi default. SearchByName: Mencari gambar mirip menggunakan gambar yang sebelumnya telah diindeks.	Ya
   Unggah gambar	PicContent	Konten gambar, dikodekan dalam Base64. Gambar harus memenuhi persyaratan berikut: Ukuran gambar tidak boleh melebihi 4 MB. Format yang didukung: PNG, JPG, JPEG, BMP, GIF, WEBP, TIFF, dan PPM. Latensi transfer tidak boleh melebihi 5 detik. Untuk product image search dan generic image search, tinggi dan lebar gambar harus antara 100 hingga 4.096 piksel, inklusif. Gambar tidak boleh mengandung informasi rotasi.	Ya
   Identifikasi subjek	Crop	Menentukan apakah akan melakukan identifikasi subjek pada gambar yang diunggah. true: mengaktifkan identifikasi subjek, termasuk identifikasi otomatis sistem dan identifikasi subjek kustom. Untuk informasi lebih lanjut, lihat deskripsi parameter Subject identification method. false: menonaktifkan identifikasi subjek. Pencarian menggunakan seluruh gambar.	Ya
   Metode identifikasi subjek	Tidak berlaku	Menentukan metode untuk identifikasi subjek. Identifikasi otomatis sistem: Sistem secara otomatis mengidentifikasi subjek dan menggunakan subjek tersebut untuk pencarian. Respons mencakup hasil identifikasi subjek. Wilayah subjek kustom: Anda dapat menyesuaikan wilayah subjek. Formatnya adalah x1,x2,y1,y2, di mana x1,y1 merepresentasikan pojok kiri atas dan x2,y2 merepresentasikan pojok kanan bawah. Klik opsi ini dan seret untuk memilih wilayah subjek. Jika Anda tidak menentukan wilayah subjek kustom, pencarian akan menggunakan seluruh gambar.	Ya
   Kategori gambar	CategoryId	Kategori gambar. Anda dapat menentukan kategori gambar saat melakukan pencarian gambar. Untuk informasi lebih lanjut, lihat Referensi kategori. Catatan Untuk pencarian produk, jika Anda menentukan kategori, layanan akan menggunakannya. Jika tidak, sistem akan melakukan prediksi kategori. Respons mencakup kategori yang diprediksi. Untuk pencarian generic, layanan menetapkan kategori menjadi 88888888, terlepas dari apakah Anda menentukan kategori atau tidak.	Tidak
   Jumlah hasil	Num	Jumlah maksimum hasil mirip yang dikembalikan. Nilai yang valid: 1 hingga 100. Nilai default: 10.	Tidak
   Posisi awal	Start	Posisi awal hasil mirip yang dikembalikan. Nilai yang valid: 0 hingga 499. Nilai default: 0.	Ya
   Kondisi filter	Filter	Anda dapat menentukan kondisi untuk memfilter hasil pencarian. Misalnya, Anda hanya ingin mengembalikan hasil gambar di mana ownerId adalah 1000 atau nama perusahaan adalah "alibaba". Catatan int_attr mendukung operator >, >=, <, <=, =, in, dan not in. 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
   Filter skor kemiripan	ScoreThreshold	Jika Anda menentukan ambang batas skor kemiripan, layanan hanya akan mengembalikan gambar dengan skor lebih besar dari atau sama dengan ambang batas tersebut. Ambang batas dapat berupa nilai dari 0,00 hingga 1,00, dengan maksimal dua tempat desimal. Nilai default adalah 0,00.	Tidak

4. Lihat hasilnya.

   Tabel berikut menjelaskan parameter respons.

   Parameter	Tipe	Contoh	Deskripsi
   Success	Boolean	true	Menentukan apakah permintaan berhasil.
   RequestId	String	36C43E96-8F68-44AA-B1AF-B1F7AB94A6C1	ID permintaan.
   Code	Integer	0	Kode kesalahan. 0: Permintaan berhasil. Nilai bukan nol menunjukkan permintaan gagal.
   Message	String	success	Pesan kesalahan.
   Head	-	-	Berisi informasi tentang hasil pencarian.
   └DocsReturn	Integer	10	Jumlah hasil yang dikembalikan.
   └DocsFound	Integer	10000	Jumlah hasil yang cocok dalam instans.
   └SearchTime	Integer	95	Durasi pencarian, dalam milidetik.
   PicInfo	-	-	Informasi tentang hasil prediksi kategori dan identifikasi subjek.
   └CategoryId	Integer	88888888	Hasil prediksi kategori. Jika Anda menentukan kategori dalam permintaan, parameter ini akan mengembalikan kategori tersebut.
   └Region	String	280,486,232,351	Hasil identifikasi subjek. Ini adalah wilayah subjek gambar, dalam format x1,x2,y1,y2. x1 dan y1 merepresentasikan pojok kiri atas, dan x2 dan y2 merepresentasikan pojok kanan bawah. Jika Anda menentukan wilayah subjek dalam permintaan, parameter ini akan mengembalikan wilayah tersebut.
   └AllCategories	-	-	Daftar semua kategori yang didukung.
   └└Name	String	Tops	Nama kategori.
   └└Id	Integer	0	ID kategori.
   └MultiRegion	-	-	Kumpulan hasil identifikasi subjek. Catatan Parameter ini tersedia hanya di V3.1.1 dan versi setelahnya.
   └└Region	String	280,486,232,351	Hasil identifikasi subjek. Ini adalah wilayah subjek gambar, dalam format x1,x2,y1,y2. x1 dan y1 merepresentasikan pojok kiri atas, dan x2 dan y2 merepresentasikan pojok kanan bawah. Jika Anda menentukan wilayah subjek dalam permintaan, parameter ini akan mengembalikan wilayah tersebut.
   Auctions	-	-	Deskripsi 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. Kami menyarankan Anda menggunakan Score sebagai gantinya.
   └Score	Float	1	Skor kemiripan gambar. Rentang nilai: 0 hingga 1. Catatan Parameter ini tersedia hanya di V3.1.1 dan versi setelahnya.
   └IntAttr	Integer	0	Atribut integer produk.
   └IntAttr2	Integer	0	Atribut integer produk.
   └IntAttr3	Integer	0	Atribut integer produk.
   └IntAttr4	Integer	0	Atribut integer produk.
   └StrAttr	String	demoStrAttr	Atribut string produk.
   └StrAttr2	String	demoStrAttr	Atribut string produk.
   └StrAttr3	String	demoStrAttr	Atribut string produk.
   └StrAttr4	String	demoStrAttr	Atribut string produk.

Metode API

Anda dapat mengakses layanan secara langsung melalui protokol HTTP atau HTTPS. Autentikasi dilakukan menggunakan mekanisme signature, dan badan permintaan harus dikirim dalam format tertentu. QPS untuk kueri gambar mirip melalui API ditentukan oleh paket QPS yang dibeli. Untuk detail lebih lanjut, lihat Cari gambar berdasarkan nama atau Cari gambar berdasarkan gambar.

Metode SDK

Image Search menyediakan berbagai versi SDK sehingga Anda tidak perlu menangani pengaturan kompleks seperti verifikasi signature dan penyusunan badan permintaan. QPS untuk kueri gambar mirip melalui SDK ditentukan oleh paket QPS yang dibeli. Untuk detail lebih lanjut, lihat Referensi SDK.