AnnotateImageResponse

Réponse à une requête d'annotation d'images.

Représentation JSON 
{
  "faceAnnotations": [
    {
      object (FaceAnnotation)
    }
  ],
  "landmarkAnnotations": [
    {
      object (EntityAnnotation)
    }
  ],
  "logoAnnotations": [
    {
      object (EntityAnnotation)
    }
  ],
  "labelAnnotations": [
    {
      object (EntityAnnotation)
    }
  ],
  "localizedObjectAnnotations": [
    {
      object (LocalizedObjectAnnotation)
    }
  ],
  "textAnnotations": [
    {
      object (EntityAnnotation)
    }
  ],
  "fullTextAnnotation": {
    object (TextAnnotation)
  },
  "safeSearchAnnotation": {
    object (SafeSearchAnnotation)
  },
  "imagePropertiesAnnotation": {
    object (ImageProperties)
  },
  "cropHintsAnnotation": {
    object (CropHintsAnnotation)
  },
  "webDetection": {
    object (WebDetection)
  },
  "productSearchResults": {
    object (ProductSearchResults)
  },
  "error": {
    object (Status)
  },
  "context": {
    object (ImageAnnotationContext)
  }
}
Champs
faceAnnotations[]

object (FaceAnnotation)

Si ce champ est présent, la détection de visages a bien été effectuée.

landmarkAnnotations[]

object (EntityAnnotation)

Si ce champ est présent, la détection de points de repère a bien été effectuée.

logoAnnotations[]

object (EntityAnnotation)

Si ce champ est présent, la détection de logos a bien été effectuée.

labelAnnotations[]

object (EntityAnnotation)

Si ce champ est présent, la détection de thèmes a bien été effectuée.

localizedObjectAnnotations[]

object (LocalizedObjectAnnotation)

Si ce champ est présent, la détection d'objets localisés a bien été effectuée. Les données sont triées par ordre de score de confiance décroissant.

textAnnotations[]

object (EntityAnnotation)

Si ce champ est présent, la détection de texte (OCR) a bien été effectuée.

fullTextAnnotation

object (TextAnnotation)

Si ce champ est présent, la détection de texte (OCR) ou de document (OCR) a bien été effectuée. Cette annotation fournit la hiérarchie structurelle du texte détecté par l'OCR.

safeSearchAnnotation

object (SafeSearchAnnotation)

Si ce champ est présent, l'annotation de recherche sécurisée a bien été effectuée.

imagePropertiesAnnotation

object (ImageProperties)

Si ce champ est présent, les propriétés de l'image ont bien été extraites.

cropHintsAnnotation

object (CropHintsAnnotation)

Si ce champ est présent, les suggestions de cadrage ont bien été effectuées.

webDetection

object (WebDetection)

Si ce champ est présent, la détection Web a bien été effectuée.

productSearchResults

object (ProductSearchResults)

Si ce champ est présent, la recherche de produits a bien été effectuée.

error

object (Status)

Si ce champ est défini, il présente le message d'erreur de l'opération. Notez que les annotations d'images préremplies sont assurément correctes, même lorsque error est défini.

context

object (ImageAnnotationContext)

Si ce champ est présent, des informations contextuelles sont nécessaires pour comprendre d'où provient cette image.

FaceAnnotation

Objet d'annotation de visage contenant les résultats de la détection de visages.

Représentation JSON 
{
  "boundingPoly": {
    object (BoundingPoly)
  },
  "fdBoundingPoly": {
    object (BoundingPoly)
  },
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "rollAngle": number,
  "panAngle": number,
  "tiltAngle": number,
  "detectionConfidence": number,
  "landmarkingConfidence": number,
  "joyLikelihood": enum (Likelihood),
  "sorrowLikelihood": enum (Likelihood),
  "angerLikelihood": enum (Likelihood),
  "surpriseLikelihood": enum (Likelihood),
  "underExposedLikelihood": enum (Likelihood),
  "blurredLikelihood": enum (Likelihood),
  "headwearLikelihood": enum (Likelihood)
}
Champs
boundingPoly

object (BoundingPoly)

Polygone de délimitation autour du visage. Les coordonnées du cadre de délimitation sont à l'échelle de l'image d'origine. Le cadre de délimitation est agencé de manière à encadrer le visage conformément aux attentes humaines. Il s'appuie sur les résultats des points de repère. Il est possible qu'une ou plusieurs coordonnées x et/ou y ne soient pas générées dans le champ BoundingPoly (le polygone n'a alors pas de limites) si l'image ne comporte qu'un visage partiel à annoter.

