ImageContext

Contexte de l'image et/ou paramètres spécifiques à une fonctionnalité.

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

object(LatLongRect)

Non utilisé.

languageHints[]

string

Liste des langues à utiliser pour TEXT_DETECTION. Cependant, dans la plupart des cas, une valeur vide donne de meilleurs résultats, car elle active la détection automatique de la langue. Pour les langues basées sur l'alphabet latin, le paramètre languageHints n'est pas nécessaire. Dans de rares cas, lorsque la langue du texte de l'image est connue, le réglage de ce paramètre aidera à obtenir de meilleurs résultats (bien que cela nuise fortement au fonctionnement du service si sa valeur est erronée). La détection de texte renvoie une erreur si une ou plusieurs des langues spécifiées ne font pas partie des langues compatibles.

cropHintsParams

object(CropHintsParams)

Paramètres de la requête d'annotation de suggestions de cadrage.

productSearchParams

object(ProductSearchParams)

Paramètres de la recherche de produits.

webDetectionParams

object(WebDetectionParams)

Paramètres de la détection Web.

textDetectionParams

object(TextDetectionParams)

Paramètres de la détection de texte dans des documents.

qualityOptimizationParams

object(QualityOptimizationParams)

Paramètres de l'optimisation de la qualité des images.

documentParsingParams

object(DocumentParsingParams)

Paramètres de l'analyse des documents.

LatLongRect

Rectangle déterminé par des paires LatLng minimales et maximales.

Représentation JSON
{
  "minLatLng": {
    object(LatLng)
  },
  "maxLatLng": {
    object(LatLng)
  }
}
Champs
minLatLng

object(LatLng)

Paire latitude/longitude minimale.

maxLatLng

object(LatLng)

Paire latitude/longitude maximale.

CropHintsParams

Paramètres de la requête d'annotation de suggestions de cadrage.

Représentation JSON
{
  "aspectRatios": [
    number
  ]
}
Champs
aspectRatios[]

number

Format exprimé en floats, correspondant au ratio entre la largeur et la hauteur de l'image. Par exemple, si le format souhaité est 4/3, la valeur flottante correspondante doit être de 1,33333. Si le format n'est pas spécifié, le meilleur cadrage possible est renvoyé. Le nombre de formats fournis est limité à 16. Les formats indiqués au-delà du seizième sont ignorés.

ProductSearchParams

Paramètres pour une requête de recherche de produits.

Représentation JSON
{
  "boundingPoly": {
    object(BoundingPoly)
  },
  "productSet": string,
  "productCategories": [
    string
  ],
  "filter": string
}
Champs
boundingPoly

object(BoundingPoly)

Polygone de délimitation autour de la zone d'intérêt dans l'image. Facultatif. Si ce champ n'est pas spécifié, la décision est prise à la seule discrétion du système.

productSet

string

Nom de ressource d'un ProductSet à rechercher pour des images similaires.

Format : projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID.

productCategories[]

string

Liste des catégories de produits dans lesquelles effectuer la recherche. Actuellement, seule la première catégorie est prise en compte. Vous devez spécifier "homegoods", "apparel" ou "toys".

filter

string

Expression de filtrage permettant de limiter les résultats de recherche en fonction des étiquettes du Product. Nous acceptons actuellement les opérateurs AND et OR dans les expressions clé/valeur, où chaque expression contenue dans une condition OR doit avoir la même clé.

Par exemple, "(color = red OR color = blue) AND brand = Google" est acceptable, mais pas "(color = red OR brand = Google)" ni "color: red".

WebDetectionParams

Paramètres d'une requête de détection Web.

Représentation JSON
{
  "includeGeoResults": boolean
}
Champs
includeGeoResults

boolean

Indique si les résultats provenant des informations géographiques de l'image doivent être inclus.

TextDetectionParams

Paramètres des détections de texte. Permet de contrôler les fonctionnalités TEXT_DETECTION et DOCUMENT_TEXT_DETECTION.

Représentation JSON
{
  "disableOrientationDetection": boolean,
  "disableTextAnnotations": boolean,
  "pageFilter": string,
  "blockFilter": string,
  "paragraphFilter": string,
  "wordFilter": string,
  "symbolFilter": string
}
Champs
disableOrientationDetection

boolean

Désactive la détection de l'orientation de sorte que le texte ayant une orientation différente ne soit pas détecté. Compatible uniquement avec DOCUMENT_TEXT_DETECTION.

disableTextAnnotations

boolean

Désactive l'ancien champ "textAnnotations". Seules les annotations "full_text_annotations" seront renvoyées.

pageFilter

string (FieldMask format)

Contrôle les données renvoyées au niveau de la page dans "fullTextAnnotation". Valeur par défaut en l'absence de réglage spécifique : tous les champs sont inclus.

Liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".

blockFilter

string (FieldMask format)

Contrôle les données renvoyées au niveau du bloc dans "fullTextAnnotation". Valeur par défaut en l'absence de réglage spécifique : tous les champs sont inclus, sauf mergedText.

Liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".

paragraphFilter

string (FieldMask format)

Contrôle les données renvoyées au niveau du paragraphe dans "fullTextAnnotation". Valeur par défaut en l'absence de réglage spécifique : tous les champs sont inclus, sauf mergedText.

Liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".

wordFilter

string (FieldMask format)

