AnnotateImageRequest

Richiesta di esecuzione di attività dell'API Google Cloud Vision su un'immagine fornita dall'utente, con le funzionalità richieste dall'utente e con informazioni contestuali.

Rappresentazione JSON
{
  "image": {
    object(Image)
  },
  "features": [
    {
      object(Feature)
    }
  ],
  "imageContext": {
    object(ImageContext)
  },
  "customLabelDetectionModels": [
    string
  ]
}
Campi
image

object(Image)

L'immagine da elaborare.

features[]

object(Feature)

Funzionalità richieste.

imageContext

object(ImageContext)

Contesto aggiuntivo che può accompagnare l'immagine.

customLabelDetectionModels[]

string

Quando effettui una richiesta con un valore CUSTOM_LABEL_DETECTION nel campo features.type, il campo CustomLabelDetectionModels deve specificare i modelli personalizzati da utilizzare. Il formato del nome del modello imita l'URL della risorsa del modello personalizzato: /projects/PROJECT_ID/models/MODEL_ID o /models/MODEL_ID se il modello appartiene al progetto corrente.

Immagine

Immagine del client su cui eseguire le attività dell'API Google Cloud Vision.

Rappresentazione JSON
{
  "content": string,
  "source": {
    object(ImageSource)
  }
}
Campi
content

string (bytes format)

Contenuti dell'immagine, rappresentati come un flusso di byte. Nota: come per tutti i campi bytes, i buffer di protocollo utilizzano una rappresentazione binaria pura, mentre le rappresentazioni JSON utilizzano base64.

Una stringa con codifica in base64.

source

object(ImageSource)

Posizione dell'immagine Google Cloud Storage o URL dell'immagine accessibile pubblicamente. Se per un'immagine vengono forniti sia content che source, content ha la precedenza e viene utilizzato per eseguire la richiesta di annotazione dell'immagine.

ImageSource

Origine immagine esterna (Google Cloud Storage o posizione dell'immagine nell'URL web).

Rappresentazione JSON
{
  "gcsImageUri": string,
  "imageUri": string
}
Campi
gcsImageUri

string

Utilizza invece imageUri.

L'URI Google Cloud Storage nel formato gs://bucket_name/object_name. Il controllo delle versioni degli oggetti non è supportato. Per ulteriori informazioni, consulta URI delle richieste Google Cloud Storage.

imageUri

string

L'URI dell'immagine di origine. Può essere:

  1. Un URI Google Cloud Storage nel formato gs://bucket_name/object_name. Il controllo delle versioni degli oggetti non è supportato. Per ulteriori informazioni, consulta URI delle richieste Google Cloud Storage.

  2. Un URL HTTP/HTTPS di un'immagine accessibile pubblicamente. Quando recupera le immagini dagli URL HTTP/HTTPS, Google non può garantire che la richiesta venga completata. La richiesta potrebbe non andare a buon fine se l'host specificato la rifiuta (ad es. a causa della limitazione delle richieste o della prevenzione di attacchi DoS) o se Google limita le richieste al sito per prevenire abusi. Non devi fare affidamento su immagini ospitate esternamente per le applicazioni di produzione.

Quando vengono specificati sia gcsImageUri che imageUri, imageUri ha la precedenza.