fdBoundingPoly

object (BoundingPoly)

Le polygone de délimitation fdBoundingPoly est plus précis que le boundingPoly et ne contient que la partie du visage couverte de peau. Il sert généralement à supprimer le visage d'une analyse d'image qui détecte la "quantité de peau" visible sur une image. Il n'est pas basé sur les résultats des points de repère, mais uniquement sur la détection initiale du visage, d'où le préfixe

fd

(détection de visages).
landmarks[]

object (Landmark)

Points de repère détectés sur le visage.

rollAngle

number

Angle de rotation, indiquant la rotation du visage (sens des aiguilles d'une montre ou sens inverse) par rapport à l'alignement vertical de l'image sur l'axe perpendiculaire du visage. Plage [-180,180].

panAngle

number

Angle de lacet, indiquant l'angle vers la gauche/droite vers lequel pointe le visage par rapport à l'axe vertical perpendiculaire de l'image. Plage [-180,180].

tiltAngle

number

Angle d'inclinaison, indiquant l'angle vers le haut/bas vers lequel pointe le visage par rapport à l'axe horizontal de l'image. Plage [-180,180].

detectionConfidence

number

Niveau de confiance de la détection. Plage [0, 1].

landmarkingConfidence

number

Niveau de confiance des points de repère du visage. Plage [0, 1].

joyLikelihood

enum (Likelihood)

Probabilité de joie.

sorrowLikelihood

enum (Likelihood)

Probabilité de tristesse.

angerLikelihood

enum (Likelihood)

Probabilité de colère.

surpriseLikelihood

enum (Likelihood)

Probabilité de surprise.

underExposedLikelihood

enum (Likelihood)

Probabilité de sous-exposition.

blurredLikelihood

enum (Likelihood)

Probabilité de flou.

headwearLikelihood

enum (Likelihood)

Probabilité de port d'accessoires.

Landmark

Point de repère spécifique au visage (par exemple, une caractéristique du visage).

Représentation JSON 
{
  "type": enum (Type),
  "position": {
    object (Position)
  }
}
Champs
type

enum (Type)

Type de point de repère du visage.

position

object (Position)

Position du point de repère du visage.

Type

Type de point de repère (caractéristique). La gauche et la droite sont définies du point de vue de l'observateur de l'image, sans tenir compte des projections miroir classiques des photos. Ainsi, LEFT_EYE correspond généralement à l'œil droit de la personne.

Énumérations
UNKNOWN_LANDMARK Point de repère de visage inconnu détecté. Ne doit pas être rempli.
LEFT_EYE Œil gauche.
RIGHT_EYE Œil droit.
LEFT_OF_LEFT_EYEBROW Côté gauche du sourcil gauche.
RIGHT_OF_LEFT_EYEBROW Côté droit du sourcil gauche.
LEFT_OF_RIGHT_EYEBROW Côté gauche du sourcil droit.
RIGHT_OF_RIGHT_EYEBROW Côté droit du sourcil droit.
MIDPOINT_BETWEEN_EYES Point médian entre les yeux.
NOSE_TIP Bout du nez.
UPPER_LIP Lèvre supérieure.
LOWER_LIP Lèvre inférieure.
MOUTH_LEFT Côté gauche de la bouche.
MOUTH_RIGHT Côté droit de la bouche.
MOUTH_CENTER Centre de la bouche.
NOSE_BOTTOM_RIGHT Nez, en bas à droite.
NOSE_BOTTOM_LEFT Nez, en bas à gauche.
NOSE_BOTTOM_CENTER Nez, en bas au centre.
LEFT_EYE_TOP_BOUNDARY Œil gauche, limite supérieure.
LEFT_EYE_RIGHT_CORNER Œil gauche, coin droit.
LEFT_EYE_BOTTOM_BOUNDARY Œil gauche, limite inférieure.
LEFT_EYE_LEFT_CORNER Œil gauche, coin gauche.
RIGHT_EYE_TOP_BOUNDARY Œil droit, limite supérieure.
RIGHT_EYE_RIGHT_CORNER Œil droit, coin droit.
RIGHT_EYE_BOTTOM_BOUNDARY Œil droit, limite inférieure.
RIGHT_EYE_LEFT_CORNER Œil droit, coin gauche.
LEFT_EYEBROW_UPPER_MIDPOINT Sourcil gauche, point médian supérieur.
RIGHT_EYEBROW_UPPER_MIDPOINT Sourcil droit, point médian supérieur.
LEFT_EAR_TRAGION Tragus de l'oreille gauche.
RIGHT_EAR_TRAGION Tragus de l'oreille droite.
LEFT_EYE_PUPIL Pupille de l'œil gauche.
RIGHT_EYE_PUPIL Pupille de l'œil droit.
FOREHEAD_GLABELLA Glabelle.
CHIN_GNATHION Gnathion du menton.
CHIN_LEFT_GONION Gonion à gauche du menton.
CHIN_RIGHT_GONION Gonion à droite du menton.

Position

Position en 3D dans l'image, servant principalement pour les points de repère de la détection de visages. Une position valide doit contenir des coordonnées x et y. Les coordonnées de position sont à la même échelle que l'image d'origine.

Représentation JSON 
{
  "x": number,
  "y": number,
  "z": number
}
Champs
x

number

Coordonnées X.
y

number

Coordonnées Y.
z

number

Coordonnées Z (ou profondeur).

Likelihood

Représentation divisée en buckets selon le degré de probabilité, ce qui permet d'offrir aux clients des résultats très stables entre les mises à niveau de modèles.

Énumérations
UNKNOWN Probabilité inconnue.
VERY_UNLIKELY Très peu probable.
UNLIKELY Peu probable.
POSSIBLE Possible.
LIKELY Probable.
VERY_LIKELY Très probable.

EntityAnnotation

Ensemble des caractéristiques d'entités détectées.

Représentation JSON 
{
  "mid": string,
  "locale": string,
  "description": string,
  "score": number,
  "confidence": number,
  "topicality": number,
  "boundingPoly": {
    object (BoundingPoly)
  },
  "locations": [
    {
      object (LocationInfo)
    }
  ],
  "properties": [
    {
      object (Property)
    }
  ]
}
Champs
mid

string

ID d'entité opaque. Certains identifiants sont disponibles dans l'API Google Knowledge Graph Search.

locale

string

Code de langue des paramètres régionaux dans lequel la description textuelle de l'entité est exprimée.

description

string

Description textuelle de l'entité, exprimée dans sa langue locale.

score

number

Score global du résultat. Plage [0, 1].

confidence
(deprecated)

number

Obsolète. Utilisez plutôt score. Justesse de la détection d'entités dans une image. Prenons l'exemple d'une image dans laquelle l'entité "Tour Eiffel" est détectée. Ce champ représente le niveau de confiance pour qu'une tour figure dans l'image de la requête. Plage [0, 1].
topicality

number

Pertinence de l'étiquette ICA (Image Content Annotation) par rapport à l'image. Par exemple, la pertinence de l'entité "tour" est probablement plus élevée pour une image sur laquelle la "Tour Eiffel" a été détectée que pour une image contenant un imposant bâtiment à distance, même si la probabilité pour qu'une tour soit présente sur chaque image peut être identique. Plage [0, 1].

boundingPoly

object (BoundingPoly)

Zone de l'image à laquelle appartient cette entité. Champ non généré pour les fonctionnalités LABEL_DETECTION.

locations[]

object (LocationInfo)

Informations sur l'emplacement de l'entité détectée. Plusieurs éléments LocationInfo peuvent être présents, car un emplacement peut faire référence à un lieu représenté sur l'image et un autre à l'endroit où l'image a été prise. Des informations sur l'emplacement sont généralement disponibles pour les points de repère.

properties[]

object (Property)

Certaines entités peuvent inclure des champs Property (nom/valeur) facultatifs fournis par l'utilisateur, tels qu'un score ou une chaîne qualifiant l'entité.

LocationInfo

Informations sur l'emplacement de l'entité détectée.

Représentation JSON 
{
  "latLng": {
    object (LatLng)
  }
}
Champs
latLng

object (LatLng)

Coordonnées de latitude et de longitude de l'emplacement.

Property

Une Property est constituée d'une paire nom/valeur fournie par l'utilisateur.

Représentation JSON 
{
  "name": string,
  "value": string,
  "uint64Value": string
}
Champs
name

string

Nom de la propriété.

value

string

Valeur de la propriété.

uint64Value

string

Valeur des propriétés numériques.

LocalizedObjectAnnotation

Ensemble d'objets détectés avec des cadres de délimitation.

Représentation JSON 
{
  "mid": string,
  "languageCode": string,
  "name": string,
  "score": number,
  "boundingPoly": {
    object (BoundingPoly)
  }
}
Champs
mid

string

ID d'objet conforme au champ "mid" d'EntityAnnotation.

languageCode

string

Le code de langue BCP-47 ("en-US" ou "sr-Latn", par exemple). Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

name

string

Nom d'objet, exprimé dans la langue correspondant au languageCode.

score

number

Score du résultat. Plage [0, 1].

boundingPoly

object (BoundingPoly)

Zone de l'image à laquelle appartient cet objet. Ces informations doivent être renseignées.

TextAnnotation

TextAnnotation contient une représentation structurée du texte extrait par l'OCR. La hiérarchie d'une structure de texte extraite par l'OCR se présente comme suit : TextAnnotation -> Page -> Block -> Paragraph -> Word -> Symbol (Page -> Bloc -> Paragraphe -> Mot -> Symbole). Chaque composant structurel, à partir de la page, peut également posséder ses propres propriétés. Les propriétés décrivent les langues détectées, les sauts, etc. Pour en savoir plus, consultez la définition du message TextAnnotation.TextProperty ci-dessous.

Représentation JSON 
{
  "pages": [
    {
      object (Page)
    }
  ],
  "text": string
}
Champs
pages[]

object (Page)

Liste des pages détectées par l'OCR.

text

string

Texte UTF-8 détecté sur les pages.

Page

Page détectée par l'OCR.

Représentation JSON 
{
  "property": {
    object (TextProperty)
  },
  "width": number,
  "height": number,
  "blocks": [
    {
      object (Block)
    }
  ],
  "confidence": number
}
Champs
property

object (TextProperty)

Informations supplémentaires détectées sur la page.

width

number

Largeur de la page. Pour les PDF, l'unité est exprimée en points. Pour les images (y compris au format TIFF), l'unité est exprimée en pixels.

height

number

Hauteur de la page. Pour les PDF, l'unité est exprimée en points. Pour les images (y compris au format TIFF), l'unité est exprimée en pixels.

blocks[]

object (Block)

Liste de blocs de texte, d'images, etc., sur la page.

confidence

number

Niveau de confiance des résultats de l'OCR sur la page. Plage [0, 1].

TextProperty

Informations supplémentaires détectées dans le composant structurel.

Représentation JSON 
{
  "detectedLanguages": [
    {
      object (DetectedLanguage)
    }
  ],
  "detectedBreak": {
    object (DetectedBreak)
  }
}
Champs
detectedLanguages[]

object (DetectedLanguage)

Liste des langues détectées avec indice de confiance.

detectedBreak

object (DetectedBreak)

Début ou fin d'un segment de texte détecté.

DetectedLanguage

Langue détectée d'un composant structurel.

Représentation JSON 
{
  "languageCode": string,
  "confidence": number
}
Champs
languageCode

string

Le code de langue BCP-47 ("en-US" ou "sr-Latn", par exemple). Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

confidence

number

Niveau de confiance de la langue détectée. Plage [0, 1].

DetectedBreak

Début ou fin détectés d'un composant structurel.

Représentation JSON 
{
  "type": enum (BreakType),
  "isPrefix": boolean
}
Champs
type

enum (BreakType)

Type de saut détecté.

isPrefix

boolean

La valeur est "true" si le saut est ajouté au début de l'élément.

BreakType

Énumération indiquant le type de saut détecté. Nouvelle ligne, espace, etc.

Énumérations
UNKNOWN Type d'étiquette de saut inconnu.
SPACE Espace standard.
SURE_SPACE Espace sûr (très large).
EOL_SURE_SPACE Saut de ligne.
HYPHEN Césure qui n'est pas présente dans le texte. Ce champ ne peut pas être utilisé avec SPACE, LEADER_SPACE ni LINE_BREAK.
LINE_BREAK Saut de ligne qui termine un paragraphe.

Block

Élément logique sur la page.

Représentation JSON 
{
  "property": {
    object (TextProperty)
  },
  "boundingBox": {
    object (BoundingPoly)
  },
  "paragraphs": [
    {
      object (Paragraph)
    }
  ],
  "blockType": enum (BlockType),
  "confidence": number
}
Champs
property

object (TextProperty)

Informations supplémentaires détectées pour le bloc.

boundingBox

object (BoundingPoly)

Cadre de délimitation du bloc. Les sommets sont présentés dans l'ordre suivant : en haut à gauche, en haut à droite, en bas à droite et en bas à gauche. Lorsqu'une rotation du cadre de délimitation est détectée, elle est représentée autour de l'angle supérieur gauche en suivant l'ordre naturel de lecture du texte. Exemple :

  • Lorsque le texte est horizontal, il peut se présenter sous la forme suivante :
    0----1
    |    |
    3----2
  • Lors d'une rotation à 180 degrés autour de l'angle supérieur gauche, il se présente sous la forme suivante :
    2----3
    |    |
    1----0

L'ordre des sommets est toujours (0, 1, 2, 3).
paragraphs[]

object (Paragraph)

Liste des paragraphes du bloc (s'il est de type texte).

blockType

enum (BlockType)

Type de bloc détecté (texte, image, etc.) pour le bloc.

confidence

number

Niveau de confiance des résultats de l'OCR dans le bloc. Plage [0, 1].

Paragraph

Unité structurelle de texte représentant un certain nombre de mots dans un ordre particulier.

Représentation JSON 
{
  "property": {
    object (TextProperty)
  },
  "boundingBox": {
    object (BoundingPoly)
  },
  "words": [
    {
      object (Word)
    }
  ],
  "confidence": number
}
Champs
property

object (TextProperty)

Informations supplémentaires détectées pour le paragraphe.

boundingBox

object (BoundingPoly)

Cadre de délimitation du paragraphe. Les sommets sont présentés dans l'ordre suivant : en haut à gauche, en haut à droite, en bas à droite et en bas à gauche. Lorsqu'une rotation du cadre de délimitation est détectée, elle est représentée autour de l'angle supérieur gauche en suivant l'ordre naturel de lecture du texte. Par exemple : * lorsque le texte est horizontal, il peut se présenter sous la forme suivante : 0----1 | | 3----2 * lorsqu'il a été pivoté de 180 degrés autour de l'angle supérieur gauche, il se présente sous la forme suivante : 2----3 | | 1----0 et l'ordre des sommets est toujours (0, 1, 2, 3).

words[]

object (Word)

Liste de tous les mots du paragraphe.

confidence

number

Niveau de confiance des résultats de l'OCR pour le paragraphe. Plage [0, 1].

Word

Représentation d'un mot.

Représentation JSON 
{
  "property": {
    object (TextProperty)
  },
  "boundingBox": {
    object (BoundingPoly)
  },
  "symbols": [
    {
      object (Symbol)
    }
  ],
  "confidence": number
}
Champs
property

object (TextProperty)

Informations supplémentaires détectées pour le mot.

boundingBox

object (BoundingPoly)

Cadre de délimitation du mot. Les sommets sont présentés dans l'ordre suivant : en haut à gauche, en haut à droite, en bas à droite et en bas à gauche. Lorsqu'une rotation du cadre de délimitation est détectée, elle est représentée autour de l'angle supérieur gauche en suivant l'ordre naturel de lecture du texte. Par exemple : * lorsque le texte est horizontal, il peut se présenter sous la forme suivante : 0----1 | | 3----2 * lorsqu'il a été pivoté de 180 degrés autour de l'angle supérieur gauche, il se présente sous la forme suivante : 2----3 | | 1----0 et l'ordre des sommets est toujours (0, 1, 2, 3).

symbols[]

object (Symbol)

Liste de symboles dans le mot. L'ordre des symboles suit l'ordre naturel de lecture.

confidence

number

Niveau de confiance des résultats de l'OCR pour le mot. Plage [0, 1].

Symbol

Représentation d'un seul symbole.

Représentation JSON 
{
  "property": {
    object (TextProperty)
  },
  "boundingBox": {
    object (BoundingPoly)
  },
  "text": string,
  "confidence": number
}
Champs
property

object (TextProperty)

Informations supplémentaires détectées pour le symbole.

boundingBox

object (BoundingPoly)

Cadre de délimitation du symbole. Les sommets sont présentés dans l'ordre suivant : en haut à gauche, en haut à droite, en bas à droite et en bas à gauche. Lorsqu'une rotation du cadre de délimitation est détectée, elle est représentée autour de l'angle supérieur gauche en suivant l'ordre naturel de lecture du texte. Par exemple : * lorsque le texte est horizontal, il peut se présenter sous la forme suivante : 0----1 | | 3----2 * lorsqu'il a été pivoté de 180 degrés autour de l'angle supérieur gauche, il se présente sous la forme suivante : 2----3 | | 1----0 et l'ordre des sommets est toujours (0, 1, 2, 3).

text

string

Représentation actuelle du symbole en UTF-8.

confidence

number

Niveau de confiance des résultats de l'OCR pour le symbole. Plage [0, 1].

BlockType

Type de bloc (texte, image, etc.) tel qu'identifié par l'OCR.

Énumérations
UNKNOWN Type de bloc inconnu.
TEXT Bloc de texte standard.
TABLE Bloc de table.
PICTURE Bloc d'image.
RULER Zone de ligne horizontale/verticale.
BARCODE Bloc de code-barres.

SafeSearchAnnotation

Ensemble de caractéristiques liées à l'image, calculées à l'aide de méthodes de vision par ordinateur sur des domaines de recherche sécurisée (par exemple, contenu réservé aux adultes, spoofing, images médicales, violence).

Représentation JSON 
{
  "adult": enum (Likelihood),
  "spoof": enum (Likelihood),
  "medical": enum (Likelihood),
  "violence": enum (Likelihood),
  "racy": enum (Likelihood)
}
Champs
adult

enum (Likelihood)

Représente la probabilité que l'image comprenne du contenu réservé aux adultes. Le contenu réservé aux adultes peut comporter des éléments tels que des scènes de nudité, des images ou des dessins animés pornographiques, ou des activités à caractère sexuel.

spoof

enum (Likelihood)

Probabilité de spoofing. Probabilité qu'une modification ait été apportée à la version canonique de l'image pour la rendre amusante ou choquante.

medical

enum (Likelihood)

Probabilité de présence d'images médicales.

violence

enum (Likelihood)

Probabilité que l'image comprenne du contenu violent.

racy

enum (Likelihood)

Probabilité que l'image de la requête comporte du contenu pour adultes. Le contenu pour adultes peut inclure, mais sans s'y limiter, des tenues courtes ou transparentes, des scènes de nudité habilement dissimulée, des poses obscènes ou provocantes, ou des gros plans de zones intimes du corps.

ImageProperties

Stocke les propriétés de l'image, telles que les couleurs dominantes.

Représentation JSON 
{
  "dominantColors": {
    object (DominantColorsAnnotation)
  }
}
Champs
dominantColors

object (DominantColorsAnnotation)

Si ce champ est présent, les couleurs dominantes ont bien été identifiées.

DominantColorsAnnotation

Ensemble de couleurs dominantes et scores correspondants.

Représentation JSON 
{
  "colors": [
    {
      object (ColorInfo)
    }
  ]
}
Champs
colors[]

object (ColorInfo)

Valeurs des couleurs RVB avec leur score et leur fraction en pixels.

ColorInfo

Les informations associées aux couleurs incluent les canaux RVB, les scores et la fraction de l'image sur laquelle la couleur est présente.

Représentation JSON 
{
  "color": {
    object (Color)
  },
  "score": number,
  "pixelFraction": number
}
Champs
color

object (Color)

Composants RVB de la couleur.

score

number

Score de la couleur spécifique à l'image. Valeur comprise dans la plage [0, 1].

pixelFraction

number

Fraction de pixels sur laquelle la couleur est présente. Valeur comprise dans la plage [0, 1].

Color

Représente une couleur dans l'espace colorimétrique RVBA. Cette représentation privilégie la simplicité de conversion des représentations de couleurs en différents langages à la compacité. Par exemple, les champs de cette représentation peuvent très simplement être fournis au constructeur de "java.awt.Color" en langage Java, tout comme à la méthode "+colorWithRed:Green:blue:alpha" d'UIColor dans iOS. Avec un minimum de travail, vous pouvez aussi facilement les mettre en forme dans une chaîne CSS "rgba()" en JavaScript.

Remarque : Ce fichier Proto ne contient pas d'informations sur l'espace colorimétrique absolu à utiliser pour interpréter la valeur RVB (par exemple : sRVB, Adobe RVB, DCI-P3 et BT.2020). Par défaut, les applications DEVRAIENT partir du principe qu'il s'agit de l'espace colorimétrique sRVB.

Exemple (Java) :

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

Exemple (iOS/Obj-C) :

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

Exemple (JavaScript) :

// ...

var protoToCssColor = function(rgb_color) {
   var redFrac = rgb_color.red || 0.0;
   var greenFrac = rgb_color.green || 0.0;
   var blueFrac = rgb_color.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgb_color)) {
      return rgbToCssColor_(red, green, blue);
   }

   var alphaFrac = rgb_color.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor_ = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
Représentation JSON 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Champs
red

number

Quantité de rouge dans la couleur en tant que valeur dans l'intervalle [0, 1].

green

number

Quantité de vert dans la couleur en tant que valeur dans l'intervalle [0, 1].

blue

number

Quantité de bleu dans la couleur en tant que valeur dans l'intervalle [0, 1].

alpha

number

Fraction de cette couleur à appliquer au pixel. En d'autres termes, la couleur finale du pixel est définie par l'équation :

couleur de pixel = alpha * (cette couleur) + (1,0 - alpha) * (couleur de fond)

Cela signifie qu'une valeur de 1,0 correspond à une couleur opaque, tandis qu'une valeur de 0,0 correspond à une couleur totalement transparente. Un message wrapper est utilisé à la place d'une simple valeur scalaire flottante pour permettre de faire la distinction entre une valeur par défaut et la valeur vide. En cas d'omission, cet objet de couleur doit être affiché en tant que couleur opaque (comme si la valeur alpha avait été explicitement fournie avec une valeur de 1,0).

CropHintsAnnotation

Ensemble de suggestions de cadrage permettant de générer des cadrages lors de la diffusion d'images.

Représentation JSON 
{
  "cropHints": [
    {
      object (CropHint)
    }
  ]
}
Champs
cropHints[]

object (CropHint)

Résultats de la suggestion de cadrage.

CropHint

Suggestion de cadrage unique permettant de générer un cadrage lors de la diffusion d'une image.

Représentation JSON 
{
  "boundingPoly": {
    object (BoundingPoly)
  },
  "confidence": number,
  "importanceFraction": number
}
Champs
boundingPoly

object (BoundingPoly)

Polygone de délimitation de la zone cadrée. Les coordonnées du cadre de délimitation sont à l'échelle de l'image d'origine.

confidence

number

Niveau de confiance concernant l'importance de la zone. Plage [0, 1].

importanceFraction

number

Fraction d'importance de la région par rapport à l'image d'origine.

WebDetection

Informations utiles sur une image provenant d'Internet.

Représentation JSON 
{
  "webEntities": [
    {
      object (WebEntity)
    }
  ],
  "fullMatchingImages": [
    {
      object (WebImage)
    }
  ],
  "partialMatchingImages": [
    {
      object (WebImage)
    }
  ],
  "pagesWithMatchingImages": [
    {
      object (WebPage)
    }
  ],
  "visuallySimilarImages": [
    {
      object (WebImage)
    }
  ],
  "bestGuessLabels": [
    {
      object (WebLabel)
    }
  ]
}
Champs
webEntities[]

object (WebEntity)

Entités issues d'images similaires sur Internet.

fullMatchingImages[]

object (WebImage)

Images identiques provenant d'Internet. Peut inclure des copies redimensionnées de l'image de la requête.

partialMatchingImages[]

object (WebImage)

Images à correspondance partielle provenant d'Internet. Ces images sont suffisamment similaires pour partager certaines caractéristiques clés. Par exemple, une image d'origine peut avoir une correspondance partielle si elle est associée à une zone de recadrage.

pagesWithMatchingImages[]

object (WebPage)

Pages Web contenant les images correspondantes issues d'Internet.

visuallySimilarImages[]

object (WebImage)

Résultats d'images visuellement similaires.

bestGuessLabels[]

object (WebLabel)

Meilleure estimation du service par rapport au thème de l'image de la requête. Elle est déduite à partir d'images similaires sur le Web ouvert.

WebEntity

Entité extraite d'images similaires sur Internet.

Représentation JSON 
{
  "entityId": string,
  "score": number,
  "description": string
}
Champs
entityId

string

ID d'entité opaque.

score

number

Score de pertinence global de l'entité. Non normalisé et non comparable entre différentes requêtes d'images.

description

string

Description canonique de l'entité en anglais.

WebImage

Métadonnées des images en ligne.

Représentation JSON 
{
  "url": string,
  "score": number
}
Champs
url

string

URL de l'image du résultat.

score

number

(Obsolète) Score de pertinence global de l'image.

WebPage

Métadonnées des pages Web.

Représentation JSON 
{
  "url": string,
  "score": number,
  "pageTitle": string,
  "fullMatchingImages": [
    {
      object (WebImage)
    }
  ],
  "partialMatchingImages": [
    {
      object (WebImage)
    }
  ]
}
Champs
url

string

URL de la page Web de résultat.

score

number

(Obsolète) Score de pertinence global de la page Web.

pageTitle

string

Le titre de la page Web peut contenir des balises HTML.

fullMatchingImages[]

object (WebImage)

Images identiques sur la page. Peut inclure des copies redimensionnées de l'image de la requête.

partialMatchingImages[]

object (WebImage)

Images à correspondance partielle sur la page. Ces images sont suffisamment similaires pour partager certaines caractéristiques clés. Par exemple, une image d'origine peut avoir une correspondance partielle si elle est associée à une zone de recadrage.

WebLabel

Étiquette permettant de fournir des métadonnées supplémentaires pour la détection Web.

Représentation JSON 
{
  "label": string,
  "languageCode": string
}
Champs
label

string

Étiquette pour les métadonnées supplémentaires.

languageCode

string

Le code de langue BCP-47 pour label ("en-US" ou "sr-Latn", par exemple). Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

ProductSearchResults

Résultats d'une requête de recherche de produits.

Représentation JSON 
{
  "indexTime": string,
  "results": [
    {
      object (Result)
    }
  ],
  "productGroupedResults": [
    {
      object (GroupedResult)
    }
  ]
}
Champs
indexTime

string (Timestamp format)

Code temporel de l'index ayant fourni les résultats. Les produits ajoutés et supprimés dans l'ensemble de produits après cette date ne sont pas reflétés dans les résultats actuels.

Code temporel au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".
results[]

object (Result)

Liste des résultats, un pour chaque correspondance de produit.

productGroupedResults[]

object (GroupedResult)

Liste des résultats regroupés par produits détectés dans l'image de la requête. Chaque entrée correspond à un polygone de délimitation dans l'image de la requête et contient les produits correspondants spécifiques à cette région. Il peut y avoir des correspondances de produits en double si vous regroupez tous les résultats par produit.

Result

Informations sur un produit.

Représentation JSON 
{
  "product": {
    object (Product)
  },
  "score": number,
  "image": string
}
Champs
product

object (Product)

Le Product.

score

number

Niveau de confiance de la correspondance, compris entre 0 (aucune confiance) et 1 (confiance totale).

image

string

Nom de ressource de l'image à partir du produit qui correspond le mieux à la requête.

GroupedResult

Informations sur des produits semblables à un seul produit dans une image de requête.

Représentation JSON 
{
  "boundingPoly": {
    object (BoundingPoly)
  },
  "results": [
    {
      object (Result)
    }
  ],
  "objectAnnotations": [
    {
      object (ObjectAnnotation)
    }
  ]
}
Champs
boundingPoly

object (BoundingPoly)

Polygone de délimitation autour du produit détecté dans l'image de la requête.

results[]

object (Result)

Liste des résultats, un pour chaque correspondance de produit.

objectAnnotations[]

object (ObjectAnnotation)

Liste des prédictions génériques pour l'objet dans le cadre de délimitation.

ObjectAnnotation

Prédiction pour laquelle l'objet du cadre de délimitation est destiné.

Représentation JSON 
{
  "mid": string,
  "languageCode": string,
  "name": string,
  "score": number
}
Champs
mid

string

ID d'objet conforme au champ "mid" d'EntityAnnotation.

languageCode

string

Le code de langue BCP-47 ("en-US" ou "sr-Latn", par exemple). Pour en savoir plus, consultez http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

name

string

Nom d'objet, exprimé dans la langue correspondant au languageCode.

score

number

Score du résultat. Plage [0, 1].

ImageAnnotationContext

Si une image a été générée à partir d'un fichier (PDF, par exemple), ce message fournit des informations sur la source de cette image.

Représentation JSON 
{
  "uri": string,
  "pageNumber": number
}
Champs
uri

string

URI du fichier permettant de générer l'image.

pageNumber

number

Si le fichier est au format PDF ou TIFF, ce champ indique le numéro de page dans le fichier utilisé pour générer l'image.