Vertex AI Search を使用すると、ウェブサイト データを含むアプリを使用して画像を検索できます。テキスト文字列または画像の形式でクエリを指定し、default_config.search
メソッドがそのクエリの画像を返します。
始める前に
次の前提条件を満たしていることを確認してください。要件は、テキストクエリと画像クエリのどちらを使用して検索するかによって異なります。
ウェブサイト検索アプリでテキストクエリを使用して検索する場合は、[Enterprise エディションの機能] がオンになっていることを確認します。
ウェブサイト検索アプリで画像クエリを使用して検索する場合は、次の機能がオンになっていることを確認します。
画像検索をプレビューする
コマンドラインを使用してウェブサイトの画像結果をプレビューするには、engines.servingConfigs.search
メソッドを使用します。
アプリ ID を確認します。アプリ ID がすでにある場合は、次のステップに進みます。
Google Cloud コンソールで、[AI Applications] ページに移動します。
[アプリ] ページで、アプリの名前を見つけ、[ID] 列からアプリの ID を取得します。
engines.servingConfigs.search
メソッドを呼び出し、search_type
に1
を指定します。クエリがテキストか画像バイトかによって、メソッドの構文を選択します。クエリがテキスト文字列である
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_config:search" \ -d '{ "servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search", "query": "QUERY", "pageSize": "PAGE_SIZE", "offset": "OFFSET", "params": {"search_type": 1} }'
クエリが画像である
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \ -d '{ "servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search", "imageQuery": {"imageBytes":"IMAGE_BYTES"}, "pageSize": "PAGE_SIZE", "offset": "OFFSET", "params": {"search_type": 1} }'
次のように置き換えます。
PROJECT_ID
: 実際のプロジェクトの ID。APP_ID
: アプリの ID。QUERY
: 検索クエリのテキスト。たとえば、「丸いヘッドライトの車」や「ストライプのドレスを見せて」などです。IMAGE_BYTES
: Base64 でエンコードされたバイトの画像。サポートされている形式は JPEG、PNG、BMP です。PAGE_SIZE
: 省略可。検索によって返された結果の数。ウェブサイト検索のデフォルト値は 10 です。- 0 未満の値はエラーになります。
- 100 を超える値は 100 に設定されます。
OFFSET
: 省略可。結果の開始インデックス。 デフォルト値は 0 です。たとえば、オフセットが 2 でページサイズが 10 の場合、結果 2 から 11 が返されます。
回答を確認します。 フィールドの説明については、次の表をご覧ください。
項目 説明 title
画像を含むウェブページの書式なしテキストのタイトル htmlTitle
画像を含むウェブページの HTML 形式のタイトル displayLink
この検索結果の URL の省略形、通常はドメイン名(例: www.example.com
)link
画像の URL image.contextLink
コンテキスト リンク: 画像を含むウェブページを指す URL image.byteSize
画像のサイズ(バイト単位) image.width
画像の幅(ピクセル単位) image.height
画像の高さ(ピクセル単位) image.thumbnailWidth
画像の幅(ピクセル単位) image.thumbnailHeight
画像の高さ(ピクセル単位) image.thumbnailLink
サムネイル画像の URL mime
画像の MIME タイプ fileFormat
画像のファイル形式