Index
ImageAnnotator(interface)ProductSearch(interface)AddProductToProductSetRequest(message)AnnotateFileRequest(message)AnnotateFileResponse(message)AnnotateImageRequest(message)AnnotateImageResponse(message)AsyncAnnotateFileRequest(message)AsyncAnnotateFileResponse(message)AsyncBatchAnnotateFilesRequest(message)AsyncBatchAnnotateFilesResponse(message)AsyncBatchAnnotateImagesRequest(message)AsyncBatchAnnotateImagesResponse(message)BatchAnnotateFilesRequest(message)BatchAnnotateFilesResponse(message)BatchAnnotateImagesRequest(message)BatchAnnotateImagesResponse(message)BatchOperationMetadata(message)BatchOperationMetadata.State(enum)Block(message)Block.BlockType(enum)BoundingPoly(message)ColorInfo(message)CreateProductRequest(message)CreateProductSetRequest(message)CreateReferenceImageRequest(message)CropHint(message)CropHintsAnnotation(message)CropHintsParams(message)CustomEntityAnnotation(message)DeleteProductRequest(message)DeleteProductSetRequest(message)DeleteReferenceImageRequest(message)DocumentParsingParams(message)DominantColorsAnnotation(message)EntityAnnotation(message)FaceAnnotation(message)FaceAnnotation.Landmark(message)FaceAnnotation.Landmark.Type(enum)Feature(message)Feature.Type(enum)GcsDestination(message)GcsSource(message)GetProductRequest(message)GetProductSetRequest(message)GetReferenceImageRequest(message)Image(message)ImageAnnotationContext(message)ImageContext(message)ImageProperties(message)ImageQuality(message)ImageSource(message)ImportProductSetsGcsSource(message)ImportProductSetsInputConfig(message)ImportProductSetsRequest(message)ImportProductSetsResponse(message)InputConfig(message)KeyValuePair(message)LatLongRect(message)Likelihood(enum)ListProductSetsRequest(message)ListProductSetsResponse(message)ListProductsInProductSetRequest(message)ListProductsInProductSetResponse(message)ListProductsRequest(message)ListProductsResponse(message)ListReferenceImagesRequest(message)ListReferenceImagesResponse(message)LocalizedBarcodeAnnotation(message)LocalizedObjectAnnotation(message)LocationInfo(message)NormalizedVertex(message)OperationMetadata(message)OperationMetadata.State(enum)OutputConfig(message)Page(message)Paragraph(message)Position(message)Product(message)Product.KeyValue(message)ProductSearchParams(message)ProductSearchResults(message)ProductSearchResults.GroupedResult(message)ProductSearchResults.ObjectAnnotation(message)ProductSearchResults.Result(message)ProductSet(message)Property(message)QualityOptimizationParams(message)QualityOptimizationParams.CompressionConfig(message)QualityOptimizationParams.EnhancementConfig(message)QualityOptimizationParams.QualityScoreConfig(message)QualityOptimizationParams.Type(enum)QualityOptimizationResult(message)ReferenceImage(message)RemoveProductFromProductSetRequest(message)SafeSearchAnnotation(message)Symbol(message)Table(message)Table.TableCell(message)Table.TableRow(message)TableBoundHint(message)TableDetectionOptions(message)TextAnnotation(message)TextAnnotation.DetectedBreak(message)TextAnnotation.DetectedBreak.BreakType(enum)TextAnnotation.DetectedLanguage(message)TextAnnotation.TextProperty(message)TextDetectionParams(message)UpdateProductRequest(message)UpdateProductSetRequest(message)Vertex(message)WebDetection(message)WebDetection.WebEntity(message)WebDetection.WebImage(message)WebDetection.WebLabel(message)WebDetection.WebPage(message)WebDetectionParams(message)Word(message)
ImageAnnotator
Service effectuant des tâches de détection de l'API Google Cloud Vision sur les images client, telles que la détection de visages, de points de repère, de logos, de thèmes et de texte. Le service ImageAnnotator renvoie les entités détectées dans les images.
| AsyncBatchAnnotateFiles | |
|---|---|
|
Détecte et annote de manière asynchrone les images d'une liste de fichiers génériques, tels que des fichiers PDF, qui peuvent contenir plusieurs pages et plusieurs images par page. La progression et les résultats peuvent être récupérés par le biais de l'interface
|
|
| AsyncBatchAnnotateImages | |
|---|---|
|
Détecte et annote une liste d'images de manière asynchrone. La progression et les résultats peuvent être récupérés par le biais de l'interface Ce service écrit les résultats de l'annotation d'images dans des fichiers JSON dans le bucket Google Cloud Storage du client, chacun d'eux contenant un fichier .proto BatchAnnotateImagesResponse.
|
|
| BatchAnnotateFiles | |
|---|---|
|
Service qui détecte et annote les images d'un lot de fichiers. Actuellement, seuls les fichiers "application/pdf", "image/tiff" et "image/gif" sont acceptés. Ce service extrait au maximum les 10 premiers frames (gif) ou pages (PDF ou TIFF) de chaque fichier fourni, et détecte et annote chaque image extraite.
|
|
| BatchAnnotateImages | |
|---|---|
|
Détecte et annote un lot d'images.
|
|
ProductSearch
Gère les Products et ProductSets des images de référence à utiliser dans la recherche de produits. ProductSearch se sert du modèle de ressource suivant :
- L'API dispose d'un ensemble de ressources
ProductSet, nomméprojects/*/locations/*/productSets/*, permettant de regrouper différents produits afin de limiter l'identification.
En parallèle :
L'API dispose d'un ensemble de ressources
Productnomméprojects/*/locations/*/products/*.Chaque
Productpossède un ensemble de ressourcesReferenceImagenomméprojects/*/locations/*/products/*/referenceImages/*.
| AddProductToProductSet | |
|---|---|
|
Ajoute un Product au ProductSet spécifié. Si le Product est déjà présent, aucune modification n'est apportée. Vous pouvez ajouter un Product à 100 ProductSets au maximum. Erreurs possibles :
|
|
| CreateProduct | |
|---|---|
|
Crée et affiche une ressource Product. Erreurs possibles :
|
|
| CreateProductSet | |
|---|---|
|
Crée et affiche une ressource ProductSet. Erreurs possibles :
|
|
| CreateReferenceImage | |
|---|---|
|
Crée et affiche une ressource ReferenceImage. Le champ Notez que le pipeline redimensionne l'image si sa résolution est trop élevée pour qu'elle puisse être traitée (plus de 50 Mpx). Erreurs possibles :
|
|
| DeleteProduct | |
|---|---|
|
Supprime définitivement un produit et ses images de référence. Les métadonnées du produit et toutes ses images de référence sont immédiatement supprimées. Cependant, les requêtes de recherche portant sur des ressources ProductSet incluant le produit peuvent continuer de fonctionner jusqu'à l'actualisation de tous les caches associés. Erreurs possibles :
|
|
| DeleteProductSet | |
|---|---|
|
Supprime définitivement un ProductSet. Les ressources Product et ReferenceImage stockées dans le ProductSet ne sont pas supprimées. Les fichiers image stockés dans Google Cloud Storage ne sont pas supprimés. Erreurs possibles :
|
|
| DeleteReferenceImage | |
|---|---|
|
Supprime définitivement une image de référence. Les métadonnées de l'image sont immédiatement supprimées. Cependant, les requêtes de recherche portant sur des ProductSets incluant l'image peuvent continuer de fonctionner jusqu'à l'actualisation de tous les caches associés. Les fichiers image stockés dans Google Cloud Storage ne sont pas supprimés. Erreurs possibles :
|
|
| GetProduct | |
|---|---|
|
Récupère les informations associées à un Product. Erreurs possibles :
|
|
| GetProductSet | |
|---|---|
|
Récupère les informations associées à un ProductSet. Erreurs possibles :
|
|
| GetReferenceImage | |
|---|---|
|
Récupère les informations associées à une ReferenceImage. Erreurs possibles :
|
|
| ImportProductSets | |
|---|---|
|
API asynchrone permettant d'importer une liste d'images de référence dans des ensembles de produits spécifiés en fonction d'une liste d'informations les concernant. L'API La source d'entrée de cette méthode est un fichier CSV stocké dans Google Cloud Storage. Pour en savoir plus sur le format du fichier CSV, consultez
|
|
| ListProductSets | |
|---|---|
|
Recense les ProductSets dans un ordre non spécifié. Erreurs possibles :
|
|
| ListProducts | |
|---|---|
|
Recense les produits dans un ordre non spécifié. Erreurs possibles :
|
|
| ListProductsInProductSet | |
|---|---|
|
Recense les Products d'un ProductSet dans un ordre non spécifié. Si le ProductSet n'existe pas, le champ "products" de la réponse est vide. Erreurs possibles :
|
|
| ListReferenceImages | |
|---|---|
|
Recense les images de référence. Erreurs possibles :
|
|
| RemoveProductFromProductSet | |
|---|---|
|
Supprime un Product du ProductSet spécifié. Erreurs possibles :
|
|
| UpdateProduct | |
|---|---|
|
Apporte des modifications à une ressource Product. Seuls les champs Si des étiquettes sont mises à jour, la modification n'est répercutée dans les requêtes qu'à la prochaine indexation. Erreurs possibles :
|
|
| UpdateProductSet | |
|---|---|
|
Apporte des modifications à une ressource ProductSet. Seul le champ "display_name" peut être mis à jour pour le moment. Erreurs possibles :
|
|
AddProductToProductSetRequest
Message de requête pour la méthode AddProductToProductSet.
| Champs | |
|---|---|
name |
Nom de ressource du ProductSet à modifier. Format : |
product |
Nom de ressource du Product à ajouter à ce ProductSet. Format : |
AnnotateFileRequest
Requête permettant d'annoter un seul fichier, par exemple un fichier PDF, TIFF ou GIF.
| Champs | |
|---|---|
input_config |
Obligatoire. Informations sur le fichier d'entrée. |
features[] |
Obligatoire. Fonctionnalités demandées. |
image_context |
Contexte supplémentaire pouvant accompagner les images du fichier. |
pages[] |
Pages du fichier sur lesquelles annoter des images. La numérotation des pages commence à 1. Nous partons du principe que la première page du fichier est la page 1. Vous pouvez ajouter jusqu'à cinq pages par requête. Les pages peuvent être négatives. La page 1 correspond à la première page. La page 2 correspond à la deuxième page. La page -1 correspond à la dernière page. La page -2 correspond à l'avant-dernière page. Si le fichier est au format GIF, et non PDF ou TIFF, la valeur "page" fait référence à des frames GIF. Si ce champ est vide, le service annote les images des cinq premières pages du fichier par défaut. |
AnnotateFileResponse
Réponse à une requête d'annotation sur un seul fichier. Un fichier peut contenir une ou plusieurs images, chacune disposant de ses propres réponses.
| Champs | |
|---|---|
input_config |
Informations sur le fichier pour lequel la réponse est générée. |
responses[] |
Réponses individuelles pour les images trouvées dans le fichier. |
AnnotateImageRequest
Requête permettant d'effectuer des tâches de l'API Google Cloud Vision sur une image fournie par l'utilisateur, avec des fonctionnalités demandées par l'utilisateur et des informations contextuelles.
| Champs | |
|---|---|
image |
Image à traiter. |
features[] |
Fonctionnalités demandées. |
image_context |
Contexte supplémentaire pouvant accompagner l'image. |
custom_label_detection_models[] |
Lorsque vous effectuez une requête avec une valeur |
AnnotateImageResponse
Réponse à une requête d'annotation d'images.
| Champs | |
|---|---|
face_annotations[] |
Si ce champ est présent, la détection de visages a bien été effectuée. |
landmark_annotations[] |
Si ce champ est présent, la détection de points de repère a bien été effectuée. |
logo_annotations[] |
Si ce champ est présent, la détection de logos a bien été effectuée. |
label_annotations[] |
Si ce champ est présent, la détection de thèmes a bien été effectuée. |
localized_object_annotations[] |
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. |
custom_label_annotations[] |
Si ce champ est présent, l'annotation personnalisée a bien été effectuée. |
text_annotations[] |
Si ce champ est présent, la détection de texte (OCR) a bien été effectuée. |
full_text_annotation |
Si ce champ est présent, la détection de texte (OCR) ou du texte d'un document (OCR) a bien été effectuée. Cette annotation fournit la hiérarchie structurelle du texte détecté par l'OCR. |
safe_search_annotation |
Si ce champ est présent, l'annotation de recherche sécurisée a bien été effectuée. |
image_properties_annotation |
Si ce champ est présent, les propriétés de l'image ont bien été extraites. |
crop_hints_annotation |
Si ce champ est présent, les suggestions de cadrage ont bien été effectuées. |
web_detection |
Si ce champ est présent, la détection Web a bien été effectuée. |
product_search_results |
Si ce champ est présent, la recherche de produits a bien été effectuée. |
error |
Si ce champ est défini, il présente le message d'erreur associé à l'opération. Notez que les annotations d'images préremplies sont assurément correctes, même lorsque |
context |
Si ce champ est présent, des informations contextuelles sont nécessaires pour comprendre d'où provient cette image. |
image_quality_annotation |
Si ce champ est présent, le calcul de qualité d'image a bien été effectué. |
object_attribute_annotations[] |
Si ce champ est présent, le calcul des attributs d'objets a bien été effectué. La valeur des attributs sera renseignée dans EntityAnnotation.properties. Exemple : object_attribute_annotations { properties { name: "color" value: "blue" confidence: 0.1 } properties { name: "color" value: "white" confidence: 0.2 } properties { name: "material" value: "silk" confidence: 0.3 } } |
quality_optimization_result |
Si ce champ est présent, l'optimisation de la qualité d'image a bien été effectuée. |
localized_barcode_annotations[] |
Si ce champ est présent, la détection de codes-barres localisés a bien été effectuée. |
AsyncAnnotateFileRequest
Requête d'annotation de fichiers hors connexion.
| Champs | |
|---|---|
input_config |
Obligatoire. Informations sur le fichier d'entrée. |
features[] |
Obligatoire. Fonctionnalités demandées. |
image_context |
Contexte supplémentaire pouvant accompagner les images du fichier. |
output_config |
Obligatoire. Emplacement de sortie et métadonnées (par exemple, le format) souhaités. |
AsyncAnnotateFileResponse
Réponse à une requête d'annotation sur un seul fichier hors connexion.
| Champs | |
|---|---|
output_config |
Emplacement de sortie et métadonnées d'AsyncAnnotateFileRequest. |
AsyncBatchAnnotateFilesRequest
Plusieurs requêtes d'annotation de fichiers asynchrones sont regroupées dans un seul appel de service.
| Champs | |
|---|---|
requests[] |
Requêtes d'annotation de fichiers asynchrones individuelles du lot. |
AsyncBatchAnnotateFilesResponse
Réponse à une requête d'annotation de fichier par lot asynchrone.
| Champs | |
|---|---|
responses[] |
Liste des résultats de l'annotation de fichiers, chacun d'eux correspondant à une requête d'AsyncBatchAnnotateFilesRequest. |
AsyncBatchAnnotateImagesRequest
Requête d'annotation asynchrone pour une liste d'images.
| Champs | |
|---|---|
requests[] |
Requêtes d'annotation d'images individuelles pour ce lot. |
output_config |
Obligatoire. Emplacement de sortie et métadonnées (par exemple, le format) souhaités. |
AsyncBatchAnnotateImagesResponse
Réponse à une requête d'annotation d'images par lot asynchrone.
| Champs | |
|---|---|
output_config |
Emplacement de sortie et métadonnées d'AsyncBatchAnnotateImagesRequest. |
BatchAnnotateFilesRequest
Liste des requêtes permettant d'annoter des fichiers à l'aide de l'API BatchAnnotateFiles.
| Champs | |
|---|---|
requests[] |
Liste des requêtes d'annotation de fichiers. À l'heure actuelle, nous n'acceptons qu'une seule AnnotateFileRequest dans BatchAnnotateFilesRequest. |
BatchAnnotateFilesResponse
Liste des résultats de l'annotation de fichiers.
| Champs | |
|---|---|
responses[] |
Liste des résultats de l'annotation de fichiers, chacun d'eux correspondant à une AnnotateFileRequest dans BatchAnnotateFilesRequest. |
BatchAnnotateImagesRequest
Plusieurs requêtes d'annotation d'images sont regroupées dans un seul appel de service.
| Champs | |
|---|---|
requests[] |
Requêtes d'annotation d'images individuelles du lot. |
BatchAnnotateImagesResponse
Réponse à une requête d'annotation d'images par lot.
| Champs | |
|---|---|
responses[] |
Réponses individuelles pour les requêtes d'annotation d'images du lot. |
BatchOperationMetadata
Métadonnées des opérations par lot, telles que l'état actuel.
Elles sont incluses dans le champ metadata de l'Operation renvoyée par l'appel GetOperation du service google::longrunning::Operations.
| Champs | |
|---|---|
state |
État actuel de l'opération par lot. |
submit_time |
Date/Heure de l'envoi de la requête par lot au serveur. |
end_time |
Date/Heure de fin de la requête par lot et |
State
Énumère les états possibles d'une requête par lot.
| Énumérations | |
|---|---|
STATE_UNSPECIFIED |
Non valide. |
PROCESSING |
La requête est en cours de traitement. |
SUCCESSFUL |
La requête a bien été effectuée et au moins un élément a bien été traité. |
FAILED |
La requête a bien été effectuée et aucun élément n'a été traité. |
CANCELLED |
La requête est envoyée une fois que l'utilisateur a appelé la méthode longrunning.Operations.CancelOperation. Tous les enregistrements traités avant la commande d'annulation sont affichés comme indiqué dans la requête. |
Block
Élément logique sur la page.
| Champs | |
|---|---|
property |
Informations supplémentaires détectées pour le bloc. |
bounding_box |
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 :
L'ordre des sommets est toujours (0, 1, 2, 3). |
paragraphs[] |
Liste des paragraphes du bloc (s'il est de type texte). |
block_type |
Type de bloc détecté (texte, image, etc.) pour le bloc. |
confidence |
Niveau de confiance des résultats de l'OCR dans le bloc. Plage [0, 1]. |
table |
Table détectée pour le block_type TABLE. Par défaut, ce champ n'est pas renvoyé, sauf s'il est activé via TextDetectionParams.table_detection_options. Les |
key_value_pair |
Paire détectée pour block_type KEY_VALUE_PAIR. Par défaut, ce champ n'est pas renvoyé, sauf si DocumentType est spécifié. |
merged_text |
Ensemble du texte UTF-8 détecté dans ce bloc. Par défaut, ce champ n'est pas renvoyé, sauf indication contraire dans TextDetectionParams.block_filter. |
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 tableau. |
PICTURE |
Bloc d'image. |
RULER |
Zone de ligne horizontale/verticale. |
BARCODE |
Bloc de code-barres. |
KEY_VALUE_PAIR |
Un bloc de paire clé-valeur-. |
BoundingPoly
Polygone de délimitation pour l'annotation d'image détectée.
| Champs | |
|---|---|
vertices[] |
Sommets du polygone de délimitation. |
normalized_vertices[] |
Sommets normalisés du polygone de délimitation. |
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.
| Champs | |
|---|---|
color |
Composants RVB de la couleur. |
score |
Score de la couleur spécifique à l'image. Valeur comprise dans la plage [0, 1]. |
pixel_fraction |
Fraction de pixels sur laquelle la couleur est présente. Valeur comprise dans la plage [0, 1]. |
CreateProductRequest
Message de requête pour la méthode CreateProduct.
| Champs | |
|---|---|
parent |
Projet dans lequel le Product doit être créé. Format : |
product |
Produit à créer. |
product_id |
ID de ressource fourni par l'utilisateur pour ce Product. Si ce champ est défini, le serveur tente d'utiliser cette valeur en tant qu'ID de ressource. Si elle est déjà utilisée, une erreur est renvoyée avec le code ALREADY_EXISTS. Ne doit pas dépasser 128 caractères. Ne peut pas inclure le caractère |
CreateProductSetRequest
Message de requête pour la méthode CreateProductSet.
| Champs | |
|---|---|
parent |
Projet dans lequel le ProductSet doit être créé. Format : |
product_set |
ProductSet à créer. |
product_set_id |
ID de ressource fourni par l'utilisateur pour ce ProductSet. Si ce champ est défini, le serveur tente d'utiliser cette valeur en tant qu'ID de ressource. Si elle est déjà utilisée, une erreur est renvoyée avec le code ALREADY_EXISTS. Ne doit pas dépasser 128 caractères. Ne peut pas inclure le caractère |
CreateReferenceImageRequest
Message de requête pour la méthode CreateReferenceImage.
| Champs | |
|---|---|
parent |
Nom de ressource du produit dans lequel créer l'image de référence. Format : |
reference_image |
Image de référence à créer. Si un ID d'image est spécifié, il est ignoré. |
reference_image_id |
ID de ressource fourni par l'utilisateur pour la ReferenceImage à ajouter. Si ce champ est défini, le serveur tente d'utiliser cette valeur en tant qu'ID de ressource. Si elle est déjà utilisée, une erreur est renvoyée avec le code ALREADY_EXISTS. Ne doit pas dépasser 128 caractères. Ne peut pas inclure le caractère |
CropHint
Suggestion de cadrage unique permettant de générer un cadrage lors de la diffusion d'une image.
| Champs | |
|---|---|
bounding_poly |
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 |
Niveau de confiance concernant l'importance de la zone. Plage [0, 1]. |
importance_fraction |
Fraction d'importance de la région par rapport à l'image d'origine. |
CropHintsAnnotation
Ensemble de suggestions de cadrage permettant de générer des cadrages lors de la diffusion d'images.
| Champs | |
|---|---|
crop_hints[] |
Résultats de la suggestion de cadrage. |
CropHintsParams
Paramètres de la requête d'annotation de suggestions de cadrage.
| Champs | |
|---|---|
aspect_ratios[] |
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. |
CustomEntityAnnotation
Une CustomEntityAnnotation contient des annotations prédites à l'aide de modèles personnalisés Vision.
| Champs | |
|---|---|
model |
Identifie le modèle personnalisé utilisé pour créer cette annotation. Le format du nom du modèle est l'URL de ressource du mode personnalisé qui a été interrogé : |
label |
Étiquette prédite par le modèle personnalisé. |
score |
Score de confiance de l'étiquette donné par le modèle personnalisé. |
DeleteProductRequest
Message de requête pour la méthode DeleteProduct.
| Champs | |
|---|---|
name |
Nom de ressource du produit à supprimer. Format : |
DeleteProductSetRequest
Message de requête pour la méthode DeleteProductSet.
| Champs | |
|---|---|
name |
Nom de ressource du ProductSet à supprimer. Format : |
DeleteReferenceImageRequest
Message de requête pour la méthode DeleteReferenceImage.
| Champs | |
|---|---|
name |
Nom de ressource de l'image de référence à supprimer. Format :
|
DocumentParsingParams
Paramètres de la fonctionnalité DOCUMENT_PARSING.
| Champs | |
|---|---|
disable_orientation_detection |
Désactive la détection de l'orientation de sorte que le texte ayant une orientation différente ne soit pas détecté. |
table_detection_options |
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. |
document_type |
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). |
DominantColorsAnnotation
Ensemble de couleurs dominantes et scores correspondants.
| Champs | |
|---|---|
colors[] |
Valeurs des couleurs RVB avec leur score et leur fraction en pixels. |
EntityAnnotation
Ensemble des caractéristiques d'entités détectées.
| Champs | |
|---|---|
mid |
ID d'entité opaque. Certains identifiants sont disponibles dans l'API Google Knowledge Graph Search. |
locale |
Code de langue des paramètres régionaux dans lequel la |
description |
Description textuelle de l'entité, exprimée dans sa langue |
score |
Score global du résultat. Plage [0, 1]. |
confidence |
Obsolète. Utilisez plutôt |
topicality |
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]. |
bounding_poly |
Zone de l'image à laquelle appartient cette entité. Champ non généré pour les fonctionnalités |
locations[] |
Informations sur l'emplacement de l'entité détectée. Plusieurs éléments |
properties[] |
Certaines entités peuvent inclure des champs |
FaceAnnotation
Objet d'annotation de visage contenant les résultats de la détection de visages.
| Champs | |
|---|---|
bounding_poly |
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 |
fd_bounding_poly |
Le polygone de délimitation
(détection de visages). |
landmarks[] |
Points de repère détectés sur le visage. |
roll_angle |
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]. |
pan_angle |
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]. |
tilt_angle |
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]. |
detection_confidence |
Niveau de confiance de la détection. Plage [0, 1]. |
landmarking_confidence |
Niveau de confiance des points de repère du visage. Plage [0, 1]. |
joy_likelihood |
Probabilité de joie. |
sorrow_likelihood |
Probabilité de tristesse. |
anger_likelihood |
Probabilité de colère. |
surprise_likelihood |
Probabilité de surprise. |
under_exposed_likelihood |
Probabilité de sous-exposition. |
blurred_likelihood |
Probabilité de flou. |
headwear_likelihood |
Probabilité de port d'accessoires. |
Landmark
Point de repère spécifique au visage (par exemple, une caractéristique du visage).
| Champs | |
|---|---|
type |
Type de point de repère du visage. |
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. |
Feature
Type de détection de l'API Google Cloud Vision à effectuer, et nombre maximal de résultats à renvoyer pour ce type. Vous pouvez définir plusieurs objets Feature dans la liste features.
| Champs | |
|---|---|
type |
Type de fonctionnalité. |
max_results |
Nombre maximal de résultats de ce type. Ne s'applique pas à |
model |
Modèle à utiliser pour la fonctionnalité. Valeurs acceptées : "builtin/stable" (valeur par défaut si ce paramètre n'est pas défini) et "builtin/latest". |
Type
Type de fonctionnalité de l'API Google Cloud Vision à extraire.
| Énumérations | |
|---|---|
TYPE_UNSPECIFIED |
Type de fonctionnalité non spécifié. |
FACE_DETECTION |
Exécute la détection de visages. |
LANDMARK_DETECTION |
Exécute la détection de points de repère. |
LOGO_DETECTION |
Exécute la détection de logos. |
LABEL_DETECTION |
Exécute la détection de thèmes. |
TEXT_DETECTION |
Lance la détection de texte/la reconnaissance optique des caractères (OCR). La détection de texte est optimisée pour les zones de texte dans une grande image. Si l'image est un document, utilisez plutôt DOCUMENT_TEXT_DETECTION. |
DOCUMENT_TEXT_DETECTION |
Exécute l'OCR dans un document texte dense. Prioritaire lorsque DOCUMENT_TEXT_DETECTION et TEXT_DETECTION sont présents. |
SAFE_SEARCH_DETECTION |
Exécute des requêtes de recherches sécurisées pour détecter du contenu potentiellement dangereux ou indésirable. |
IMAGE_PROPERTIES |
Calcule un ensemble de propriétés d'image, telles que les couleurs dominantes de l'image. |
CROP_HINTS |
Exécute des suggestions de cadrage. |
WEB_DETECTION |
Exécute la détection Web. |
PRODUCT_SEARCH |
Lance la recherche de produits. |
CUSTOM_LABEL_DETECTION |
Exécute la détection d'étiquettes personnalisées. |
OBJECT_LOCALIZATION |
Lance la localisation pour détecter des objets. |
IMAGE_QUALITY |
Exécute le marqueur des scores de qualité. |
OBJECT_ATTRIBUTES |
Attributs de calcul des objets détectés dans l'image. Quatre domaines d'objets sont acceptés. Veuillez faire votre choix via feature.model (obligatoire) : "builtin/apparel", "builtin/car", "builtin/food" ou "builtin/wildlife". |
QUALITY_OPTIMIZATION |
Exécute des algorithmes d'optimisation de la qualité. Il existe trois types d'opérations : COMPRESSION, ENHANCEMENT et QUALITY_SCORE. Les paramètres COMPRESSION et ENHANCEMENT, ainsi que le choix du modèle QUALITY_SCORE peuvent être spécifiés dans image_context.quality_optimization_params. |
BARCODE_DETECTION |
Exécute la détection et la reconnaissance de codes-barres. |
DOCUMENT_PARSING |
Exécute des algorithmes d'analyse de documents pour extraire des données structurées telles que des tables et des formulaires. Les résultats se trouvent dans full_text_annotation -> page -> block avec le type TABLE pour les tables ou KEY_VALUE_PAIR pour les paires clé/valeur dans les formulaires. |
GcsDestination
Emplacement Google Cloud Storage sur lequel le résultat doit être écrit.
| Champs | |
|---|---|
uri |
URI Google Cloud Storage où seront stockés les résultats. Les résultats sont au format JSON et précédés de l'URI d'entrée correspondant. Ce champ peut représenter un seul fichier ou un préfixe pour plusieurs sorties. Les préfixes doivent se terminer par Exemples :
Si plusieurs sorties existent, toutes les réponses contiennent "AnnotateFileResponse", chacune incluant un sous-ensemble de la liste complète d'AnnotateImageResponse. Plusieurs sorties peuvent être générées si, par exemple, la sortie JSON est trop volumineuse et qu'elle est répartie en plusieurs fichiers segmentés. |
GcsSource
Emplacement Google Cloud Storage dans lequel l'entrée est lue.
| Champs | |
|---|---|
uri |
URI Google Cloud Storage du fichier d'entrée. Il ne peut s'agir que d'un objet Google Cloud Storage. Les caractères génériques ne sont pas acceptés pour le moment. |
GetProductRequest
Message de requête pour la méthode GetProduct.
| Champs | |
|---|---|
name |
Nom de ressource du Product à récupérer. Format : |
GetProductSetRequest
Message de requête pour la méthode GetProductSet.
| Champs | |
|---|---|
name |
Nom de ressource du ProductSet à récupérer. Format : |
GetReferenceImageRequest
Message de requête pour la méthode GetReferenceImage.
| Champs | |
|---|---|
name |
Nom de ressource de la ReferenceImage à récupérer. Format :
|
Image
Image client sur laquelle effectuer les tâches de l'API Google Cloud Vision.
| Champs | |
|---|---|
content |
Contenu de l'image représenté sous forme de flux d'octets. Remarque : comme pour tous les champs |
source |
Emplacement de l'image dans Google Cloud Storage ou URL de l'image accessible au public. Si les champs |
ImageAnnotationContext
Si une image a été générée à partir d'un fichier (PDF, par exemple), ce message donne des informations sur la source de cette image.
| Champs | |
|---|---|
uri |
URI du fichier permettant de générer l'image. |
page_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. |
ImageContext
Contexte de l'image et/ou paramètres spécifiques à une fonctionnalité.
| Champs | |
|---|---|
lat_long_rect |
Non utilisé. |
language_hints[] |
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 |
crop_hints_params |
Paramètres de la requête d'annotation de suggestions de cadrage. |
product_search_params |
Paramètres de la recherche de produits. |
web_detection_params |
Paramètres de la détection Web. |
text_detection_params |
Paramètres de la détection de texte dans des documents. |
quality_optimization_params |
Paramètres de l'optimisation de la qualité des images. |
document_parsing_params |
Paramètres de l'analyse des documents. |
ImageProperties
Stocke les propriétés de l'image, telles que les couleurs dominantes.
| Champs | |
|---|---|
dominant_colors |
Si ce champ est présent, les couleurs dominantes ont bien été identifiées. |
ImageQuality
Stocke les scores de qualité des images, qui peuvent être des qualités visuelles ou techniques.
| Champs | |
|---|---|
quality_score |
Score représentant la qualité mathématique ou technique de l'image. Le score est compris dans la plage [0, 1]. Plus la valeur est élevée, plus les photos sont de qualité professionnelle. La valeur 0 signifie que l'image semble être de très mauvaise qualité, la valeur 1 signifie qu'elle est de très haute qualité. |
ImageSource
Source externe de l'image (emplacement Google Cloud Storage ou URL Web).
| Champs | |
|---|---|
gcs_image_uri |
Utilisez plutôt URI Google Cloud Storage au format |
image_uri |
URI de l'image source. Peut être soit :
Lorsque les champs |
ImportProductSetsGcsSource
Emplacement Google Cloud Storage d'un fichier CSV contenant une liste d'ImportProductSetRequests sur chaque ligne.
| Champs | |
|---|---|
csv_file_uri |
URI Google Cloud Storage du fichier CSV d'entrée. L'URI doit commencer par Le fichier CSV d'entrée doit inclure une image par ligne. Chaque ligne contient huit colonnes.
Les colonnes Si le La colonne La colonne Si un La colonne La colonne Une seule colonne La colonne Le système redimensionne l'image si sa résolution est trop élevée pour qu'elle puisse être traitée (plus de 20 Mpx). |
ImportProductSetsInputConfig
Contenu d'entrée de la méthode ImportProductSets.
| Champs | |
|---|---|
gcs_source |
Emplacement Google Cloud Storage d'un fichier CSV contenant une liste d'ImportProductSetRequests sur chaque ligne. |
ImportProductSetsRequest
Message de requête pour la méthode ImportProductSets.
| Champs | |
|---|---|
parent |
Projet dans lequel les ProductSet doivent être importés. Format : |
input_config |
Contenu d'entrée de la liste de requêtes. |
ImportProductSetsResponse
Message de réponse pour la méthode ImportProductSets.
Ce message est renvoyé par la méthode google.longrunning.Operations.GetOperation dans le champ google.longrunning.Operation.response.
| Champs | |
|---|---|
reference_images[] |
Liste des champs "reference_images" qui ont bien été importés. |
statuses[] |
État RPC de chaque requête ImportProductSet, y compris les réussites et les erreurs. Le nombre d'états indiqué ici correspond au nombre de lignes du fichier CSV. L'état [i] stocke l'état de réussite ou d'échec du traitement de la ligne [i] du fichier CSV, en partant de la ligne 0. |
InputConfig
Emplacement d'entrée et métadonnées souhaités.
| Champs | |
|---|---|
gcs_source |
Emplacement Google Cloud Storage à partir duquel lire l'entrée. |
content |
Contenu de l'image représenté sous forme de flux d'octets. Remarque : comme pour tous les champs Actuellement, ce champ n'est compatible qu'avec les requêtes BatchAnnotateFiles. Il ne peut pas être utilisé pour les requêtes AsyncBatchAnnotateFiles. |
mime_type |
Type de fichier. Actuellement, seuls les fichiers "application/pdf" et "image/tiff" sont acceptés. Les caractères génériques ne peuvent pas être utilisés. |
KeyValuePair
Proto pour une paire clé-valeur.
| Champs | |
|---|---|
key |
Valeur de la chaîne de clé. |
key_block |
Bloc de clé de la paire contenant le cadre de délimitation normalisé et le texte de la clé. |
value_block |
Bloc de valeur de la paire contenant le cadre de délimitation normalisé et le texte de la valeur, y compris les structures potentiellement plus profondes dans le texte de la valeur. |
value_type |
Type de la valeur. Les chaînes valides sont les suivantes : "generic" : pour du texte générique mappé sur une valeur. "number" : pour les types numériques. "id" : pour les identifiants génériques. "currency" : pour les valeurs de devise. "date" : pour les dates. "time" : pour les valeurs de temps et de durée. "date_range" : pour les plages de dates. "address" : pour les valeurs d'adresse (peuvent être longues). "person" : pour les noms de personnes ou d'autres identifiants personnels. "phone" : pour les numéros de téléphone. |
normalized_key |
(Facultatif) Texte de clé normalisé si le texte est courant et classé. Par exemple, "TOTAL DUE" sera normalisé en "Total amount". |
LatLongRect
Rectangle déterminé par des paires LatLng minimales et maximales.
| Champs | |
|---|---|
min_lat_lng |
Paire latitude/longitude minimale. |
max_lat_lng |
Paire latitude/longitude maximale. |
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 |
Il est très peu probable que l'image appartienne au secteur spécifié. |
UNLIKELY |
Il est peu probable que l'image appartienne au secteur spécifié. |
POSSIBLE |
Il est possible que l'image appartienne au secteur spécifié. |
LIKELY |
Il est probable que l'image appartienne au secteur spécifié. |
VERY_LIKELY |
Il est très probable que l'image appartienne au secteur spécifié. |
ListProductSetsRequest
Message de requête pour la méthode ListProductSets.
| Champs | |
|---|---|
parent |
Projet à partir duquel les ProductSets doivent être recensés. Format : |
page_size |
Le nombre maximum d'éléments à renvoyer. 10 (par défaut), 100 au maximum. |
page_token |
Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant. |
ListProductSetsResponse
Message de réponse pour la méthode ListProductSets.
| Champs | |
|---|---|
product_sets[] |
Liste des ProductSets. |
next_page_token |
Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats. |
ListProductsInProductSetRequest
Message de requête pour la méthode ListProductsInProductSet.
| Champs | |
|---|---|
name |
Ressource ProductSet pour laquelle les Products doivent être récupérés. Format : |
page_size |
Le nombre maximum d'éléments à renvoyer. 10 (par défaut), 100 au maximum. |
page_token |
Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant. |
ListProductsInProductSetResponse
Message de réponse pour la méthode ListProductsInProductSet.
| Champs | |
|---|---|
products[] |
Liste des Products. |
next_page_token |
Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats. |
ListProductsRequest
Message de requête pour la méthode ListProducts.
| Champs | |
|---|---|
parent |
Projet OU ProductSet à partir duquel les Products doivent être recensés. Format : |
page_size |
Le nombre maximum d'éléments à renvoyer. 10 (par défaut), 100 au maximum. |
page_token |
Valeur next_page_token renvoyée par une requête "List" précédente, le cas échéant. |
ListProductsResponse
Message de réponse pour la méthode ListProducts.
| Champs | |
|---|---|
products[] |
Liste des produits. |
next_page_token |
Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats. |
ListReferenceImagesRequest
Message de requête pour la méthode ListReferenceImages.
| Champs | |
|---|---|
parent |
Nom de la ressource du produit contenant les images de référence. Format : |
page_size |
Le nombre maximum d'éléments à renvoyer. 10 (par défaut), 100 au maximum. |
page_token |
Jeton identifiant une page de résultats à renvoyer. Il s'agit de la valeur de Si ce champ n'est pas spécifié, la première page est la valeur par défaut. |
ListReferenceImagesResponse
Message de réponse pour la méthode ListReferenceImages.
| Champs | |
|---|---|
reference_images[] |
Liste des images de référence. |
page_size |
Le nombre maximum d'éléments à renvoyer. 10 (par défaut), 100 au maximum. |
next_page_token |
Valeur "next_page_token" renvoyée par une requête "List" précédente, le cas échéant. |
LocalizedBarcodeAnnotation
Ensemble de codes-barres détectés avec des cadres de délimitation.
| Champs | |
|---|---|
format |
Le format du code-barres décrit le format. Les formats compatibles sont les suivants : CODE_128 : type de code 128. CODE_39 : type de code 39. CODE_93 : type de code 93. CODABAR : type Codabar. DATA_MATRIX : type de matrice de données 2D. ITF : type ITF. EAN_13 : type EAN-13. EAN_8 : type EAN-8. QRCODE : type code QR 2D. UPC_A : type UPC-A. UPC_E : type UPC-E. PDF417 : type PDF417. AZTEC : type de code Aztec 2D. DATABAR : type de code GS1 DataBar. |
value_format |
Le format de la valeur du code-barres décrit le format de la valeur encodée en code-barres. Les formats de valeurs acceptés sont les suivants : CONTACT_INFO: coordonnées. EMAIL : adresse e-mail. ISBN : identifiant ISBN. PHONE : numéro de téléphone. PRODUCT : produit. SMS : SMS. TEXT : chaîne de texte. URL : adresse URL. WIFI : informations sur le Wi-Fi. GEO : géolocalisation (longitude et latitude). CALENDAR_EVENT : événement d'agenda. DRIVER_LICENSE : permis de conduire. |
value |
Valeur de code-barres correspondant à la valeur ASCII capturée dans le code-barres. Les codes-barres peuvent encoder des valeurs structurées, par exemple "MEBKM:TITLE:Google;URL:https://www.google.com;;". |
confidence |
Niveau de confiance du résultat. Plage [0, 1]. |
bounding_poly |
Région de l'image à laquelle appartient ce code-barres. Ces informations doivent être renseignées. |
LocalizedObjectAnnotation
Ensemble d'objets détectés avec des cadres de délimitation.
| Champs | |
|---|---|
mid |
ID d'objet conforme au champ "mid" d'EntityAnnotation. |
language_code |
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 |
Nom d'objet, exprimé dans la langue correspondant au |
score |
Score du résultat. Plage [0, 1]. |
bounding_poly |
Zone de l'image à laquelle appartient cet objet. Doit être renseignée. |
LocationInfo
Informations sur l'emplacement de l'entité détectée.
| Champs | |
|---|---|
lat_lng |
Coordonnées de latitude et de longitude de l'emplacement. |
NormalizedVertex
Un sommet représente un point 2D dans l'image. REMARQUE : les coordonnées des sommets normalisés sont comparées aux valeurs de l'image d'origine, et sont comprises entre 0 et 1.
| Champs | |
|---|---|
x |
Coordonnées X. |
y |
Coordonnées Y. |
OperationMetadata
Contient des métadonnées pour l'opération BatchAnnotateImages.
| Champs | |
|---|---|
state |
État actuel de l'opération par lot. |
create_time |
Date/heure de réception de la requête par lot. |
update_time |
Date/heure de la dernière mise à jour du résultat de l'opération. |
State
État de l'opération par lot.
| Énumérations | |
|---|---|
STATE_UNSPECIFIED |
Non valide. |
CREATED |
Requête reçue. |
RUNNING |
La requête est en cours de traitement. |
DONE |
Le traitement par lot est terminé. |
CANCELLED |
Le traitement par lot a été annulé. |
OutputConfig
Emplacement de sortie et métadonnées souhaités.
| Champs | |
|---|---|
gcs_destination |
Emplacement Google Cloud Storage dans lequel écrire les résultats. |
batch_size |
Nombre maximal de fichiers .proto de réponse à placer dans chaque fichier JSON de résultat dans Google Cloud Storage. La plage valide est [1, 100]. Si aucune valeur n'est spécifiée, la valeur par défaut est 20. Par exemple, pour un fichier PDF de 100 pages, 100 fichiers .proto de réponse sont générés. Si le champ Actuellement, le champ "batch_size" ne s'applique qu'à GcsDestination. Il est possible qu'il soit prochainement compatible avec d'autres configurations de sortie. |
Page
Page détectée par l'OCR.
| Champs | |
|---|---|
property |
Informations supplémentaires détectées sur la page. |
width |
Largeur de la page. Pour les PDF, l'unité est le point. Pour les images (y compris au format TIFF), l'unité est exprimée en pixels. |
height |
Hauteur de la page. Pour les PDF, l'unité est le point. Pour les images (y compris au format TIFF), l'unité est exprimée en pixels. |
blocks[] |
Liste de blocs de texte, d'images, etc., sur la page. |
confidence |
Niveau de confiance des résultats de l'OCR sur la page. Plage [0, 1]. |
merged_text |
Ensemble du texte UTF-8 détecté sur cette page. Par défaut, ce champ n'est pas renvoyé, sauf indication contraire dans TextDetectionParams.page_filter. |
Paragraph
Unité structurelle de texte représentant un certain nombre de mots dans un ordre particulier.
| Champs | |
|---|---|
property |
Informations supplémentaires détectées pour le paragraphe. |
bounding_box |
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[] |
Liste des mots du paragraphe. |
confidence |
Niveau de confiance des résultats de l'OCR pour le paragraphe. Plage [0, 1]. |
merged_text |
Ensemble du texte UTF-8 détecté dans ce paragraphe. Par défaut, ce champ n'est pas renvoyé, sauf indication contraire dans TextDetectionParams.paragraph_filter. |
Poste
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.
| Champs | |
|---|---|
x |
Coordonnées X. |
y |
Coordonnées Y. |
z |
Coordonnées Z (ou profondeur). |
Product
Un Product contient des ReferenceImages.
| Champs | |
|---|---|
name |
Nom de ressource du produit. Format : Ce champ est ignoré lors de la création d'un produit. |
display_name |
Nom fourni par l'utilisateur pour le Product. Ce champ est obligatoire. Il ne doit pas dépasser 4 096 caractères. |
description |
Métadonnées fournies par l'utilisateur à stocker avec ce produit. Ne doit pas dépasser 4 096 caractères. |
product_category |
Catégorie du produit identifié par l'image de référence. La valeur doit être "homegoods", "apparel" ou "toys". Ce champ n'est pas modifiable. |
product_labels[] |
Paires clé-valeur pouvant être associées à un produit. Au moment de la requête, les contraintes peuvent être spécifiées en fonction du champ "product_labels". Notez que les valeurs entières peuvent être fournies sous forme de chaînes, par exemple "1199". Seules les chaînes comportant des valeurs entières peuvent correspondre à une restriction basée sur une plage (bientôt disponible). Plusieurs valeurs peuvent être attribuées à la même clé. Un produit peut contenir jusqu'à 100 champs "product_labels". |
KeyValue
Étiquette du produit représentée sous forme de paire clé-valeur.
| Champs | |
|---|---|
key |
Clé de l'étiquette associée au produit. Ce champ est obligatoire et ne peut pas dépasser 128 octets. |
value |
Valeur de l'étiquette associée au produit. Ce champ est obligatoire et ne peut pas dépasser 128 octets. |
ProductSearchParams
Paramètres pour une requête de recherche de produits.
| Champs | |
|---|---|
bounding_poly |
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. |
product_set |
Nom de ressource d'un Format : |
product_categories[] |
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 |
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". |
ProductSearchResults
Résultats d'une requête de recherche de produits.
| Champs | |
|---|---|
index_time |
Code temporel de l'index ayant fourni les résultats. Les modifications apportées après cette date ne sont pas reflétées dans les résultats actuels. |
results[] |
Liste des résultats, un pour chaque correspondance de produit. |
product_grouped_results[] |
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. |
GroupedResult
Informations sur des produits semblables à un seul produit dans une image de requête.
| Champs | |
|---|---|
bounding_poly |
Polygone de délimitation autour du produit détecté dans l'image de la requête. |
results[] |
Liste des résultats, un pour chaque correspondance de produit. |
object_annotations[] |
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é.
| Champs | |
|---|---|
mid |
ID d'objet conforme au champ "mid" d'EntityAnnotation. |
language_code |
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 |
Nom d'objet, exprimé dans la langue correspondant au |
score |
Score du résultat. Plage [0, 1]. |
Result
Informations sur un produit.
| Champs | |
|---|---|
product |
Le Product. |
score |
Niveau de confiance de la correspondance, compris entre 0 (aucune confiance) et 1 (confiance totale). |
image |
Nom de ressource de l'image à partir du produit qui correspond le mieux à la requête. |
ProductSet
Un ProductSet contient des Products. Il peut également inclure jusqu'à un million d'images de référence. Si la limite est dépassée, l'indexation périodique échoue.
| Champs | |
|---|---|
name |
Nom de ressource du ProductSet. Format : Ce champ est ignoré lors de la création d'un ProductSet. |
display_name |
Nom fourni par l'utilisateur pour le ProductSet. Ce champ est obligatoire. Il ne doit pas dépasser 4 096 caractères. |
index_time |
Uniquement en sortie. Heure de la dernière indexation de ce ProductSet. Les résultats de la requête reflètent toutes les mises à jour précédant cette date. Si le ProductSet n'a jamais été indexé, ce code temporel est la valeur par défaut "1970-01-01T00:00:00Z". Ce champ est ignoré lors de la création d'un ProductSet. |
index_error |
Uniquement en sortie. Si une erreur s'est produite lors de l'indexation de l'ensemble de produits, le champ est renseigné. Ce champ est ignoré lors de la création d'un ProductSet. |
Property
Une Property est constituée d'une paire nom/valeur fournie par l'utilisateur.
| Champs | |
|---|---|
name |
Nom de la propriété. |
value |
Valeur de la propriété. |
uint64_value |
Valeur des propriétés numériques. |
confidence |
Valeur comprise dans la plage [0..1]. Niveau de confiance de cette valeur de propriété. |
mid |
ID de valeur de propriété opaque. Certains identifiants sont disponibles dans l'API Google Knowledge Graph Search. Voici un exemple de propriété pour un blouson bleu : Property { name: 'color' value: 'blue' mid: '/m/01g5v' // For color blue } |
QualityOptimizationParams
Paramètres de l'optimisation de la qualité des images.
| Champs | |
|---|---|
type |
Choisissez un type d'optimisation. |
compression_config |
Spécifiez la configuration de compression. |
enhancement_config |
Spécifiez la configuration d'amélioration automatique. |
quality_score_config |
Spécifiez la configuration du niveau de qualité |
CompressionConfig
Configuration pour COMPRESSION.
| Champs | |
|---|---|
target_quality |
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 : enhancement_config { sharpening_level: 0.5 auto_hdr_level: 1.0 upscale_ratio: 1 }
| Champs | |
|---|---|
sharpening_level |
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. |
auto_hdr_level |
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. |
upscale_ratio |
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 upscale_ratio. |
QualityScoreConfig
Configuration de QUALITY_SCORE.
| Champs | |
|---|---|
quality_model |
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. |
Type
Énumération du type d'optimisation de la qualité.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
Non valide. Le client doit sélectionner un type. |
COMPRESSION |
Réduit la taille du fichier image. Les paramètres sont spécifiés dans le détail dans CompressionConfig. Si le client ne spécifie pas CompressionConfig, la taille du fichier image sera réduite, mais pas la qualité de l'image. Si le client spécifie CompressionConfig, nous réduisons la taille du fichier tout en conservant CompressionParams.target_quality. |
ENHANCEMENT |
Réduction du bruit, amélioration de la netteté, HDR et agrandissement. Les paramètres sont spécifiés dans le détail dans EnhancementConfig. Si le client ne spécifie pas EnhancmentConfig, l'amélioration des images sera effectuée avec les valeurs par défaut. Si upscale_ration n'est pas spécifié, l'image de sortie a la même résolution que l'image d'entrée. |
QUALITY_SCORE |
Le niveau de qualité d'une requête pour une image. Les paramètres sont spécifiés dans le détail dans QualityScoreConfig. Si le client ne spécifie pas de paramètres dans QualityScoreConfig, un score visuel de l'image est renvoyé. |
QualityOptimizationResult
Stocke les octets d'image améliorés.
| Champs | |
|---|---|
quality_optimization_type |
Type d'optimisation requis. |
image |
Octets d'images optimisées. |
mime_type |
Type MIME de l'image de sortie. |
ReferenceImage
Une ReferenceImage représente une image du produit et les métadonnées qui lui sont associées, telles que les cadres de délimitation.
| Champs | |
|---|---|
name |
Nom de ressource de l'image de référence. Format :
Ce champ est ignoré lors de la création d'une image de référence. |
uri |
URI Google Cloud Storage de l'image de référence. L'URI doit commencer par Obligatoire. |
bounding_polys[] |
Polygones de délimitation autour des zones d'intérêt de l'image de référence. Facultatif. Si ce champ est vide, le système tente de détecter les zones d'intérêt. Jusqu'à 10 polygones de délimitation sont utilisés. La forme fournie est convertie en rectangle non pivotant. Une fois la conversion effectuée, le côté le plus court du rectangle doit être supérieur ou égal à 300 pixels. Le format doit être égal ou inférieur à 1:4 (le format 1:3 est accepté, mais pas le format 1:5). |
RemoveProductFromProductSetRequest
Message de requête pour la méthode RemoveProductFromProductSet.
| Champs | |
|---|---|
name |
Nom de ressource du ProductSet à modifier. Format : |
product |
Nom de ressource du Product à supprimer de ce ProductSet. Format : |
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).
| Champs | |
|---|---|
adult |
Représente la probabilité que l'image comporte 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 |
Probabilité de spoofing. Probabilité qu'une modification ait été apportée à la version canonique de l'image pour la rendre amusante ou choquante. |
medical |
Probabilité de présence d'images médicales. |
violence |
Probabilité que l'image comprenne du contenu violent. |
racy |
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. |
Symbol
Représentation d'un seul symbole.
| Champs | |
|---|---|
property |
Informations supplémentaires détectées pour le symbole. |
bounding_box |
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 |
Représentation actuelle du symbole en UTF-8. |
confidence |
Niveau de confiance des résultats de l'OCR pour le symbole. Plage [0, 1]. |
Table
Représentation de la table semblable à la structure de table HTML.
| Champs | |
|---|---|
header_rows[] |
Lignes d'en-tête de la table |
body_rows[] |
Lignes de corps de la table |
TableCell
Représentation de la cellule dans les tables.
| Champs | |
|---|---|
row_span |
Nombre de lignes couvertes par la cellule. |
col_span |
Nombre de colonnes couvertes par la cellule. |
text_block |
Bloc de texte de cette cellule contenant le cadre de délimitation normalisé de la cellule et les structures plus profondes d'une cellule, le cas échéant. |
text |
Valeur textuelle fusionnée de cette cellule, en omettant les informations structurelles plus profondes, contrairement à |
TableRow
Ligne de cellules de la table.
| Champs | |
|---|---|
cells[] |
Cellules qui composent cette ligne. |
TableBoundHint
Suggestion de cadre de délimitation pour une table sur la page et l'analyse de cette table.
| Champs | |
|---|---|
page_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. |
bounding_box |
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. |
TableDetectionOptions
Options de détection de la table.
| Champs | |
|---|---|
table_bound_hints[] |
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. |
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.
| Champs | |
|---|---|
pages[] |
Liste des pages détectées par l'OCR. |
text |
Texte UTF-8 détecté sur les pages. |
DetectedBreak
Début ou fin d'un composant structurel détecté.
| Champs | |
|---|---|
type |
Type de saut détecté. |
is_prefix |
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. |
DetectedLanguage
Langue détectée d'un composant structurel.
| Champs | |
|---|---|
language_code |
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 |
Niveau de confiance concernant la langue détectée. Plage [0, 1]. |
TextProperty
Informations supplémentaires détectées dans le composant structurel.
| Champs | |
|---|---|
detected_languages[] |
Liste des langues détectées avec indice de confiance. |
detected_break |
Début ou fin d'un segment de texte détecté. |
TextDetectionParams
Paramètres des détections de texte. Permet de contrôler les fonctionnalités TEXT_DETECTION et DOCUMENT_TEXT_DETECTION.
| Champs | |
|---|---|
disable_orientation_detection |
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. |
disable_text_annotations |
Désactive l'ancien champ "text_annotations". Seules les annotations "full_text_annotations" seront renvoyées. |
page_filter |
Contrôle les données renvoyées au niveau de la page dans "full_text_annotation". Valeur par défaut en l'absence de réglage spécifique : tous les champs sont inclus. |
block_filter |
Contrôle les données renvoyées au niveau du bloc dans "full_text_annotation". Valeur par défaut en l'absence de réglage spécifique : tous les champs sont inclus, sauf |
paragraph_filter |
Contrôle les données renvoyées au niveau du paragraphe dans "full_text_annotation". Valeur par défaut en l'absence de réglage spécifique : tous les champs sont inclus, sauf |
word_filter |
Contrôle les données renvoyées au niveau du mot dans "full_text_annotation". Valeur par défaut en l'absence de réglage spécifique : tous les champs sont inclus, sauf |
symbol_filter |
Contrôle les données renvoyées au niveau du symbole dans "full_text_annotation". Valeur par défaut en l'absence de réglage spécifique : tous les champs sont inclus, sauf |
UpdateProductRequest
Message de requête pour la méthode UpdateProduct.
| Champs | |
|---|---|
product |
La ressource Product qui remplace celle du serveur. product.name ne peut pas être modifiée. |
update_mask |
Le |
UpdateProductSetRequest
Message de requête pour la méthode UpdateProductSet.
| Champs | |
|---|---|
product_set |
Ressource ProductSet qui remplace celle du serveur. |
update_mask |
Le |
Vertex
Un sommet représente un point 2D dans l'image. REMARQUE : les coordonnées du sommet sont à la même échelle que l'image d'origine.
| Champs | |
|---|---|
x |
Coordonnées X. |
y |
Coordonnées Y. |
WebDetection
Informations utiles sur une image provenant d'Internet.
| Champs | |
|---|---|
web_entities[] |
Entités issues d'images similaires sur Internet. |
full_matching_images[] |
Images identiques provenant d'Internet. Peut inclure des copies redimensionnées de l'image de la requête. |
partial_matching_images[] |
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. |
pages_with_matching_images[] |
Pages Web contenant les images correspondantes issues d'Internet. |
visually_similar_images[] |
Résultats d'images visuellement similaires. |
best_guess_labels[] |
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.
| Champs | |
|---|---|
entity_id |
ID d'entité opaque. |
score |
Score de pertinence global de l'entité. Non normalisé et non comparable entre différentes requêtes d'images. |
description |
Description canonique de l'entité en anglais. |
WebImage
Métadonnées des images en ligne.
| Champs | |
|---|---|
url |
URL de l'image du résultat. |
score |
(Obsolète) Score de pertinence global de l'image. |
WebLabel
Étiquette permettant de fournir des métadonnées supplémentaires pour la détection Web.
| Champs | |
|---|---|
label |
Étiquette pour les métadonnées supplémentaires. |
language_code |
Le code de langue BCP-47 pour |
WebPage
Métadonnées des pages Web.
| Champs | |
|---|---|
url |
URL de la page Web de résultat. |
score |
(Obsolète) Score de pertinence global de la page Web. |
page_title |
Le titre de la page Web peut contenir des balises HTML. |
full_matching_images[] |
Images identiques sur la page. Peut inclure des copies redimensionnées de l'image de la requête. |
partial_matching_images[] |
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. |
WebDetectionParams
Paramètres d'une requête de détection Web.
| Champs | |
|---|---|
include_geo_results |
Indique si les résultats provenant des informations géographiques de l'image doivent être inclus. |
Word
Représentation d'un mot.
| Champs | |
|---|---|
property |
Informations supplémentaires détectées pour le mot. |
bounding_box |
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[] |
Liste de symboles dans le mot. L'ordre des symboles suit l'ordre naturel de lecture. |
confidence |
Niveau de confiance des résultats de l'OCR pour le mot. Plage [0, 1]. |
merged_text |
Ensemble du texte UTF-8 détecté dans ce mot. Par défaut, ce champ n'est pas renvoyé, sauf indication contraire dans TextDetectionParams.word_filter. |