Ricerca dei dati del data warehouse video batch

Prerequisito: crea un magazzino video batch con un indice di cui è stato eseguito il deployment.

Cercare i dati del Video Warehouse batch nella console

Console

  1. Apri la scheda Magazzini della dashboard di Vertex AI Vision.

    Vai alla scheda Magazzini

  2. Individua l'endpoint dell'indice in cui vuoi eseguire la ricerca e fai clic su Cerca asset.

  3. Vedrai un elenco di video (ognuno corrispondente a una risorsa), nonché una barra di ricerca in alto. Puoi fare clic su un video per visualizzarlo o iniziare a cercare video.

  4. Per iniziare a cercare, inserisci una query di testo o carica un'immagine come query di ricerca. Sul lato destro della pagina dei risultati di ricerca vedrai un elenco di clip video, ognuno dei quali corrisponde a un clip video continuo negli asset. I video clip vengono classificati in base alla pertinenza alla query inserita.

  5. Puoi utilizzare la sezione Filters sul lato sinistro della pagina dei risultati di ricerca per perfezionare la ricerca. Ogni criterio di filtro è costituito da una chiave dello schema di dati e dal valore dell'annotazione da cercare. Dopo aver specificato i criteri di filtro, fai clic su Cerca per eseguire la ricerca.

Cercare i dati del data warehouse video batch utilizzando la riga di comando

Per cercare i video (assets) nel tuo corpus (corpus), compila il searchIndexEndpoint corpo della richiesta con i contenuti che vorresti trovare. Questi contenuti sono disponibili in diversi formati:

  1. text_query o image_query: la query da utilizzare per la ricerca.
  2. (Facoltativo) criteria: filtra i criteri in base alle annotazioni fornite dall'utente.

Nell'esempio seguente, considera un corpus contenente video di paesaggi naturali. Per recuperare tutte le risorse pertinenti a "sunset at beach" e contrassegnate con l'annotazione "state": "California", invia la seguente richiesta:

REST e riga di comando

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • REGIONALIZED_ENDPOINT: l'endpoint potrebbe includere un prefisso corrispondente a LOCATION_ID, ad esempio europe-west4-. Scopri di più sugli endpoint regionalizzati.
  • PROJECT_NUMBER: il tuo Google Cloud numero progetto.
  • LOCATION_ID: la regione in cui utilizzi Vertex AI Vision. Ad esempio: us-central1, europe-west4. Consulta le regioni disponibili.
  • INDEX_ENDPOINT_ID: l'ID dell'endpoint dell'indice target.

Metodo HTTP e URL: 

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint

Corpo JSON della richiesta: 

{
  "text_query": "sunset at beach",
  "criteria": [
    {
      "field": "state",
      "text_array": {
          "txt_values": [
            "California"
          ]
      }
    }
  ]
}

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint"

PowerShell

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "searchResultItems": [
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_1"
    },
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_2"
    }
  ]
}

Se hai un'immagine di un tramonto su una spiaggia, puoi utilizzarla anche come query di ricerca inviando la seguente richiesta (l'immagine di input è in formato con codifica base64):

REST e riga di comando

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • REGIONALIZED_ENDPOINT: l'endpoint potrebbe includere un prefisso corrispondente a LOCATION_ID, ad esempio europe-west4-. Scopri di più sugli endpoint regionalizzati.
  • PROJECT_NUMBER: il tuo Google Cloud numero progetto.
  • LOCATION_ID: la regione in cui utilizzi Vertex AI Vision. Ad esempio: us-central1, europe-west4. Consulta le regioni disponibili.
  • INDEX_ENDPOINT_ID: l'ID dell'endpoint dell'indice target.

Metodo HTTP e URL: 

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint

Corpo JSON della richiesta: 

{
  "image_query": {
    "input_image": "IMAGE_BYTES"
  },
  "criteria": [
    {
      "field": "state",
      "text_array": {
          "txt_values": [
            "California"
          ]
      }
    }
  ]
}

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint"

PowerShell

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "searchResultItems": [
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_1"
    },
    {
      "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_2"
    }
  ]
}