ImageContext

Parametri specifici per il contesto dell'immagine e/o della funzionalità.

Rappresentazione JSON
{
  "latLongRect": {
    object(LatLongRect)
  },
  "languageHints": [
    string
  ],
  "cropHintsParams": {
    object(CropHintsParams)
  },
  "productSearchParams": {
    object(ProductSearchParams)
  },
  "webDetectionParams": {
    object(WebDetectionParams)
  },
  "textDetectionParams": {
    object(TextDetectionParams)
  },
  "qualityOptimizationParams": {
    object(QualityOptimizationParams)
  },
  "documentParsingParams": {
    object(DocumentParsingParams)
  }
}
Campi
latLongRect

object(LatLongRect)

Non utilizzato.

languageHints[]

string

Elenco delle lingue da utilizzare per TEXT_DETECTION. Nella maggior parte dei casi, un valore vuoto produce i risultati migliori, in quanto consente il rilevamento automatico della lingua. Per le lingue basate sull'alfabeto latino, l'impostazione languageHints non è necessaria. In rari casi, quando la lingua del testo nell'immagine è nota, l'impostazione di un suggerimento aiuterà a 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.

cropHintsParams

object(CropHintsParams)

Parametri per la richiesta di annotazione dei suggerimenti di ritaglio.

productSearchParams

object(ProductSearchParams)

Parametri per la ricerca di prodotti.

webDetectionParams

object(WebDetectionParams)

Parametri per il rilevamento web.

textDetectionParams

object(TextDetectionParams)

Parametri per il rilevamento del testo in un documento.

qualityOptimizationParams

object(QualityOptimizationParams)

Parametri per le ottimizzazioni della qualità delle immagini.

documentParsingParams

object(DocumentParsingParams)

Parametri per l'analisi dei documenti.

LatLongRect

Rettangolo determinato dalle coppie min e max LatLng.

Rappresentazione JSON
{
  "minLatLng": {
    object(LatLng)
  },
  "maxLatLng": {
    object(LatLng)
  }
}
Campi
minLatLng

object(LatLng)

Coppia lat/long minima.

maxLatLng

object(LatLng)

Coppia latitudine/longitudine massima.

CropHintsParams

Parametri per la richiesta di annotazione dei suggerimenti di ritaglio.

Rappresentazione JSON
{
  "aspectRatios": [
    number
  ]
}
Campi
aspectRatios[]

number

Proporzioni in numeri decimali, che rappresentano il rapporto tra la larghezza e l'altezza dell'immagine. Ad esempio, se le proporzioni desiderate sono 4/3, il valore float corrispondente deve essere 1,33333. Se non specificato, viene restituito il ritaglio migliore possibile. Il numero di formati forniti è limitato a un massimo di 16; i formati forniti dopo il sedicesimo vengono ignorati.

ProductSearchParams

Parametri per una richiesta di ricerca di prodotto.

Rappresentazione JSON
{
  "boundingPoly": {
    object(BoundingPoly)
  },
  "productSet": string,
  "productCategories": [
    string
  ],
  "filter": string
}
Campi
boundingPoly

object(BoundingPoly)

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

productSet

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.

productCategories[]

string

L'elenco delle categorie di prodotti in cui eseguire la ricerca. Al momento prendiamo in considerazione solo la prima categoria e devi specificare "articoli per la casa", "abbigliamento" o "giocattoli".

filter

string

L'espressione di filtro. Può essere utilizzato per limitare i risultati di ricerca in base alle etichette prodotto. 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".

WebDetectionParams

Parametri per la richiesta di rilevamento web.

Rappresentazione JSON
{
  "includeGeoResults": boolean
}
Campi
includeGeoResults

boolean

Se includere i risultati derivati dalle informazioni geografiche nell'immagine.

TextDetectionParams

Parametri per i rilevamenti di testo. Viene utilizzato per controllare le funzionalità TEXT_DETECTION e DOCUMENT_TEXT_DETECTION.

Rappresentazione JSON
{
  "disableOrientationDetection": boolean,
  "disableTextAnnotations": boolean,
  "pageFilter": string,
  "blockFilter": string,
  "paragraphFilter": string,
  "wordFilter": string,
  "symbolFilter": string
}
Campi
disableOrientationDetection

boolean

Disattiva il rilevamento dell'orientamento in modo che il testo ruotato non venga rilevato. Questa funzionalità è supportata solo per DOCUMENT_TEXT_DETECTION.

disableTextAnnotations

boolean

Disattiva il vecchio campo textAnnotations. Verranno restituite solo le annotazioni full_text_annotations.

pageFilter

string (FieldMask format)

Controlla quali dati vengono restituiti a livello di pagina in fullTextAnnotation. Valore predefinito se non impostato: tutti i campi sono inclusi

Un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

blockFilter

string (FieldMask format)

Controlla quali dati vengono restituiti a livello di blocco in fullTextAnnotation. Valore predefinito se non impostato: tutti i campi sono inclusi, tranne mergedText.

Un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

paragraphFilter

string (FieldMask format)

Controlla quali dati vengono restituiti a livello di paragrafo in fullTextAnnotation. Valore predefinito se non impostato: tutti i campi sono inclusi, tranne mergedText

Un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

wordFilter

string (FieldMask format)

