Cercare immagini sui siti web

Con Vertex AI Search puoi cercare immagini utilizzando un'app con dati di siti web. Fornisci una query sotto forma di stringa di testo o immagine e il metodo default_config.search restituisce le immagini per quella query.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti. I requisiti variano a seconda che la ricerca venga eseguita utilizzando una query di testo o una query di immagini.

Per utilizzare la riga di comando per visualizzare l'anteprima dei risultati delle immagini per un sito web, utilizza il metodo engines.servingConfigs.search:

  1. Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.

    1. Nella Google Cloud console, vai alla pagina AI Applications.

      Vai ad App

    2. Nella pagina App, trova il nome della tua app e recupera il relativo ID dalla colonna ID.

  2. Chiama il metodo engines.servingConfigs.search, specificando 1 per search_type. Scegli la sintassi del metodo a seconda che la query sia testo o byte di immagine.

    La query è una stringa di testo

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

    La query è un'immagine

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

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto.

    • APP_ID: l'ID della tua app.

    • QUERY: il testo della query di ricerca. Ad esempio, "Auto con fari rotondi" o "mostrami un vestito a righe".

    • IMAGE_BYTES: l'immagine in byte codificati in Base64. I formati supportati sono JPEG, PNG e BMP.

    • PAGE_SIZE: facoltativo. Il numero di risultati restituiti dalla ricerca. Il valore predefinito è 10 per la ricerca sui siti web.

      • I valori inferiori a 0 causano un errore.
      • I valori superiori a 100 vengono impostati su 100.

    • OFFSET: facoltativo. L'indice iniziale dei risultati. Il valore predefinito è 0.

      Ad esempio, se l'offset è 2 e la dimensione della pagina è 10, vengono restituiti i risultati da 2 a 11.

  3. Esamina la risposta. Consulta la tabella seguente per le descrizioni dei campi:

    Campo Descrizione
    title Il titolo in testo normale della pagina web che contiene l'immagine
    htmlTitle Il titolo, in HTML, della pagina web che contiene l'immagine
    displayLink Una versione abbreviata dell'URL del risultato di questa ricerca, di solito il nome di dominio, ad esempio www.example.com
    link L'URL dell'immagine
    image.contextLink Link contestuale: un URL che rimanda alla pagina web contenente l'immagine
    image.byteSize Le dimensioni dell'immagine, in byte
    image.width La larghezza dell'immagine, in pixel.
    image.height L'altezza dell'immagine, in pixel
    image.thumbnailWidth La larghezza dell'immagine in miniatura, in pixel
    image.thumbnailHeight L'altezza dell'immagine in miniatura, in pixel.
    image.thumbnailLink L'URL dell'immagine in miniatura
    mime Il tipo MIME dell'immagine
    fileFormat Il formato del file dell'immagine