All Products
Search
Document Center

Image Search:Kondisi filter

Last Updated:Jun 21, 2026

Di Image Search, gunakan kondisi filter untuk hanya mengembalikan gambar yang memenuhi kriteria Anda. Misalnya, Anda dapat mengembalikan gambar dengan ownerId bernilai 1000 atau nama perusahaan 'alibaba'.

Pengaturan bidang

Saat menambahkan gambar, Anda dapat menetapkan delapan bidang atribut: IntAttr, IntAttr2, IntAttr3, IntAttr4, StrAttr, StrAttr2, StrAttr3, dan StrAttr4. Bidang-bidang ini terdiri dari empat atribut integer dan empat atribut string yang digunakan untuk memfilter gambar saat pencarian. Image Search mendukung beberapa metode penambahan gambar. Contoh berikut menunjukkan cara menetapkan atribut tersebut untuk setiap metode.

  • Tambahkan gambar menggunakan operasi batch.

    {"OperationType": "ADD","ProductId": "1000","CategoryId": 0,"IntAttr": 123,"IntAttr2": 135,"StrAttr": "value1","StrAttr2": "value2","IntAttr3": 3,"StrAttr4": "value4","CustomContent": "k1:v1,k2:v2,k3:v3","PicName": "girl_cloth1.jpg"}
  • Tambahkan gambar menggunakan SDK. Untuk informasi lebih lanjut, lihat Add API.

  • Tambahkan gambar menggunakan Konsol.

    Di halaman Add Image di Konsol, Anda dapat menetapkan nilai untuk atribut IntAttr, IntAttr2, IntAttr3, IntAttr4, StrAttr, StrAttr2, StrAttr3, dan StrAttr4. Isi bidang berikut: Product ID (misalnya, 1), Image Name (misalnya, 1.jpg), dan Upload Image. Aktifkan sakelar Object Detection, lalu atur Object Detection Mode ke Auto. Selanjutnya, tentukan Image Category, Custom Content, Integer Attribute (misalnya, 1000), String Attribute (misalnya, str2345), Integer Attribute 2 (misalnya, 200), dan String Attribute 2 (misalnya, str9999). Setelah selesai, klik Confirm. Tanggapan sukses akan mengembalikan objek JSON dengan bidang code bernilai 0, bidang message bernilai success, dan bidang statusCode bernilai 200. Tanggapan tersebut juga mencakup categoryId dan region dalam objek picInfo.

Filtering bidang

Saat melakukan pencarian, tentukan kondisi filter untuk mempersempit hasil. Anda dapat menggabungkan beberapa kondisi menggunakan operator logika AND atau OR.

  • Operator berikut didukung untuk int_attr, int_attr2, int_attr3, dan int_attr4:

    • >

    • >=

    • <

    • <=

    • =

    • in

    • not in

  • Operator berikut didukung untuk str_attr, str_attr2, str_attr3, dan str_attr4:

    • =

    • !=

    • in

    • not in

Contoh:

int_attr>=100
str_attr!="value1"
int_attr=1000 AND str_attr="value1"
int_attr = 1000 AND  int_attr2 = 200 AND str_attr = "str2345" AND str_attr2="str9999"
  • Lakukan pencarian menggunakan API. Untuk informasi lebih lanjut, lihat Parameter permintaan.

    Tetapkan parameter filter dalam permintaan API Anda ke kondisi filter yang diinginkan.

  • Lakukan pencarian menggunakan SDK. Untuk informasi lebih lanjut, lihat SearchImageByPic API.

    Panggil metode setFilterClause dari kelas SearchItemRequest untuk menetapkan kondisi filter.

  • Lakukan pencarian menggunakan Konsol.

    Tetapkan Filter condition berdasarkan contoh sebelumnya. Di tab Image Search, pilih SearchByPic sebagai tipe pencarian, unggah gambar yang akan digunakan untuk pencarian, lalu aktifkan deteksi objek (mode deteksi: Auto). Atur jumlah hasil menjadi 10 dan posisi awal menjadi 0. Di kotak input Filter condition, masukkan ekspresi filter Anda, misalnya, int_attr = 1000 AND int_attr2 = 200 AND str_attr = "str2345" AND str_attr2 = "str9999". Klik Confirm. Jika hasil JSON yang dikembalikan menunjukkan bahwa docsFound dan docsReturn keduanya bernilai 1, serta nilai bidang dari catatan yang cocok (int_attr:1000, int_attr2:200, str_attr:"str2345", str_attr2:"str9999") sesuai dengan kondisi filter, maka hal ini mengonfirmasi bahwa filtering bidang berfungsi dengan benar.