Controlla quali dati vengono restituiti a livello di parola in fullTextAnnotation. Valore predefinito se non impostato: tutti i campi sono inclusi, tranne mergedText

Un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

symbolFilter

string (FieldMask format)

Controlla quali dati vengono restituiti a livello di simbolo in fullTextAnnotation. Valore predefinito se non impostato: tutti i campi sono inclusi, tranne boundingBox

Un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

QualityOptimizationParams

Parametri per le ottimizzazioni della qualità delle immagini.

Rappresentazione JSON
{
  "type": enum(Type),
  "compressionConfig": {
    object(CompressionConfig)
  },
  "enhancementConfig": {
    object(EnhancementConfig)
  },
  "qualityScoreConfig": {
    object(QualityScoreConfig)
  }
}
Campi
type

enum(Type)

Scegli un tipo di ottimizzazione.

compressionConfig

object(CompressionConfig)

Specifica la configurazione della compressione.

enhancementConfig

object(EnhancementConfig)

Specifica la configurazione del miglioramento automatico.

qualityScoreConfig

object(QualityScoreConfig)

Specifica la configurazione del punteggio di qualità.

CompressionConfig

Configurazione per COMPRESSION.

Rappresentazione JSON
{
  "targetQuality": number
}
Campi
targetQuality

number

Nell'intervallo [0, 1]. Qualità target dopo la compressione. 1 indica l'assenza di perdita rispetto all'immagine di input, 0 indica l'assenza di requisiti di qualità minimi.

EnhancementConfig

Configurazione per ENHANCEMENT. Se non specifichi enhancementConfig, verranno utilizzati i valori predefiniti sharpeningLevel pari a 0,5, autoHdrLevel pari a 0,5 e upscaleRatio pari a 1. Se vuoi personalizzare uno dei tre parametri, devi specificare l'intera EnhancementConfig. Ad esempio, se vuoi utilizzare un valore autoHdrLevel più alto, che in genere rende l'immagine più luminosa, e mantenere il livello di nitidezza e il rapporto di upscaling uguali a quelli predefiniti, puoi impostare la configurazione come segue: enhancementConfig { sharpeningLevel: 0.5 autoHdrLevel: 1.0 upscaleRatio: 1 }

Rappresentazione JSON
{
  "sharpeningLevel": number,
  "autoHdrLevel": number,
  "upscaleRatio": number
}
Campi
sharpeningLevel

number

Compreso nell'intervallo [0,1]. Livello di nitidezza, 0 significa nessuna nitidezza, 1 significa la nitidezza più elevata. Il valore predefinito è 0,5.

autoHdrLevel

number

Compreso nell'intervallo [0,1]. Livello di HDR automatico, 0 significa nessun HDR automatico, 1 significa HDR automatico più grande. Il valore predefinito è 0,5.

upscaleRatio

number

Nell'intervallo [1, 2]. Se eseguire l'upscaling, il valore predefinito sarà 1, il che significa nessun upscaling. Se specificate, l'altezza e la larghezza dell'output saranno uguali all'altezza e alla larghezza originali moltiplicate per upscaleRatio.

QualityScoreConfig

Configurazione per QUALITY_SCORE.

Rappresentazione JSON
{
  "qualityModel": string
}
Campi
qualityModel

string

Specifica il modello da utilizzare. Il valore predefinito è una stringa vuota e verrà restituito il punteggio estetico. Un altro modello di qualità supportato è "builtin/technical-score", che restituisce la qualità tecnica dell'immagine.

DocumentParsingParams

Parametri per la funzionalità DOCUMENT_PARSING.

Rappresentazione JSON
{
  "disableOrientationDetection": boolean,
  "tableDetectionOptions": {
    object(TableDetectionOptions)
  },
  "documentType": string
}
Campi
disableOrientationDetection

boolean

Disattiva il rilevamento dell'orientamento in modo che il testo ruotato non venga rilevato.

tableDetectionOptions

object(TableDetectionOptions)

Controlla il comportamento di rilevamento delle tabelle. Il rilevamento delle tabelle è disattivato se questo campo non è impostato.

documentType

string

Specifica un tipo di documento noto per un rilevamento più approfondito della struttura. I valori validi sono attualmente "invoice" o "general".

TableDetectionOptions

Opzioni per il rilevamento delle tabelle.

Rappresentazione JSON
{
  "tableBoundHints": [
    {
      object(TableBoundHint)
    }
  ]
}
Campi
tableBoundHints[]

object(TableBoundHint)

Suggerimenti facoltativi per il riquadro di delimitazione della tabella che possono essere forniti per i casi complessi in cui il nostro algoritmo non riesce a individuare le tabelle.

TableBoundHint

Un suggerimento per un riquadro di delimitazione della tabella nella pagina per l'analisi della tabella.

Rappresentazione JSON
{
  "pageNumber": number,
  "boundingBox": {
    object(BoundingPoly)
  }
}
Campi
pageNumber

number

Numero di pagina facoltativo per gli input multipagina a cui si applica questo suggerimento. Se non viene fornito, questo suggerimento verrà applicato a tutte le pagine per impostazione predefinita. Questo valore è indicizzato a 1.

boundingBox

object(BoundingPoly)

Suggerimento sul riquadro di delimitazione per una tabella in questa pagina. Le coordinate devono essere normalizzate a [0,1] e il riquadro di delimitazione deve essere un rettangolo allineato agli assi.