Contrôle les données renvoyées au niveau du mot dans "fullTextAnnotation". Valeur par défaut en l'absence de réglage spécifique : tous les champs sont inclus, sauf mergedText.

Liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".

symbolFilter

string (FieldMask format)

Contrôle les données renvoyées au niveau du symbole dans "fullTextAnnotation". Valeur par défaut en l'absence de réglage spécifique : tous les champs sont inclus, sauf boundingBox.

Liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".

QualityOptimizationParams

Paramètres de l'optimisation de la qualité des images.

Représentation JSON
{
  "type": enum(Type),
  "compressionConfig": {
    object(CompressionConfig)
  },
  "enhancementConfig": {
    object(EnhancementConfig)
  },
  "qualityScoreConfig": {
    object(QualityScoreConfig)
  }
}
Champs
type

enum(Type)

Choisissez un type d'optimisation.

compressionConfig

object(CompressionConfig)

Spécifiez la configuration de compression.

enhancementConfig

object(EnhancementConfig)

Spécifiez la configuration d'amélioration automatique.

qualityScoreConfig

object(QualityScoreConfig)

Spécifiez la configuration du niveau de qualité

CompressionConfig

Configuration pour COMPRESSION.

Représentation JSON
{
  "targetQuality": number
}
Champs
targetQuality

number

Dans la plage [0, 1]. Qualité cible après compression. 1 correspond à une absence de perte par rapport à une image d'entrée, 0 correspond à l'absence d'exigence de qualité minimale.

EnhancementConfig

Configuration pour ENHANCMENT. Si vous ne spécifiez pas de "enhancement_config", les valeurs par défaut pour "sharpening_level", "auto_hdr_level" et "upscale_ratio" sont respectivement égales à "0.5", "0.5" et "1". Si vous souhaitez personnaliser l'un des trois paramètres, vous devez spécifier l'intégralité de "EnhancementConfig". Par exemple, si vous souhaitez utiliser une valeur "auto_hdr_level" plus élevée (ce qui améliore généralement la luminosité de l'image) et conserver les valeurs par défaut pour "sharpening_level" et "upscale_ratio", vous pouvez définir la configuration comme suit : enhancementConfig { sharpeningLevel: 0.5 autoHdrLevel: 1.0 upscaleRatio: 1 }

Représentation JSON
{
  "sharpeningLevel": number,
  "autoHdrLevel": number,
  "upscaleRatio": number
}
Champs
sharpeningLevel

number

Dans la plage [0,1]. Niveau de netteté : 0 signifie que la netteté n'a pas été améliorée, 1 signifie que la netteté a été beaucoup améliorée. La valeur par défaut est 0,5.

autoHdrLevel

number

Dans la plage [0,1]. Niveau "Auto HDR" : 0 signifie qu'il n'y a pas d'auto HDR, 1 signifie que l'Auto HDR a été largement utilisé. La valeur par défaut est 0,5.

upscaleRatio

number

Dans la plage [1,2]. Si vous agrandissez l'image, la valeur par défaut est 1, ce qui signifie qu'aucun agrandissement n'a été effectué. Si spécifié,la hauteur et la largeur de la sortie seront égales à la hauteur et à la largeur d'origine, multipliées par la valeur de upscaleRatio

QualityScoreConfig

Configuration de QUALITY_SCORE.

Représentation JSON
{
  "qualityModel": string
}
Champs
qualityModel

string

Spécifiez le modèle à utiliser. La valeur par défaut est une chaîne vide, et le score visuel est renvoyé. Un autre modèle de qualité compatible est "builtin/technical-score", qui renverra la qualité technique de l'image.

DocumentParsingParams

Paramètres de la fonctionnalité DOCUMENT_PARSING.

Représentation JSON
{
  "disableOrientationDetection": boolean,
  "tableDetectionOptions": {
    object(TableDetectionOptions)
  },
  "documentType": string
}
Champs
disableOrientationDetection

boolean

Désactive la détection de l'orientation de sorte que le texte ayant une orientation différente ne soit pas détecté.

tableDetectionOptions

object(TableDetectionOptions)

Contrôle le comportement de la détection de table. La détection de table est désactivée si ce champ n'est pas défini.

documentType

string

Spécifiez un type de document connu pour une détection plus approfondie de la structure. Les valeurs valides sont actuellement "invoice" (facture) ou "general" (général).

TableDetectionOptions

Options de détection de la table.

Représentation JSON
{
  "tableBoundHints": [
    {
      object(TableBoundHint)
    }
  ]
}
Champs
tableBoundHints[]

object(TableBoundHint)

Suggestions facultatives pour le cadre de délimitation d'une table pouvant être fournies pour les cas complexes dans lesquels notre algorithme ne peut pas localiser la ou les tables.

TableBoundHint

Suggestion de cadre de délimitation pour une table sur la page et l'analyse de cette table.

Représentation JSON
{
  "pageNumber": number,
  "boundingBox": {
    object(BoundingPoly)
  }
}
Champs
pageNumber

number

Numéro de page facultatif pour les entrées comportant plusieurs pages auxquelles cette suggestion s'applique. Si aucune valeur n'est fournie, cette suggestion s'applique par défaut à toutes les pages. Cette valeur est indexée 1.

boundingBox

object(BoundingPoly)

Suggestion de cadre de délimitation pour une table sur cette page. Les coordonnées doivent être normalisées dans la plage [0,1] et le cadre de délimitation doit être un rectangle aligné sur l'axe.