画像を検索する場合、条件に一致する画像のみが返されるよう、フィルター条件を指定することができます。 たとえば、所有者 ID が 1000 の画像、または社名が Alibaba の画像のみが返されるよう、フィルター条件を指定できます。

インスタンスバージョンの要件

フィルター機能は、2018 年 3 月 27 日よりあとに作成されたインスタンスでのみサポートされています。 2018 年 3 月 27 日以前に作成されたインスタンスでは、インスタンスのアップグレード後にこの機能が利用できます。 インスタンスをアップグレードするには、チケットを起票してサポートセンターにお問い合わせください。

フィールドの指定

画像を追加する場合、IntAttr フィールドと StrAttr フィールドを指定する必要があります。 IntAttr フィールドは整数フィールドを表し、StrAttr フィールドは文字列フィールドを表します。 これらの 2 つのフィールドに基づいて画像を検索できます。 Image Search では、複数の方法で画像を追加できます。 以下に、さまざまな方法で IntAttr フィールドと StrAttr フィールドを指定する場合の例を示します。

  • バッチ操作を実行して画像を追加する場合は、以下の例を参照して IntAttr フィールドと StrAttr フィールドを指定します。 詳細については、「バッチ操作の実行」をご参照ください。
    {"OperationType": "ADD","ProductId": "1000","CategoryId": 0,"IntAttr": 123,"StrAttr": "value1","CustomContent": "k1:v1,k2:v2,k3:v3","PicName": "girl_cloth1.jpg"}
  • SDK V1.0.3 以降を使用して画像を追加する場合は、AddItemRequest オブジェクトで setIntAttr メソッドと setStrAttr メソッドを呼び出します。 詳細については、「Add」をご参照ください。

  • Image Search コンソールで画像を追加する場合は、以下の操作を実行します。
    Image Search コンソールで、[サンプルイメージの追加] タブの [整数属性] および [文字列属性] パラメーターを指定します。 Image Search コンソールでフィールドを指定する

フィルター条件を指定して画像を検索する

画像を検索する場合、条件に一致する画像が返されるよう、フィルター条件を指定することができます。 複数のフィルター条件は AND または OR で接続します。
  • int_attr フィールドでは、以下の演算子を使用できます。
    • >
    • >=
    • <
    • <=
    • =
  • str_attr フィールドでは、以下の演算子を使用できます。
    • =
    • !=

例:

int_attr>=100
str_attr!="value1"
int_attr=1000 AND str_attr="value1"
  • API を呼び出して画像を検索する場合は、API で filter パラメーターを設定してフィルター条件を指定します。 詳細については、「リクエストパラメーター」をご参照ください。

  • SDK を使用して画像を検索する場合は、SearchItemRequest オブジェクトで setFilterClause メソッドを呼び出してフィルター条件を指定します。 詳細については、「SearchImageByPic」をご参照ください。

  • Image Search コンソールで画像を検索する場合は、以下の操作を実行します。
    [画像で検索] タブで、前述の例に基づいて [フィルター条件] パラメーターを指定できます。 Image Search コンソールでフィルター条件を指定する