Package google.cloud.vision.v1p3beta1

Indice

ImageAnnotator

Servizio che esegue attività di rilevamento dell'API Google Cloud Vision sulle immagini del cliente, come il rilevamento di volti, punti di riferimento, loghi, etichette e testo. Il servizio ImageAnnotator restituisce le entità rilevate dalle immagini.

AsyncBatchAnnotateFiles

rpc AsyncBatchAnnotateFiles(AsyncBatchAnnotateFilesRequest) returns (Operation)

Esegui il rilevamento e l'annotazione asincroni delle immagini per un elenco di file generici, ad esempio file PDF, che possono contenere più pagine e più immagini per pagina. L'avanzamento e i risultati possono essere recuperati tramite l'interfaccia google.longrunning.Operations. Operation.metadata contiene OperationMetadata (metadati). Operation.response contiene AsyncBatchAnnotateFilesResponse (risultati).

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
BatchAnnotateImages

rpc BatchAnnotateImages(BatchAnnotateImagesRequest) returns (BatchAnnotateImagesResponse)

Esegui il rilevamento e l'annotazione delle immagini per un batch di immagini.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

Google Product Search

Gestisce i prodotti e i set di prodotti di immagini di riferimento da utilizzare nella ricerca dei prodotti. Utilizza il seguente modello di risorse:

  • L'API ha una raccolta di risorse ProductSet, denominate projects/*/locations/*/productSets/*, che consente di raggruppare diversi prodotti per limitare l'identificazione.

