Menelusuri gambar di situs

Dengan Penelusuran Agen, Anda dapat menelusuri gambar menggunakan aplikasi dengan data situs. Anda memberikan kueri dalam bentuk string teks atau gambar, dan metode default_config.search menampilkan gambar untuk kueri tersebut.

Sebelum memulai

Pastikan Anda memenuhi prasyarat berikut. Persyaratan bervariasi bergantung pada apakah Anda menelusuri menggunakan kueri teks atau kueri gambar.

Untuk menggunakan command line guna melihat pratinjau hasil gambar untuk situs, gunakan metode engines.servingConfigs.search:

  1. Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.

    1. Di Google Cloud konsol, buka halaman AI Applications.

      Buka Aplikasi

    2. Di halaman Apps, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

  2. Panggil metode engines.servingConfigs.search, dengan menentukan 1 untuk search_type. Pilih sintaksis metode bergantung pada apakah kueri Anda berupa teks atau byte gambar.

    Kueri adalah string teks

    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}
}'

    Kueri adalah gambar

    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}
}'

    Ganti kode berikut:

    • PROJECT_ID: ID project Anda.

    • APP_ID: ID aplikasi Anda.

    • QUERY: teks kueri penelusuran. Misalnya, "Mobil lampu depan bulat" atau "tampilkan gaun dengan garis-garis".

    • IMAGE_BYTES: gambar dalam byte berenkode Base64. Format yang didukung adalah JPEG, PNG, dan BMP.

    • PAGE_SIZE: opsional. Jumlah hasil yang ditampilkan oleh penelusuran. Nilai defaultnya adalah 10 untuk penelusuran situs.

      • Nilai di bawah 0 menyebabkan error.
      • Nilai di atas 100 menyebabkan nilai ditetapkan ke 100.

    • OFFSET: opsional. Indeks awal hasil. Nilai defaultnya adalah 0.

      Misalnya, jika offset adalah 2 dan ukuran halaman adalah 10, hasil 2 hingga 11 akan ditampilkan.

  3. Tinjau respons. Lihat tabel berikut untuk mengetahui deskripsi kolom:

    Kolom Deskripsi
    title Judul teks biasa dari halaman web yang berisi gambar
    htmlTitle Judul, dalam HTML, dari halaman web yang berisi gambar
    displayLink Versi singkat dari URL hasil penelusuran ini, biasanya nama domain—misalnya, www.example.com
    link URL gambar
    image.contextLink Link konteks: URL yang mengarah ke halaman web yang berisi gambar
    image.byteSize Ukuran gambar, dalam byte
    image.width Lebar gambar, dalam piksel
    image.height Tinggi gambar, dalam piksel
    image.thumbnailWidth Lebar gambar thumbnail, dalam piksel
    image.thumbnailHeight Tinggi gambar thumbnail, dalam piksel
    image.thumbnailLink URL gambar thumbnail
    mime Jenis MIME gambar
    fileFormat Format file gambar