In parallelo,

  • L'API ha una raccolta di risorse Product denominata projects/*/locations/*/products/*

  • Ogni Product ha una raccolta di risorse ReferenceImage denominata projects/*/locations/*/products/*/referenceImages/*

AddProductToProductSet

rpc AddProductToProductSet(AddProductToProductSetRequest) returns (Empty)

Aggiunge un prodotto al ProductSet specificato. Se il prodotto è già presente, non viene apportata alcuna modifica.

Un prodotto può essere aggiunto a un massimo di 100 set di prodotti.

Possibili errori:

  • Restituisce NOT_FOUND se il prodotto o il set di prodotti non esiste.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
CreateProduct

rpc CreateProduct(CreateProductRequest) returns (Product)

Crea e restituisce una nuova risorsa prodotto.

Possibili errori:

  • Restituisce INVALID_ARGUMENT se display_name non è presente o è più lungo di 4096 caratteri.
  • Restituisce INVALID_ARGUMENT se la descrizione è più lunga di 4096 caratteri.
  • Restituisce INVALID_ARGUMENT se product_category non è presente o non è valido.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
CreateProductSet

rpc CreateProductSet(CreateProductSetRequest) returns (ProductSet)

Crea e restituisce una nuova risorsa ProductSet.

Possibili errori:

  • Restituisce INVALID_ARGUMENT se display_name non è presente o è più lungo di 4096 caratteri.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
CreateReferenceImage

rpc CreateReferenceImage(CreateReferenceImageRequest) returns (ReferenceImage)

Crea e restituisce una nuova risorsa ReferenceImage.

Il campo bounding_poly è facoltativo. Se bounding_poly non è specificato, il sistema tenterà di rilevare regioni di interesse nell'immagine compatibili con la categoria di prodotto del prodotto principale. Se viene specificato, il rilevamento viene SEMPRE ignorato. Il sistema converte i poligoni in rettangoli non ruotati.

Tieni presente che la pipeline ridimensionerà l'immagine se la risoluzione è troppo elevata per l'elaborazione (oltre 50 MP).

Possibili errori:

  • Restituisce INVALID_ARGUMENT se image_uri non è presente o è più lungo di 4096 caratteri.
  • Restituisce INVALID_ARGUMENT se il prodotto non esiste.
  • Restituisce INVALID_ARGUMENT se bounding_poly non è fornito e non viene rilevato nulla di compatibile con la categoria_prodotto del prodotto principale.
  • Restituisce INVALID_ARGUMENT se bounding_poly contiene più di 10 poligoni.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
DeleteProduct

rpc DeleteProduct(DeleteProductRequest) returns (Empty)

Elimina definitivamente un prodotto e le relative immagini di riferimento.

I metadati del prodotto e tutte le relative immagini verranno eliminati immediatamente, ma le query di ricerca relative ai set di prodotti contenenti il prodotto potrebbero continuare a funzionare finché non vengono aggiornate tutte le cache correlate.

Possibili errori:

  • Restituisce NOT_FOUND se il prodotto non esiste.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
DeleteProductSet

rpc DeleteProductSet(DeleteProductSetRequest) returns (Empty)

Consente di eliminare definitivamente un ProductSet. I prodotti e le immagini di riferimento nel set di prodotti non vengono eliminati.

I file immagine effettivi non vengono eliminati da Google Cloud Storage.

Possibili errori:

  • Restituisce NOT_FOUND se il set di prodotti non esiste.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
DeleteReferenceImage

rpc DeleteReferenceImage(DeleteReferenceImageRequest) returns (Empty)

Consente di eliminare definitivamente un'immagine di riferimento.

I metadati dell'immagine verranno eliminati immediatamente, ma le query di ricerca relative ai set di prodotti contenenti l'immagine potrebbero continuare a funzionare finché non vengono aggiornate tutte le cache correlate.

I file immagine effettivi non vengono eliminati da Google Cloud Storage.

Possibili errori:

  • Restituisce NOT_FOUND se l'immagine di riferimento non esiste.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

Recupera le informazioni associate a un prodotto.

Possibili errori:

  • Restituisce NOT_FOUND se il prodotto non esiste.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
GetProductSet

rpc GetProductSet(GetProductSetRequest) returns (ProductSet)

Recupera le informazioni associate a un ProductSet.

Possibili errori:

  • Restituisce NOT_FOUND se il set di prodotti non esiste.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
GetReferenceImage

rpc GetReferenceImage(GetReferenceImageRequest) returns (ReferenceImage)

Recupera le informazioni associate a un'immagine di riferimento.

Possibili errori:

  • Restituisce NOT_FOUND se l'immagine specificata non esiste.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
ImportProductSets

rpc ImportProductSets(ImportProductSetsRequest) returns (Operation)

API asincrona che importa un elenco di immagini di riferimento in set di prodotti specificati in base a un elenco di informazioni sulle immagini.

L'API google.longrunning.Operation può essere utilizzata per monitorare l'avanzamento e i risultati della richiesta. Operation.metadata contiene BatchOperationMetadata. (progress) Operation.response contiene ImportProductSetsResponse. (risultati)

L'origine di input di questo metodo è un file CSV su Google Cloud Storage. Per il formato del file CSV, consulta ImportProductSetsGcsSource.csv_file_uri.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
ListProductSets

rpc ListProductSets(ListProductSetsRequest) returns (ListProductSetsResponse)

Elenca i set di prodotti in un ordine non specificato.

Possibili errori:

  • Restituisce INVALID_ARGUMENT se page_size è maggiore di 100 o minore di 1.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Elenca i prodotti in un ordine non specificato.

Possibili errori:

  • Restituisce INVALID_ARGUMENT se page_size è maggiore di 100 o minore di 1.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
ListProductsInProductSet

rpc ListProductsInProductSet(ListProductsInProductSetRequest) returns (ListProductsInProductSetResponse)

Elenca i prodotti in un ProductSet, in un ordine non specificato. Se il set di prodotti non esiste, il campo prodotti della risposta sarà vuoto.

Possibili errori:

  • Restituisce INVALID_ARGUMENT se page_size è maggiore di 100 o minore di 1.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
ListReferenceImages

rpc ListReferenceImages(ListReferenceImagesRequest) returns (ListReferenceImagesResponse)

Elenca le immagini di riferimento.

Possibili errori:

  • Restituisce NOT_FOUND se il prodotto principale non esiste.
  • Restituisce INVALID_ARGUMENT se il valore di page_size è maggiore di 100 o minore di 1.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
RemoveProductFromProductSet

rpc RemoveProductFromProductSet(RemoveProductFromProductSetRequest) returns (Empty)

Rimuove un prodotto dal SetProdotti specificato.

Possibili errori:

  • Restituisce NOT_FOUND se il prodotto non viene trovato in ProductSet.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
UpdateProduct

rpc UpdateProduct(UpdateProductRequest) returns (Product)

Apporta modifiche a una risorsa Prodotto. Al momento è possibile aggiornare solo i campi display_name, description e labels.

Se le etichette vengono aggiornate, la modifica non verrà applicata alle query fino al successivo aggiornamento dell'indice.

Possibili errori:

  • Restituisce NOT_FOUND se il prodotto non esiste.
  • Restituisce INVALID_ARGUMENT se display_name è presente in update_mask, ma non è presente nella richiesta o è più lungo di 4096 caratteri.
  • Restituisce INVALID_ARGUMENT se la descrizione è presente in update_mask, ma è più lunga di 4096 caratteri.
  • Restituisce INVALID_ARGUMENT se product_category è presente in update_mask.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
AggiornaProductSet

rpc UpdateProductSet(UpdateProductSetRequest) returns (ProductSet)

Apporta modifiche a una risorsa ProductSet. Al momento, è possibile aggiornare solo display_name.

Possibili errori:

  • Restituisce NOT_FOUND se il set di prodotti non esiste.
  • Restituisce INVALID_ARGUMENT se display_name è presente in update_mask, ma non nella richiesta o se è più lungo di 4096 caratteri.
Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

AddProductToProductSetRequest

Messaggio di richiesta per il metodo AddProductToProductSet.

Campi
name

string

Il nome della risorsa del set di prodotti da modificare.

Il formato è: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID
product

string

Il nome della risorsa del prodotto da aggiungere a questo ProductSet.

Il formato è: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

AnnotateFileResponse

Risposta a una richiesta di annotazione di un singolo file. Un file può contenere una o più immagini, che hanno singolarmente le proprie risposte.

Campi
input_config

InputConfig

Informazioni sul file per il quale viene generata questa risposta.

responses[]

AnnotateImageResponse

Singole risposte alle immagini trovate all'interno del file.

AnnotateImageRequest

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

Campi
image

Image

L'immagine da elaborare.

features[]

Feature

Funzionalità richieste.

image_context

ImageContext

Contesto aggiuntivo che può accompagnare l'immagine.

AnnotateImageResponse

Risposta a una richiesta di annotazione di immagini.

Campi
face_annotations[]

FaceAnnotation

Se presente, il rilevamento del volto è stato completato correttamente.

landmark_annotations[]

EntityAnnotation

Se presente, il rilevamento di punti di riferimento è stato completato correttamente.

logo_annotations[]

EntityAnnotation

Se presente, il rilevamento del logo è stato completato correttamente.

label_annotations[]

EntityAnnotation

Se presente, il rilevamento delle etichette è stato completato correttamente.

localized_object_annotations[]

LocalizedObjectAnnotation

Se presente, il rilevamento di oggetti localizzati è stato completato correttamente. I risultati verranno ordinati in ordine decrescente in base al punteggio di attendibilità.

text_annotations[]

EntityAnnotation

Se presente, il rilevamento del testo (OCR) è stato completato correttamente.

full_text_annotation

TextAnnotation

Se presente, il rilevamento del testo (OCR) o del testo del documento (OCR) è stato completato correttamente. Questa annotazione fornisce la gerarchia strutturale del testo rilevato tramite OCR.

safe_search_annotation

SafeSearchAnnotation

Se presente, l'annotazione SafeSearch è stata completata correttamente.

image_properties_annotation

ImageProperties

Se presenti, le proprietà delle immagini sono state estratte correttamente.

crop_hints_annotation

CropHintsAnnotation

Se presenti, i suggerimenti di ritaglio sono stati completati correttamente.

web_detection

WebDetection

Se presente, il rilevamento web è stato completato correttamente.

product_search_results

ProductSearchResults

Se presente, la ricerca dei prodotti è stata completata correttamente.

error

Status

Se impostato, rappresenta il messaggio di errore per l'operazione. Tieni presente che le annotazioni delle immagini compilate sono garantite come corrette, anche quando è impostato error.

context

ImageAnnotationContext

Se presenti, sono necessarie informazioni contestuali per capire da dove proviene l'immagine.

AsyncAnnotateFileRequest

Una richiesta di annotazione di file offline.

Campi
input_config

InputConfig

Obbligatorio. Informazioni sul file di input.

features[]

Feature

Obbligatorio. Funzionalità richieste.

image_context

ImageContext

Contesto aggiuntivo che può accompagnare le immagini nel file.

output_config

OutputConfig

Obbligatorio. La posizione di output e i metadati desiderati (ad es. il formato).

AsyncAnnotateFileResponse

La risposta per una singola richiesta di annotazione di file offline.

Campi
output_config

OutputConfig

La posizione di output e i metadati di AsyncAnnotateFileRequest.

AsyncBatchAnnotateFilesRequest

Più richieste di annotazione di file asincrone vengono raggruppate in un'unica chiamata di servizio.

Campi
requests[]

AsyncAnnotateFileRequest

Richieste di annotazione file asincrone singole per questo batch.

AsyncBatchAnnotateFilesResponse

Risposta a una richiesta di annotazione di file batch asincrona.

Campi
responses[]

AsyncAnnotateFileResponse

L'elenco delle risposte all'annotazione dei file, una per ogni richiesta in AsyncBatchAnnotateFilesRequest.

BatchAnnotateImagesRequest

Più richieste di annotazione di immagini vengono raggruppate in un'unica chiamata di servizio.

Campi
requests[]

AnnotateImageRequest

Richieste di annotazione di singole immagini per questo lotto.

BatchAnnotateImagesResponse

Risposta a una richiesta di annotazione di immagini collettive.

Campi
responses[]

AnnotateImageResponse

Risposte singole alle richieste di annotazione delle immagini all'interno del batch.

BatchOperationMetadata

Metadati per le operazioni batch, ad esempio lo stato corrente.

Questo valore è incluso nel campo metadata di Operation restituito dalla chiamata GetOperation del servizio google::longrunning::Operations.

Campi
state

State

Lo stato attuale dell'operazione batch.

submit_time

Timestamp

L'ora in cui la richiesta batch è stata inviata al server.

end_time

Timestamp

L'ora in cui la richiesta batch è stata completata e google.longrunning.Operation.done è impostato su true.

Stato

Elenca i possibili stati della richiesta batch.

Enum
STATE_UNSPECIFIED Non valido.
PROCESSING La richiesta è in fase di elaborazione.
SUCCESSFUL La richiesta è stata completata e almeno un elemento è stato elaborato correttamente.
FAILED La richiesta è stata completata e nessun elemento è stato elaborato correttamente.
CANCELLED La richiesta viene eseguita dopo che l'utente ha chiamato longrunning.Operations.CancelOperation. Tutti i record elaborati prima del comando di annullamento vengono visualizzati come specificato nella richiesta.

Blocca

Elemento logico nella pagina.

Campi
property

TextProperty

Sono state rilevate informazioni aggiuntive per il blocco.

bounding_box

BoundingPoly

Il riquadro di delimitazione del blocco. I vertici sono nell'ordine in alto a sinistra, in alto a destra, in basso a destra e in basso a sinistra. Quando viene rilevata una rotazione della casella delimitante, la rotazione viene rappresentata come attorno all'angolo in alto a sinistra, come definito quando il testo viene letto nell'orientamento "naturale". Ad esempio:

  • Quando il testo è orizzontale, potrebbe avere il seguente aspetto:
    0----1
    |    |
    3----2
  • se viene ruotata di 180 gradi attorno all'angolo in alto a sinistra diventa:
    2----3
    |    |
    1----0

e l'ordine dei vertici sarà ancora (0, 1, 2, 3).
paragraphs[]

Paragraph

Elenco di paragrafi in questo blocco (se di tipo di testo).

block_type

BlockType

Tipo di blocco rilevato (testo, immagine e così via) per questo blocco.

confidence

float

Affidabilità dei risultati dell'OCR nel blocco. Intervallo [0, 1].

BlockType

Tipo di blocco (testo, immagine e così via) identificato dall'OCR.

Enum
UNKNOWN Tipo di blocco sconosciuto.
TEXT Blocco di testo normale.
TABLE Blocco di tabelle.
PICTURE Blocco delle immagini.
RULER Casella con linee orizzontali/verticali.
BARCODE Blocco di codici a barre.

BoundingPoly

Un poligono di delimitazione per l'annotazione dell'immagine rilevata.

Campi
vertices[]

Vertex

I vertici del poligono di delimitazione.

normalized_vertices[]

NormalizedVertex

I vertici normalizzati del poligono di delimitazione.

ColorInfo

Le informazioni sul colore sono costituite da canali RGB, punteggio e frazione dell'immagine occupata dal colore.

Campi
color

Color

Componenti RGB del colore.

score

float

Punteggio specifico per l'immagine per questo colore. Valore compreso nell'intervallo [0, 1].

pixel_fraction

float

La frazione di pixel occupata dal colore nell'immagine. Valore compreso nell'intervallo [0, 1].

CreateProductRequest

Messaggio di richiesta per il metodo CreateProduct.

Campi
parent

string

Il progetto in cui deve essere creato il prodotto.

Il formato è projects/PROJECT_ID/locations/LOC_ID.
product

Product

Il prodotto da creare.

product_id

string

Un ID risorsa fornito dall'utente per questo prodotto. Se impostato, il server tenterà di utilizzare questo valore come ID risorsa. Se è già in uso, viene restituito un errore con il codice ALREADY_EXISTS. Deve avere una lunghezza massima di 128 caratteri. Non può contenere il carattere /.

CreateProductSetRequest

Messaggio di richiesta per il metodo CreateProductSet.

Campi
parent

string

Il progetto in cui deve essere creato il set di prodotti.

Il formato è projects/PROJECT_ID/locations/LOC_ID.
product_set

ProductSet

Il ProductSet da creare.

product_set_id

string

Un ID risorsa fornito dall'utente per questo ProductSet. Se impostato, il server tenterà di utilizzare questo valore come ID risorsa. Se è già in uso, viene restituito un errore con il codice ALREADY_EXISTS. Deve avere una lunghezza massima di 128 caratteri. Non può contenere il carattere /.

CreateReferenceImageRequest

Messaggio di richiesta per il metodo CreateReferenceImage.

Campi
parent

string

Nome della risorsa del prodotto in cui creare l'immagine di riferimento.

Il formato è projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.
reference_image

ReferenceImage

L'immagine di riferimento da creare. Se viene specificato un ID immagine, questo viene ignorato.

reference_image_id

string

Un ID risorsa fornito dall'utente per l'immagine di riferimento da aggiungere. Se impostato, il server tenterà di utilizzare questo valore come ID risorsa. Se è già in uso, viene restituito un errore con il codice ALREADY_EXISTS. Deve avere una lunghezza massima di 128 caratteri. Non può contenere il carattere /.

CropHint

Suggerimento di ritaglio singolo utilizzato per generare un nuovo ritaglio durante la pubblicazione di un'immagine.

Campi
bounding_poly

BoundingPoly

Il poligono di delimitazione per l'area di ritaglio. Le coordinate del riquadro di delimitazione sono nella scala dell'immagine originale, come restituito in ImageParams.

confidence

float

Livello di confidenza che si tratti di una regione importante. Intervallo [0, 1].

importance_fraction

float

Frazione di importanza di questa regione saliente rispetto all'immagine originale.

CropHintsAnnotation

Set di suggerimenti di ritaglio utilizzati per generare nuovi ritagli durante la pubblicazione delle immagini.

Campi
crop_hints[]

CropHint

Risultati del suggerimento di ritaglio.

CropHintsParams

Parametri per la richiesta di annotazione degli indicatori di ritaglio.

Campi
aspect_ratios[]

float

Le proporzioni in virgola mobile, che rappresentano il rapporto tra la larghezza e l'altezza dell'immagine. Ad esempio, se il formato desiderato è 4/3, il valore a virgola mobile corrispondente deve essere 1,33333. Se non viene specificato, viene restituito il ritaglio migliore possibile. Il numero di proporzioni fornito è limitato a un massimo di 16. Eventuali proporzioni fornite dopo la sedicesima vengono ignorate.

DeleteProductRequest

Messaggio di richiesta per il metodo DeleteProduct.

Campi
name

string

Nome della risorsa del prodotto da eliminare.

Il formato è: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

DeleteProductSetRequest

Messaggio di richiesta per il metodo DeleteProductSet.

Campi
name

string

Nome della risorsa del set di prodotti da eliminare.

Il formato è: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID

DeleteReferenceImageRequest

Messaggio di richiesta per il metodo DeleteReferenceImage.

Campi
name

string

Il nome della risorsa dell'immagine di riferimento da eliminare.

Il formato è:

projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID

DominantColorsAnnotation

Set di colori dominanti e relativi punteggi.

Campi
colors[]

ColorInfo

Valori di colore RGB con il relativo punteggio e la frazione di pixel.

EntityAnnotation

Insieme di funzionalità delle entità rilevate.

Campi
mid

string

ID entità opaco. Alcuni ID potrebbero essere disponibili nell'API Search di Knowledge Graph di Google.

locale

string

Il codice lingua per le impostazioni internazionali in cui è espresso il testo dell'entità description.

description

string

Descrizione testuale dell'entità, espressa nella lingua locale.

score

float

Punteggio complessivo del risultato. Intervallo [0, 1].

confidence
(deprecated)

float

Ritirato. Utilizza invece score. La precisione del rilevamento delle entità in un'immagine. Ad esempio, per un'immagine in cui viene rilevata l'entità "Torre Eiffel", questo campo rappresenta la certezza che nell'immagine della query sia presente una torre. Intervallo [0, 1].
topicality

float

La pertinenza dell'etichetta ICA (annotazione dei contenuti delle immagini) all'immagine. Ad esempio, la pertinenza di "torre" è probabilmente più alta per un'immagine contenente la "Torre Eiffel" rilevata rispetto a un'immagine contenente un edificio alto rilevato in lontananza, anche se la certezza che in ogni immagine sia presente una torre potrebbe essere la stessa. Intervallo [0, 1].

bounding_poly

BoundingPoly

Regione dell'immagine a cui appartiene questa entità. Non prodotto per le funzionalità di LABEL_DETECTION.

locations[]

LocationInfo

Le informazioni sulla posizione dell'entità rilevata. Possono essere presenti più elementi LocationInfo perché una posizione può indicare la posizione della scena nell'immagine e un'altra la posizione del luogo in cui è stata scattata l'immagine. Le informazioni sulla posizione sono generalmente presenti per i punti di riferimento.

properties[]

Property

Alcune entità possono avere campi Property (nome/valore) facoltativi forniti dall'utente, ad esempio un punteggio o una stringa che ne qualificano l'entità.

FaceAnnotation

Un oggetto di annotazione del volto contiene i risultati del rilevamento dei volti.

Campi
bounding_poly

BoundingPoly

Il poligono di delimitazione intorno al viso. Le coordinate del riquadro di delimitazione sono nella scala dell'immagine originale, come restituito in ImageParams. Il riquadro di delimitazione viene calcolato per "inquadrare" il volto in base alle aspettative umane. Si basa sui risultati dei landmark. Tieni presente che una o più coordinate x e/o y potrebbero non essere generate in BoundingPoly (il poligono non avrà limiti) se nell'immagine da annotare è visibile solo una parte del volto.

fd_bounding_poly

BoundingPoly

Il poligono di contenimento fd_bounding_poly è più stretto di boundingPoly e racchiude solo la parte della pelle del viso. In genere, viene utilizzato per eliminare il volto da qualsiasi analisi di immagini che rileva la "quantità di pelle" visibile in un'immagine. Non si basa sui risultati dei landmark, ma solo sul rilevamento iniziale dei volti, da qui

fd

(Rilevamento facciale) prefisso.
landmarks[]

Landmark

Sono stati rilevati i punti di riferimento del viso.

roll_angle

float

Angolo di inclinazione, che indica l'entità della rotazione in senso orario/antiorario del volto rispetto al verticale dell'immagine sull'asse perpendicolare al volto. Intervallo [-180,180].

pan_angle

float

Angolo di imbardata, che indica l'angolo verso sinistra/destra verso cui è rivolto il volto rispetto al piano verticale perpendicolare all'immagine. Intervallo [-180,180].

tilt_angle

float

Angolo di inclinazione, che indica l'angolo verso l'alto/verso il basso in cui è rivolto il volto rispetto al piano orizzontale dell'immagine. Intervallo [-180,180].

detection_confidence

float

Affidabilità del rilevamento. Intervallo [0, 1].

landmarking_confidence

float

Affidabilità dell'identificazione dei punti di riferimento del volto. Intervallo [0, 1].

joy_likelihood

Likelihood

Probabilità di gioia.

sorrow_likelihood

Likelihood

Probabilità di delusione.

anger_likelihood

Likelihood

Probabilità di rabbia.

surprise_likelihood

Likelihood

Probabilità di sorpresa.

under_exposed_likelihood

Likelihood

Probabilità di sottoesposizione.

blurred_likelihood

Likelihood

Probabilità sfocata.

headwear_likelihood

Likelihood

Probabilità di indossare un copricapo.

Punto di riferimento

Un punto di riferimento specifico per il volto (ad esempio, un tratto del viso).

Campi
type

Type

Tipo di punto di riferimento del viso.

position

Position

Posizione del punto di riferimento del volto.

Tipo

Tipo di punto di riferimento (elemento) del viso. Sinistra e destra sono definiti dal punto di vista dell'osservatore dell'immagine senza considerare le proiezioni speculari tipiche delle foto. Quindi, in genere, LEFT_EYE è l'occhio destro della persona.

Enum
UNKNOWN_LANDMARK È stato rilevato un punto di riferimento del volto sconosciuto. Non deve essere compilato.
LEFT_EYE Occhio sinistro.
RIGHT_EYE Occhio destro.
LEFT_OF_LEFT_EYEBROW A sinistra dell'arcata sopracciliare sinistra.
RIGHT_OF_LEFT_EYEBROW A destra dell'arcata sopracciliare sinistra.
LEFT_OF_RIGHT_EYEBROW A sinistra dell'arcata sopracciliare destra.
RIGHT_OF_RIGHT_EYEBROW A destra dell'arcata sopracciliare destra.
MIDPOINT_BETWEEN_EYES Punto intermedio tra gli occhi.
NOSE_TIP La punta del naso.
UPPER_LIP Labbro superiore.
LOWER_LIP Labbro inferiore.
MOUTH_LEFT Bocca a sinistra.
MOUTH_RIGHT Bocca a destra.
MOUTH_CENTER Al centro della bocca.
NOSE_BOTTOM_RIGHT Naso, in basso a destra.
NOSE_BOTTOM_LEFT Naso, in basso a sinistra.
NOSE_BOTTOM_CENTER Naso, in basso al centro.
LEFT_EYE_TOP_BOUNDARY Occhio sinistro, confine superiore.
LEFT_EYE_RIGHT_CORNER Occhio sinistro, angolo a destra.
LEFT_EYE_BOTTOM_BOUNDARY Occhio sinistro, bordo inferiore.
LEFT_EYE_LEFT_CORNER Occhio sinistro, angolo sinistro.
RIGHT_EYE_TOP_BOUNDARY Occhio destro, bordo superiore.
RIGHT_EYE_RIGHT_CORNER Occhio destro, angolo destro.
RIGHT_EYE_BOTTOM_BOUNDARY Occhio destro, confine inferiore.
RIGHT_EYE_LEFT_CORNER Occhio destro, angolo a sinistra.
LEFT_EYEBROW_UPPER_MIDPOINT Sopracciglio sinistro, punto intermedio superiore.
RIGHT_EYEBROW_UPPER_MIDPOINT Sopracciglio destro, punto intermedio superiore.
LEFT_EAR_TRAGION Trago dell'orecchio sinistro.
RIGHT_EAR_TRAGION Trago dell'orecchio destro.
LEFT_EYE_PUPIL Pupilla dell'occhio sinistro.
RIGHT_EYE_PUPIL Pupilla dell'occhio destro.
FOREHEAD_GLABELLA Fronte, glabella.
CHIN_GNATHION Mento gnatione.
CHIN_LEFT_GONION Goniomansio sinistro del mento.
CHIN_RIGHT_GONION Goniomansio destro del mento.

Funzionalità

Il tipo di rilevamento dell'API Google Cloud Vision da eseguire e il numero massimo di risultati da restituire per quel tipo. Nell'elenco features è possibile specificare più oggetti Feature.

Campi
type

Type

Il tipo di elemento.

max_results

int32

Numero massimo di risultati di questo tipo. Non applicabile a TEXT_DETECTION, DOCUMENT_TEXT_DETECTION o CROP_HINTS.

model

string

Modello da utilizzare per la funzionalità. Valori supportati: "builtin/stable" (il valore predefinito se non impostato) e "builtin/latest".

Tipo

Tipo di funzionalità dell'API Google Cloud Vision da estrarre.

Enum
TYPE_UNSPECIFIED Tipo di elemento non specificato.
FACE_DETECTION Esegui il rilevamento dei volti.
LANDMARK_DETECTION Esegui il rilevamento dei punti di riferimento.
LOGO_DETECTION Esegui il rilevamento dei loghi.
LABEL_DETECTION Esegui il rilevamento delle etichette.
TEXT_DETECTION Esegui il rilevamento del testo / il riconoscimento ottico dei caratteri (OCR). Il rilevamento del testo è ottimizzato per le aree di testo all'interno di un'immagine più grande. Se l'immagine è un documento, utilizza invece DOCUMENT_TEXT_DETECTION.
DOCUMENT_TEXT_DETECTION Esegui l'OCR di documenti con testo denso. Ha la precedenza quando sono presenti sia DOCUMENT_TEXT_DETECTION che TEXT_DETECTION.
SAFE_SEARCH_DETECTION Esegui la ricerca sicura per rilevare contenuti potenzialmente non sicuri o indesiderati.
IMAGE_PROPERTIES Calcola un insieme di proprietà relative all'immagine, come i colori predominanti dell'immagine.
CROP_HINTS Esegui i suggerimenti di ritaglio.
WEB_DETECTION Esegui il rilevamento web.
OBJECT_LOCALIZATION Esegui il localizzatore per il rilevamento di oggetti.

GcsDestination

La posizione di Google Cloud Storage in cui verrà scritto l'output.

Campi
uri

string

URI Google Cloud Storage in cui verranno archiviati i risultati. I risultati saranno in formato JSON e preceduti dall'URI di input corrispondente. Questo campo può rappresentare un singolo file o un prefisso per più output. I prefissi devono terminare con /.

Esempi:

Se sono presenti più output, ogni risposta è ancora AnnotateFileResponse, ciascuna delle quali contiene un sottoinsieme dell'elenco completo di AnnotateImageResponse. Possono verificarsi più output se, ad esempio, l'output JSON è troppo grande e si verifica un overflow in più file suddivisi in parti.

GcsSource

La posizione di Google Cloud Storage da cui verrà letto l'input.

Campi
uri

string

URI Google Cloud Storage per il file di input. Deve essere solo un oggetto Google Cloud Storage. I caratteri jolly non sono attualmente supportati.

GetProductRequest

Messaggio di richiesta per il metodo GetProduct.

Campi
name

string

Nome della risorsa del prodotto da ottenere.

Il formato è: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

GetProductSetRequest

Messaggio di richiesta per il metodo GetProductSet.

Campi
name

string

Nome della risorsa del set di prodotti da ottenere.

Il formato è: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID

GetReferenceImageRequest

Messaggio di richiesta per il metodo GetReferenceImage.

Campi
name

string

Il nome della risorsa dell'immagine di riferimento da ottenere.

Il formato è:

projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID.

Immagine

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

Campi
content

bytes

Contenuti delle immagini, rappresentati come uno stream di byte. Nota: come per tutti i campi bytes, i protobuffer utilizzano una rappresentazione puramente binaria, mentre le rappresentazioni JSON utilizzano base64.

source

ImageSource

Posizione dell'immagine di Google Cloud Storage o URL 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.

ImageAnnotationContext

Se un'immagine è stata prodotta da un file (ad es. un PDF), questo messaggio fornisce informazioni sulla relativa origine.

Campi
uri

string

L'URI del file utilizzato per produrre l'immagine.

page_number

int32

Se il file era un PDF o un TIFF, questo campo indica il numero di pagina all'interno del file utilizzato per produrre l'immagine.

ImageContext

Contesto dell'immagine e/o parametri specifici della funzionalità.

Campi
lat_long_rect

LatLongRect

Non utilizzato.

language_hints[]

string

Elenco delle lingue da utilizzare per TEXT_DETECTION. Nella maggior parte dei casi, un valore vuoto genera i risultati migliori perché attiva il rilevamento automatico della lingua. Per le lingue basate sull'alfabeto latino, l'impostazione language_hints non è necessaria. In rari casi, quando la lingua del testo nell'immagine è nota, l'impostazione di un suggerimento consente di ottenere risultati migliori (anche se sarà un ostacolo significativo se il suggerimento è errato). Il rilevamento del testo restituisce un errore se una o più delle lingue specificate non sono tra le lingue supportate.

crop_hints_params

CropHintsParams

Parametri per la richiesta di annotazione degli indicatori di ritaglio.

product_search_params

ProductSearchParams

Parametri per la ricerca di prodotti.

web_detection_params

WebDetectionParams

Parametri per il rilevamento web.

ImageProperties

Memorizza le proprietà dell'immagine, ad esempio i colori dominanti.

Campi
dominant_colors

DominantColorsAnnotation

Se presenti, i colori dominanti sono stati completati correttamente.

ImageSource

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

Campi
gcs_image_uri

string

Utilizza image_uri.

L'URI Google Cloud Storage del tipo gs://bucket_name/object_name. Il controllo delle versioni degli oggetti non è supportato. Per ulteriori informazioni, consulta URI di richiesta di Google Cloud Storage.
image_uri

string

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

  1. Un URI Google Cloud Storage del tipo gs://bucket_name/object_name. Il controllo delle versioni degli oggetti non è supportato. Per ulteriori informazioni, consulta URI di richiesta di Google Cloud Storage.

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

Quando vengono specificati sia gcs_image_uri che image_uri, image_uri ha la precedenza.

ImportProductSetsGcsSource

La posizione di Google Cloud Storage per un file CSV che conserva un elenco di ImportProductSetRequests in ogni riga.

Campi
csv_file_uri

string

L'URI Google Cloud Storage del file CSV di input.

L'URI deve iniziare con gs://.

Il formato del file CSV di input deve essere di un'immagine per riga. In ogni riga sono presenti 8 colonne.

  1. image-uri
  2. image-id
  3. product-set-id
  4. product-id
  5. product-category
  6. product-display-name
  7. etichette
  8. bounding-poly

Le colonne image-uri, product-set-id, product-id e product-category sono obbligatorie. Tutte le altre colonne sono facoltative.

Se il ProductSet o il Product specificato dai valori product-set-id e product-id non esiste, il sistema creerà un nuovo ProductSet o Product per l'immagine. In questo caso, la colonna product-display-name fa riferimento a display_name, la colonna product-category fa riferimento a product_category e la colonna labels fa riferimento a product_labels.

La colonna image-id è facoltativa, ma deve essere univoca se specificata. Se è vuoto, il sistema assegnerà automaticamente un ID univoco all'immagine.

La colonna product-display-name è facoltativa. Se è vuoto, il sistema imposta il campo display_name per il prodotto su uno spazio (" "). Puoi aggiornare display_name in un secondo momento utilizzando l'API.display_name

Se esiste già un Product con il product-id specificato, il sistema ignora le colonne product-display-name, product-category e labels.

La colonna labels (facoltativa) è una riga contenente un elenco di coppie chiave-valore separate da virgola nel seguente formato:

"key_1=value_1,key_2=value_2,...,key_n=value_n"

La colonna bounding-poly (facoltativa) identifica una regione di interesse dell'immagine nello stesso modo di CreateReferenceImage. Se non specifichi la colonna bounding-poly, il sistema tenterà di rilevare automaticamente le regioni di interesse.

È consentita al massimo una colonna bounding-poly per riga. Se l'immagine contiene più regioni di interesse, aggiungi una riga al file CSV che includa le stesse informazioni sul prodotto e i valori bounding-poly per ogni regione di interesse.

La colonna bounding-poly deve contenere un numero pari di numeri separati da virgola, nel formato "p1_x,p1_y,p2_x,p2_y,…,pn_x,pn_y". Utilizza numeri interi non negativi per i poligoni delimitanti assoluti e valori in virgola mobile nell'intervallo [0, 1] per i poligoni delimitanti normalizzati.

Il sistema ridimensionerà l'immagine se la risoluzione è troppo elevata per essere elaborata (superiore a 20 MP).

ImportProductSetsInputConfig

I contenuti di input per il metodo ImportProductSets.

Campi
gcs_source

ImportProductSetsGcsSource

La posizione di Google Cloud Storage per un file CSV che conserva un elenco di ImportProductSetRequests in ogni riga.

ImportProductSetsRequest

Messaggio di richiesta per il metodo ImportProductSets.

Campi
parent

string

Il progetto in cui devono essere importati i set di prodotti.

Il formato è projects/PROJECT_ID/locations/LOC_ID.
input_config

ImportProductSetsInputConfig

I contenuti inseriti per l'elenco delle richieste.

ImportProductSetsResponse

Messaggio di risposta per il metodo ImportProductSets.

Questo messaggio viene restituito dal metodo google.longrunning.Operations.GetOperation nel campo google.longrunning.Operation.response restituito.

Campi
reference_images[]

ReferenceImage

L'elenco delle reference_images importate correttamente.

statuses[]

Status

Lo stato rpc per ogni richiesta ImportProductSet, inclusi i risultati positivi e gli errori.

Il numero di stati corrisponde al numero di righe del file CSV e statuses[i] memorizza lo stato di esito positivo o negativo dell'elaborazione della riga i-esima del file CSV, a partire dalla riga 0.

InputConfig

La posizione di input e i metadati desiderati.

Campi
gcs_source

GcsSource

La posizione di Google Cloud Storage da cui leggere l'input.

mime_type

string

Il tipo di file. Al momento sono supportati solo "application/pdf" e "image/tiff". I caratteri jolly non sono supportati.

LatLongRect

Rettangolo determinato da coppie di valori LatLng minimi e massimi.

Campi
min_lat_lng

LatLng

Coppia lat/long minima.

max_lat_lng

LatLng

Coppia lat/long massima.

Probabilità

Una rappresentazione bucketizzata della probabilità, che ha lo scopo di fornire ai clienti risultati altamente stabili durante gli upgrade dei modelli.

Enum
UNKNOWN Probabilità sconosciuta.
VERY_UNLIKELY È molto improbabile che l'immagine appartenga al verticale specificato.
UNLIKELY È improbabile che l'immagine appartenga al verticale specificato.
POSSIBLE È possibile che l'immagine appartenga al verticale specificato.
LIKELY È probabile che l'immagine appartenga al verticale specificato.
VERY_LIKELY È molto probabile che l'immagine appartenga al verticale specificato.

ListProductSetsRequest

Messaggio di richiesta per il metodo ListProductSets.

Campi
parent

string

Il progetto da cui devono essere elencati i set di prodotti.

Il formato è projects/PROJECT_ID/locations/LOC_ID.
page_size

int32

Il numero massimo di elementi da restituire. Valore predefinito 10, massimo 100.

page_token

string

Il token next_page_token restituito da una precedente richiesta di elenco, se presente.

ListProductSetsResponse

Messaggio di risposta per il metodo ListProductSets.

Campi
product_sets[]

ProductSet

Elenco di set di prodotti.

next_page_token

string

Token per recuperare la pagina di risultati successiva o vuoto se non ci sono altri risultati nell'elenco.

ListProductsInProductSetRequest

Messaggio di richiesta per il metodo ListProductsInProductSet.

Campi
name

string

La risorsa ProductSet per cui recuperare i prodotti.

Il formato è: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID
page_size

int32

Il numero massimo di elementi da restituire. Valore predefinito 10, massimo 100.

page_token

string

Il token next_page_token restituito da una precedente richiesta di elenco, se presente.

ListProductsInProductSetResponse

Messaggio di risposta per il metodo ListProductsInProductSet.

Campi
products[]

Product

L'elenco dei prodotti.

next_page_token

string

Token per recuperare la pagina di risultati successiva o vuoto se non ci sono altri risultati nell'elenco.

ListProductsRequest

Messaggio di richiesta per il metodo ListProducts.

Campi
parent

string

Il progetto OPPURE il set di prodotti da cui devono essere elencati i prodotti.

Formato: projects/PROJECT_ID/locations/LOC_ID
page_size

int32

Il numero massimo di elementi da restituire. Valore predefinito 10, massimo 100.

page_token

string

Il token next_page_token restituito da una precedente richiesta di elenco, se presente.

ListProductsResponse

Messaggio di risposta per il metodo ListProducts.

Campi
products[]

Product

Elenco di prodotti.

next_page_token

string

Token per recuperare la pagina di risultati successiva o vuoto se non ci sono altri risultati nell'elenco.

ListReferenceImagesRequest

Messaggio di richiesta per il metodo ListReferenceImages.

Campi
parent

string

Nome della risorsa del prodotto contenente le immagini di riferimento.

Il formato è projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.
page_size

int32

Il numero massimo di elementi da restituire. Valore predefinito 10, massimo 100.

page_token

string

Un token che identifica una pagina di risultati da restituire. Si tratta del valore di nextPageToken restituito in una richiesta di elenco di immagini di riferimento precedente.

Se non specificato, il valore predefinito è la prima pagina.

ListReferenceImagesResponse

Messaggio di risposta per il metodo ListReferenceImages.

Campi
reference_images[]

ReferenceImage

L'elenco delle immagini di riferimento.

page_size

int32

Il numero massimo di elementi da restituire. Valore predefinito 10, massimo 100.

next_page_token

string

Il token next_page_token restituito da una precedente richiesta di elenco, se presente.

LocalizedObjectAnnotation

Set di oggetti rilevati con riquadri di delimitazione.

Campi
mid

string

L'ID oggetto deve essere in linea con EntityAnnotation mid.

language_code

string

Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, visita la pagina http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

name

string

Nome dell'oggetto, espresso nella lingua language_code.

score

float

Punteggio del risultato. Intervallo [0, 1].

bounding_poly

BoundingPoly

Regione dell'immagine a cui appartiene questo oggetto. Questo campo deve essere compilato.

LocationInfo

Informazioni sulla posizione dell'entità rilevata.

Campi
lat_lng

LatLng

Coordinate della posizione lat/long.

NormalizedVertex

Un vertice rappresenta un punto 2D nell'immagine. NOTA: le coordinate dei vertici normalizzate sono relative all'immagine originale e vanno da 0 a 1.

Campi
x

float

Coordinata X.

y

float

Coordinata Y.

Zero coordinate values


The general format for bounding polys in the JSON response when detected is an array of 4 vertex objects:
  • [{"x": 0.063,"y": 0.018},{"x": 0.123,"y": 0.018},{"x": 0.123,"y": 0.038},{"x": 0.063,"y": 0.038}]
When the API detects a coordinate ("x" or "y") value of 0.0, that coordinate is omitted in the JSON response. For example, a response could take the following form: [{},{"x": 0.028}, {"x": 0.028,"y": 0.043},{"y": 0.043}]. This response shows all three representation possibilities:
  • {} - an empty object when both "x":0.0 and "y":0.0.
  • {"x": 0.028} and {"y": 0.043} - an object with a single key-value pair when one coordinate is 0.0 but the other is a non-zero value.
  • {"x": 0.028,"y": 0.043} - an object with both key-value pairs when both coordinates have a non-zero value.

OperationMetadata

Contiene i metadati per l'operazione BatchAnnotateImages.

Campi
state

State

Stato attuale dell'operazione batch.

create_time

Timestamp

L'ora in cui è stata ricevuta la richiesta batch.

update_time

Timestamp

L'ora dell'ultimo aggiornamento del risultato dell'operazione.

Stato

Stati delle operazioni batch.

Enum
STATE_UNSPECIFIED Non valido.
CREATED Richiesta ricevuta.
RUNNING La richiesta è in fase di elaborazione.
DONE L'elaborazione batch è stata completata.
CANCELLED L'elaborazione collettiva è stata annullata.

OutputConfig

La posizione di output e i metadati desiderati.

Campi
gcs_destination

GcsDestination

La posizione di Google Cloud Storage in cui scrivere gli output.

batch_size

int32

Il numero massimo di proto di risposta da inserire in ogni file JSON di output su Google Cloud Storage. L'intervallo valido è [1, 100]. Se non specificato, il valore predefinito è 20.

Ad esempio, per un file PDF con 100 pagine verranno generati 100 proto di risposta. Se batch_size = 20, verranno scritti 5 file JSON contenenti ciascuno 20 proto di risposta con il prefisso gcs_destination.uri.

Al momento, batch_size si applica solo a GcsDestination, con un potenziale supporto futuro per altre configurazioni di output.

Pagina

Pagina rilevata dall'OCR.

Campi
property

TextProperty

Sono state rilevate informazioni aggiuntive nella pagina.

width

int32

Larghezza della pagina. Per i PDF l'unità di misura è punti. Per le immagini (inclusi i file TIFF), l'unità di misura è il pixel.

height

int32

Altezza pagina. Per i PDF l'unità di misura è punti. Per le immagini (inclusi i file TIFF), l'unità di misura è il pixel.

blocks[]

Block

Elenco di blocchi di testo, immagini e così via in questa pagina.

confidence

float

Affidabilità dei risultati dell'OCR nella pagina. Intervallo [0, 1].

Paragrafo

Unità strutturale di testo che rappresenta un numero di parole in un determinato ordine.

Campi
property

TextProperty

Sono state rilevate informazioni aggiuntive per il paragrafo.

bounding_box

BoundingPoly

Il riquadro di delimitazione del paragrafo. I vertici sono nell'ordine in alto a sinistra, in alto a destra, in basso a destra e in basso a sinistra. Quando viene rilevata una rotazione della casella delimitante, la rotazione viene rappresentata come attorno all'angolo in alto a sinistra, come definito quando il testo viene letto nell'orientamento "naturale". Ad esempio: * quando il testo è orizzontale, potrebbe avere il seguente aspetto: 0----1 | | 3----2 * quando viene ruotato di 180 gradi attorno all'angolo in alto a sinistra, diventa: 2----3 | | 1----0 e l'ordine dei vertici sarà sempre (0, 1, 2, 3).

words[]

Word

Elenco di parole in questo paragrafo.

confidence

float

Affidabilità dei risultati dell'OCR per il paragrafo. Intervallo [0, 1].

Posizione

Una posizione 3D nell'immagine, utilizzata principalmente per i punti di riferimento del rilevamento dei volti. Una posizione valida deve avere sia le coordinate x che quelle y. Le coordinate di posizione sono nella stessa scala dell'immagine originale.

Campi
x

float

Coordinata X.

y

float

Coordinata Y.

z

float

Coordinata Z (o profondità).

Prodotto

Un prodotto contiene ReferenceImages.

Campi
name

string

Il nome della risorsa del prodotto.

Il formato è: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID.

Questo campo viene ignorato durante la creazione di un prodotto.
display_name

string

Il nome fornito dall'utente per questo prodotto. Non deve essere vuoto. Deve avere una lunghezza massima di 4096 caratteri.

description

string

Metadati forniti dall'utente da archiviare con questo prodotto. Deve avere una lunghezza massima di 4096 caratteri.

product_category

string

La categoria del prodotto identificata dall'immagine di riferimento. Deve essere "homegoods", "apparel" o "toys".

Questo campo è immutabile.
product_labels[]

KeyValue

Coppie chiave-valore che possono essere associate a un prodotto. Al momento della query, è possibile specificare vincoli in base a product_labels.

Tieni presente che i valori interi possono essere forniti come stringhe, ad esempio "1199". Solo le stringhe con valori interi possono corrispondere a una limitazione basata su intervallo che sarà supportata a breve.

È possibile assegnare più valori alla stessa chiave. Un prodotto può avere fino a 100 etichette prodotto.

KeyValue

Un'etichetta del prodotto rappresentata come coppia chiave-valore.

Campi
key

string

La chiave dell'etichetta attaccata al prodotto. Non può essere vuoto e non può superare i 128 byte.

value

string

Il valore dell'etichetta applicata al prodotto. Non può essere vuoto e non può superare i 128 byte.

ProductSearchParams

Parametri per una richiesta di ricerca di prodotti.

Campi
bounding_poly

BoundingPoly

Il poligono di delimitazione intorno all'area di interesse nell'immagine. Facoltativo. Se non è specificato, verrà applicata la discrezione del sistema.

product_set

string

Il nome della risorsa di un ProductSet in cui cercare immagini simili.

Il formato è: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID.
product_categories[]

string

L'elenco delle categorie di prodotti in cui effettuare la ricerca. Al momento, viene presa in considerazione solo la prima categoria e devono essere specificati "homegoods", "apparel" o "toys".

filter

string

L'espressione di filtro. Questo può essere utilizzato per limitare i risultati di ricerca in base alle etichette dei prodotti. Al momento supportiamo un AND di OR di espressioni chiave-valore, in cui ogni espressione all'interno di un OR deve avere la stessa chiave.

Ad esempio, "(color = red OR color = blue) AND brand = Google" è accettabile, ma non "(color = red OR brand = Google)" o "color: red".

ProductSearchResults

Risultati per una richiesta di ricerca di prodotti.

Campi
index_time

Timestamp

Timestamp dell'indice che ha fornito questi risultati. Le modifiche apportate dopo questo orario non si riflettono nei risultati attuali.

results[]

Result

Elenco di risultati, uno per ogni corrispondenza del prodotto.

product_grouped_results[]

GroupedResult

Elenco di risultati raggruppati per prodotti rilevati nell'immagine della query. Ogni voce corrisponde a un poligono delimitante nell'immagine di query e contiene i prodotti corrispondenti specifici per quella regione. Potrebbero essere presenti corrispondenze di prodotti duplicate nell'unione di tutti i risultati per prodotto.

GroupedResult

Informazioni sui prodotti simili a un singolo prodotto in un'immagine di query.

Campi
bounding_poly

BoundingPoly

Il poligono di delimitazione attorno al prodotto rilevato nell'immagine della query.

results[]

Result

Elenco di risultati, uno per ogni corrispondenza del prodotto.

Risultato

Informazioni su un prodotto.

Campi
product

Product

Il prodotto.

score

float

Un livello di confidenza sulla corrispondenza, compreso tra 0 (nessuna confidenza) e 1 (fiducia totale).

image

string

Il nome della risorsa dell'immagine del prodotto più simile alla query.

ProductSet

Un ProductSet contiene prodotti. Un ProductSet può contenere al massimo un milione di immagini di riferimento. Se il limite viene superato, l'indicizzazione periodica non andrà a buon fine.

Campi
name

string

Il nome della risorsa del set di prodotti.

Il formato è: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID.

Questo campo viene ignorato durante la creazione di un ProductSet.
display_name

string

Il nome fornito dall'utente per questo ProductSet. Non deve essere vuoto. Deve avere una lunghezza massima di 4096 caratteri.

index_time

Timestamp

Solo output. L'ora dell'ultimo indicizzazione di questo ProductSet. I risultati della query rifletteranno tutti gli aggiornamenti precedenti a questa data. Se questo ProductSet non è mai stato indicizzato, il timestamp è il valore predefinito "1970-01-01T00:00:00Z".

Questo campo viene ignorato durante la creazione di un ProductSet.
index_error

Status

Solo output. Se si è verificato un errore durante l'indicizzazione dell'insieme di prodotti, il campo viene compilato.

Questo campo viene ignorato durante la creazione di un ProductSet.

Proprietà

Un Property è costituito da una coppia nome/valore fornita dall'utente.

Campi
name

string

Nome della proprietà.

value

string

Valore della proprietà.

uint64_value

uint64

Valore delle proprietà numeriche.

ReferenceImage

Un ReferenceImage rappresenta un'immagine del prodotto e i relativi metadati associati, come i riquadri di delimitazione.

Campi
name

string

Il nome della risorsa dell'immagine di riferimento.

Il formato è:

projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID.

Questo campo viene ignorato quando viene creata un'immagine di riferimento.
uri

string

L'URI Google Cloud Storage dell'immagine di riferimento.

L'URI deve iniziare con gs://.

Obbligatorio.
bounding_polys[]

BoundingPoly

Poligoni di confine intorno alle aree di interesse nell'immagine di riferimento. Facoltativo. Se questo campo è vuoto, il sistema tenterà di rilevare le regioni di interesse. Verranno utilizzati al massimo 10 poligoni delimitanti.

La forma fornita viene convertita in un rettangolo non ruotato. Una volta convertito, il lato piccolo del rettangolo deve essere maggiore o uguale a 300 pixel. Le proporzioni devono essere pari o inferiori a 1:4 (ad es. 1:3 è accettabile, 1:5 non lo è).

RemoveProductFromProductSetRequest

Messaggio di richiesta per il metodo RemoveProductFromProductSet.

Campi
name

string

Il nome della risorsa del set di prodotti da modificare.

Il formato è: projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID
product

string

Il nome della risorsa del prodotto da rimuovere da questo ProductSet.

Il formato è: projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID

SafeSearchAnnotation

Set di funzionalità relative all'immagine, calcolate con metodi di visione artificiale nei verticali SafeSearch (ad es. contenuti per adulti, spoofing, contenuti medici, violenza).

Campi
adult

Likelihood

Rappresenta la probabilità che l'immagine includa contenuti per adulti. I contenuti per adulti possono includere elementi quali nudità, immagini o cartoni animati pornografici o attività sessuali.

spoof

Likelihood

Probabilità di spoofing. La probabilità che sia stata apportata una modifica alla versione canonica dell'immagine per renderla divertente o offensiva.

medical

Likelihood

Probabilità che si tratti di un'immagine medica.

violence

Likelihood

Probabilità che questa immagine includa contenuti violenti.

racy

Likelihood

Probabilità che l'immagine richiesta contenga contenuti di natura sessuale. I contenuti di natura sessuale possono includere, a titolo esemplificativo, abbigliamento succinto o trasparente, nudità coperte strategicamente, pose osceni o provocanti o primi piani di aree sensibili del corpo.

Simbolo

Una singola rappresentazione simbolica.

Campi
property

TextProperty

Sono state rilevate informazioni aggiuntive per il simbolo.

bounding_box

BoundingPoly

Il riquadro di delimitazione del simbolo. I vertici sono nell'ordine in alto a sinistra, in alto a destra, in basso a destra e in basso a sinistra. Quando viene rilevata una rotazione della casella delimitante, la rotazione viene rappresentata come attorno all'angolo in alto a sinistra, come definito quando il testo viene letto nell'orientamento "naturale". Ad esempio: * quando il testo è orizzontale, potrebbe avere il seguente aspetto: 0----1 | | 3----2 * quando viene ruotato di 180 gradi attorno all'angolo in alto a sinistra, diventa: 2----3 | | 1----0 e l'ordine dei vertici sarà sempre (0, 1, 2, 3).

text

string

La rappresentazione UTF-8 effettiva del simbolo.

confidence

float

La confidenza dei risultati dell'OCR per il simbolo. Intervallo [0, 1].

TextAnnotation

TextAnnotation contiene una rappresentazione strutturata del testo estratto tramite OCR. La gerarchia di una struttura di testo estratta tramite OCR è la seguente: TextAnnotation -> Pagina -> Blocco -> Paragrafo -> Parola -> Simbolo Ogni componente strutturale, a partire da Pagina, può avere ulteriori proprietà. Le proprietà descrivono le lingue rilevate, le interruzioni e così via. Per ulteriori dettagli, consulta la definizione del messaggio TextAnnotation.TextProperty riportata di seguito.

Campi
pages[]

Page

Elenco di pagine rilevate dall'OCR.

text

string

Testo UTF-8 rilevato nelle pagine.

DetectedBreak

È stata rilevata l'inizio o la fine di un componente strutturale.

Campi
type

BreakType

Tipo di interruzione rilevato.

is_prefix

bool

True se l'elemento viene anteposto da un a capo.

BreakType

Enum per indicare il tipo di interruzione trovata. A capo, spazio e così via.

Enum
UNKNOWN Tipo di etichetta di interruzione sconosciuto.
SPACE Spazio normale.
SURE_SPACE Spazio sicuro (molto ampio).
EOL_SURE_SPACE Interruzione di riga.
HYPHEN Apostrofo finale non presente nel testo; non si verifica con SPACE, LEADER_SPACE o LINE_BREAK.
LINE_BREAK Interruzione di riga che termina un paragrafo.

DetectedLanguage

Lingua rilevata per un componente strutturale.

Campi
language_code

string

Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, visita la pagina http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

confidence

float

Affidabilità della lingua rilevata. Intervallo [0, 1].

TextProperty

Sono state rilevate informazioni aggiuntive sul componente strutturale.

Campi
detected_languages[]

DetectedLanguage

Un elenco delle lingue rilevate con il relativo livello di confidenza.

detected_break

DetectedBreak

È stato rilevato l'inizio o la fine di un segmento di testo.

UpdateProductRequest

Messaggio di richiesta per il metodo UpdateProduct.

Campi
product

Product

La risorsa Product che sostituisce quella sul server. product.name è immutabile.

update_mask

FieldMask

FieldMask che specifica i campi da aggiornare. Se update_mask non è specificato, tutti i campi modificabili devono essere aggiornati. I percorsi delle maschere validi includono product_labels, display_name e description.

UpdateProductSetRequest

Messaggio di richiesta per il metodo UpdateProductSet.

Campi
product_set

ProductSet

La risorsa ProductSet che sostituisce quella sul server.

update_mask

FieldMask

FieldMask che specifica i campi da aggiornare. Se update_mask non è specificato, tutti i campi modificabili devono essere aggiornati. Il percorso della maschera valido è display_name.

Vertex

Un vertice rappresenta un punto 2D nell'immagine. NOTA: le coordinate dei vertici sono nella stessa scala dell'immagine originale.

Campi
x

int32

Coordinata X.

y

int32

Coordinata Y.

Zero coordinate values


The general format for bounding polys in the JSON response when detected is an array of 4 vertex objects:
  • [{"x": 63,"y": 18},{"x": 123,"y": 18},{"x": 123,"y": 38},{"x": 63,"y": 38}]
When the API detects a coordinate ("x" or "y") value of 0, that coordinate is omitted in the JSON response. For example, a response could take the following form: [{},{"x": 28}, {"x": 28,"y": 43},{"y": 43}]. This response shows all three representation possibilities:
  • {} - an empty object when both "x":0 and "y":0.
  • {"x": 28} and {"y": 43} - an object with a single key-value pair when one coordinate is 0 but the other is a non-zero value.
  • {"x": 28,"y": 43} - an object with both key-value pairs when both coordinates have a non-zero value.

WebDetection

Informazioni pertinenti per l'immagine da internet.

Campi
web_entities[]

WebEntity

Entità dedotte da immagini simili su internet.

full_matching_images[]

WebImage

Immagini completamente corrispondenti da internet. Può includere copie ridimensionate dell'immagine di query.

partial_matching_images[]

WebImage

Immagini con corrispondenza parziale da internet. Queste immagini sono abbastanza simili da condividere alcune caratteristiche chiave. Ad esempio, un'immagine originale avrà probabilmente una corrispondenza parziale per i suoi ritagli.

pages_with_matching_images[]

WebPage

Pagine web contenenti le immagini corrispondenti di internet.

visually_similar_images[]

WebImage

I risultati di immagini visivamente simili.

best_guess_labels[]

WebLabel

La migliore supposizione del servizio sull'argomento dell'immagine richiesta. Dedotto da immagini simili sul web aperto.

WebEntity

Entità dedotta da immagini simili su internet.

Campi
entity_id

string

ID entità opaco.

score

float

Punteggio di pertinenza complessivo dell'entità. Non sono normalizzate e non sono paragonabili tra query di immagini diverse.

description

string

Descrizione canonica dell'entità, in inglese.

WebImage

Metadati per le immagini online.

Campi
url

string

L'URL dell'immagine del risultato.

score

float

(Ritiro previsto) Punteggio di pertinenza complessivo dell'immagine.

WebLabel

Etichetta per fornire metadati aggiuntivi per il rilevamento web.

Campi
label

string

Etichetta per i metadati aggiuntivi.

language_code

string

Il codice lingua BCP-47 per label, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, visita la pagina http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

Pagina web

Metadati per le pagine web.

Campi
url

string

L'URL della pagina web del risultato.

score

float

(Ritiro previsto) Punteggio di pertinenza complessivo della pagina web.

page_title

string

Titolo della pagina web, può contenere markup HTML.

full_matching_images[]

WebImage

Immagini completamente corrispondenti nella pagina. Può includere copie ridimensionate dell'immagine di query.

partial_matching_images[]

WebImage

Immagini con corrispondenza parziale nella pagina. Queste immagini sono abbastanza simili da condividere alcune caratteristiche chiave. Ad esempio, un'immagine originale avrà probabilmente una corrispondenza parziale per i suoi ritagli.

WebDetectionParams

Parametri per la richiesta di rilevamento web.

Campi
include_geo_results

bool

Indica se includere i risultati derivati dalle informazioni geografiche nell'immagine.

Word

Una rappresentazione di una parola.

Campi
property

TextProperty

Sono state rilevate informazioni aggiuntive per la parola.

bounding_box

BoundingPoly

Il riquadro di delimitazione della parola. I vertici sono nell'ordine in alto a sinistra, in alto a destra, in basso a destra e in basso a sinistra. Quando viene rilevata una rotazione della casella delimitante, la rotazione viene rappresentata come attorno all'angolo in alto a sinistra, come definito quando il testo viene letto nell'orientamento "naturale". Ad esempio: * quando il testo è orizzontale, potrebbe avere il seguente aspetto: 0----1 | | 3----2 * quando viene ruotato di 180 gradi attorno all'angolo in alto a sinistra, diventa: 2----3 | | 1----0 e l'ordine dei vertici sarà sempre (0, 1, 2, 3).

symbols[]

Symbol

Elenco dei simboli nella parola. L'ordine dei simboli segue l'ordine di lettura naturale.

confidence

float

Affidabilità dei risultati dell'OCR per la parola. Intervallo [0, 1].