docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/vision_v1.projects.images.html b/docs/dyn/vision_v1.projects.images.html
index e9adf48..63f30c4 100644
--- a/docs/dyn/vision_v1.projects.images.html
+++ b/docs/dyn/vision_v1.projects.images.html
@@ -102,18 +102,6 @@
The object takes the form of:
{ # Multiple image annotation requests are batched into a single service call.
- "parent": "A String", # Optional. Target project and location to make a call.
- #
- # Format: `projects/{project-id}/locations/{location-id}`.
- #
- # If no parent is specified, a region will be chosen automatically.
- #
- # Supported location-ids:
- # `us`: USA country only,
- # `asia`: East asia areas, like Japan, Taiwan,
- # `eu`: The European Union.
- #
- # Example: `projects/project-A/locations/eu`.
"requests": [ # Required. Individual image annotation requests for this batch.
{ # Request for performing Google Cloud Vision API tasks over a user-provided
# image, with user-requested features, and with context information.
@@ -153,12 +141,12 @@
{ # The type of Google Cloud Vision API detection to perform, and the maximum
# number of results to return for that type. Multiple `Feature` objects can
# be specified in the `features` list.
- "model": "A String", # Model to use for the feature.
- # Supported values: "builtin/stable" (the default if unset) and
- # "builtin/latest".
"type": "A String", # The feature type.
"maxResults": 42, # Maximum number of results of this type. Does not apply to
# `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
+ "model": "A String", # Model to use for the feature.
+ # Supported values: "builtin/stable" (the default if unset) and
+ # "builtin/latest".
},
],
"imageContext": { # Image context and/or feature-specific parameters. # Additional context that may accompany the image.
@@ -204,15 +192,6 @@
],
},
"productSearchParams": { # Parameters for a product search request. # Parameters for product search.
- "productCategories": [ # The list of product categories to search in. Currently, we only consider
- # the first category, and either "homegoods-v2", "apparel-v2", "toys-v2",
- # "packagedgoods-v1", or "general-v1" should be specified. The legacy
- # categories "homegoods", "apparel", and "toys" are still supported but will
- # be deprecated. For new products, please use "homegoods-v2", "apparel-v2",
- # or "toys-v2" for better product search accuracy. It is recommended to
- # migrate existing products to these categories as well.
- "A String",
- ],
"filter": "A String", # The filtering expression. This can be used to restrict search results based
# on Product labels. We currently support an AND of OR of key-value
# expressions, where each expression within an OR must have the same key. An
@@ -238,15 +217,36 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
+ "productCategories": [ # The list of product categories to search in. Currently, we only consider
+ # the first category, and either "homegoods-v2", "apparel-v2", "toys-v2",
+ # "packagedgoods-v1", or "general-v1" should be specified. The legacy
+ # categories "homegoods", "apparel", and "toys" are still supported but will
+ # be deprecated. For new products, please use "homegoods-v2", "apparel-v2",
+ # or "toys-v2" for better product search accuracy. It is recommended to
+ # migrate existing products to these categories as well.
+ "A String",
+ ],
},
},
},
],
+ "parent": "A String", # Optional. Target project and location to make a call.
+ #
+ # Format: `projects/{project-id}/locations/{location-id}`.
+ #
+ # If no parent is specified, a region will be chosen automatically.
+ #
+ # Supported location-ids:
+ # `us`: USA country only,
+ # `asia`: East asia areas, like Japan, Taiwan,
+ # `eu`: The European Union.
+ #
+ # Example: `projects/project-A/locations/eu`.
}
x__xgafv: string, V1 error format.
@@ -260,8 +260,72 @@
{ # Response to a batch image annotation request.
"responses": [ # Individual responses to image annotation requests within the batch.
{ # Response to an image annotation request.
+ "landmarkAnnotations": [ # If present, landmark detection has completed successfully.
+ { # Set of detected entity features.
+ "score": 3.14, # Overall score of the result. Range [0, 1].
+ "locations": [ # The location information for the detected entity. Multiple
+ # `LocationInfo` elements can be present because one location may
+ # indicate the location of the scene in the image, and another location
+ # may indicate the location of the place where the image was taken.
+ # Location information is usually present for landmarks.
+ { # Detected entity location information.
+ "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # lat/long location coordinates.
+ # of doubles representing degrees latitude and degrees longitude. Unless
+ # specified otherwise, this must conform to the
+ # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
+ # standard</a>. Values must be within normalized ranges.
+ "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
+ "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
+ },
+ },
+ ],
+ "mid": "A String", # Opaque entity ID. Some IDs may be available in
+ # [Google Knowledge Graph Search
+ # API](https://developers.google.com/knowledge-graph/).
+ "confidence": 3.14, # **Deprecated. Use `score` instead.**
+ # The accuracy of the entity detection in an image.
+ # For example, for an image in which the "Eiffel Tower" entity is detected,
+ # this field represents the confidence that there is a tower in the query
+ # image. Range [0, 1].
+ "locale": "A String", # The language code for the locale in which the entity textual
+ # `description` is expressed.
+ "boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Not produced
+ # for `LABEL_DETECTION` features.
+ "normalizedVertices": [ # The bounding polygon normalized vertices.
+ { # A vertex represents a 2D point in the image.
+ # NOTE: the normalized vertex coordinates are relative to the original image
+ # and range from 0 to 1.
+ "y": 3.14, # Y coordinate.
+ "x": 3.14, # X coordinate.
+ },
+ ],
+ "vertices": [ # The bounding polygon vertices.
+ { # A vertex represents a 2D point in the image.
+ # NOTE: the vertex coordinates are in the same scale as the original image.
+ "x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
+ },
+ ],
+ },
+ "description": "A String", # Entity textual description, expressed in its `locale` language.
+ "topicality": 3.14, # The relevancy of the ICA (Image Content Annotation) label to the
+ # image. For example, the relevancy of "tower" is likely higher to an image
+ # containing the detected "Eiffel Tower" than to an image containing a
+ # detected distant towering building, even though the confidence that
+ # there is a tower in each image may be the same. Range [0, 1].
+ "properties": [ # Some entities may have optional user-supplied `Property` (name/value)
+ # fields, such a score or string that qualifies the entity.
+ { # A `Property` consists of a user-supplied name/value pair.
+ "value": "A String", # Value of the property.
+ "uint64Value": "A String", # Value of numeric properties.
+ "name": "A String", # Name of the property.
+ },
+ ],
+ },
+ ],
"faceAnnotations": [ # If present, face detection has completed successfully.
{ # A face annotation object contains the results of face detection.
+ "sorrowLikelihood": "A String", # Sorrow likelihood.
"tiltAngle": 3.14, # Pitch angle, which indicates the upwards/downwards angle that the face is
# pointing relative to the image's horizontal plane. Range [-180,180].
"fdBoundingPoly": { # A bounding polygon for the detected image annotation. # The `fd_bounding_poly` bounding polygon is tighter than the
@@ -281,14 +345,14 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
- "angerLikelihood": "A String", # Anger likelihood.
"landmarks": [ # Detected face landmarks.
{ # A face-specific landmark (for example, a face feature).
+ "type": "A String", # Face landmark type.
"position": { # A 3D position in the image, used primarily for Face detection landmarks. # Face landmark position.
# A valid Position must have both x and y coordinates.
# The position coordinates are in the same scale as the original image.
@@ -296,10 +360,10 @@
"x": 3.14, # X coordinate.
"z": 3.14, # Z coordinate (or depth).
},
- "type": "A String", # Face landmark type.
},
],
"surpriseLikelihood": "A String", # Surprise likelihood.
+ "angerLikelihood": "A String", # Anger likelihood.
"landmarkingConfidence": 3.14, # Face landmarking confidence. Range [0, 1].
"joyLikelihood": "A String", # Joy likelihood.
"underExposedLikelihood": "A String", # Under-exposed likelihood.
@@ -327,15 +391,14 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
"rollAngle": 3.14, # Roll angle, which indicates the amount of clockwise/anti-clockwise rotation
# of the face relative to the image vertical about the axis perpendicular to
# the face. Range [-180,180].
- "sorrowLikelihood": "A String", # Sorrow likelihood.
},
],
"cropHintsAnnotation": { # Set of crop hints that are used to generate new crops when serving images. # If present, crop hints have completed successfully.
@@ -357,8 +420,8 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
@@ -407,8 +470,8 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
@@ -429,9 +492,6 @@
},
],
"productSearchResults": { # Results for a product search request. # If present, product search has completed successfully.
- "indexTime": "A String", # Timestamp of the index which provided these results. Products added to the
- # product set and products removed from the product set after this time are
- # not reflected in the current results.
"productGroupedResults": [ # List of results grouped by products detected in the query image. Each entry
# corresponds to one bounding polygon in the query image, and contains the
# matching products specific to that region. There may be duplicate product
@@ -440,12 +500,12 @@
# image.
"objectAnnotations": [ # List of generic predictions for the object in the bounding box.
{ # Prediction for what the object in the bounding box is.
- "name": "A String", # Object name, expressed in its `language_code` language.
"score": 3.14, # Score of the result. Range [0, 1].
"languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
# information, see
# http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
"mid": "A String", # Object ID that should align with EntityAnnotation mid.
+ "name": "A String", # Object name, expressed in its `language_code` language.
},
],
"boundingPoly": { # A bounding polygon for the detected image annotation. # The bounding polygon around the product detected in the query image.
@@ -460,8 +520,8 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
@@ -555,10 +615,18 @@
# 1 (full confidence).
},
],
+ "indexTime": "A String", # Timestamp of the index which provided these results. Products added to the
+ # product set and products removed from the product set after this time are
+ # not reflected in the current results.
},
"localizedObjectAnnotations": [ # If present, localized object detection has completed successfully.
# This will be sorted descending by confidence score.
{ # Set of detected objects with bounding boxes.
+ "score": 3.14, # Score of the result. Range [0, 1].
+ "languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+ # information, see
+ # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+ "mid": "A String", # Object ID that should align with EntityAnnotation mid.
"name": "A String", # Object name, expressed in its `language_code` language.
"boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this object belongs. This must be populated.
"normalizedVertices": [ # The bounding polygon normalized vertices.
@@ -572,16 +640,11 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
- "score": 3.14, # Score of the result. Range [0, 1].
- "languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
- # information, see
- # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
- "mid": "A String", # Object ID that should align with EntityAnnotation mid.
},
],
"error": { # The `Status` type defines a logical error model that is suitable for # If set, represents the error message for the operation.
@@ -593,16 +656,16 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
},
"fullTextAnnotation": { # TextAnnotation contains a structured representation of OCR extracted text. # If present, text (OCR) detection or document (OCR) text detection has
# completed successfully.
@@ -616,25 +679,21 @@
# detail.
"pages": [ # List of pages detected by OCR.
{ # Detected page from OCR.
- "height": 42, # Page height. For PDFs the unit is points. For images (including
- # TIFFs) the unit is pixels.
- "width": 42, # Page width. For PDFs the unit is points. For images (including
- # TIFFs) the unit is pixels.
"blocks": [ # List of blocks of text, images etc on this page.
{ # Logical element on the page.
"property": { # Additional information detected on the structural component. # Additional information detected for the block.
- "detectedLanguages": [ # A list of detected languages together with confidence.
- { # Detected language for a structural component.
- "confidence": 3.14, # Confidence of detected language. Range [0, 1].
- "languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
- # information, see
- # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
- },
- ],
"detectedBreak": { # Detected start or end of a structural component. # Detected start or end of a text segment.
"type": "A String", # Detected break type.
"isPrefix": True or False, # True if break prepends the element.
},
+ "detectedLanguages": [ # A list of detected languages together with confidence.
+ { # Detected language for a structural component.
+ "languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+ # information, see
+ # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+ "confidence": 3.14, # Confidence of detected language. Range [0, 1].
+ },
+ ],
},
"blockType": "A String", # Detected block type (text, image etc) for this block.
"boundingBox": { # A bounding polygon for the detected image annotation. # The bounding box for the block.
@@ -668,8 +727,8 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
@@ -677,18 +736,18 @@
"paragraphs": [ # List of paragraphs in this block (if this blocks is of type text).
{ # Structural unit of text representing a number of words in certain order.
"property": { # Additional information detected on the structural component. # Additional information detected for the paragraph.
- "detectedLanguages": [ # A list of detected languages together with confidence.
- { # Detected language for a structural component.
- "confidence": 3.14, # Confidence of detected language. Range [0, 1].
- "languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
- # information, see
- # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
- },
- ],
"detectedBreak": { # Detected start or end of a structural component. # Detected start or end of a text segment.
"type": "A String", # Detected break type.
"isPrefix": True or False, # True if break prepends the element.
},
+ "detectedLanguages": [ # A list of detected languages together with confidence.
+ { # Detected language for a structural component.
+ "languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+ # information, see
+ # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+ "confidence": 3.14, # Confidence of detected language. Range [0, 1].
+ },
+ ],
},
"boundingBox": { # A bounding polygon for the detected image annotation. # The bounding box for the paragraph.
# The vertices are in the order of top-left, top-right, bottom-right,
@@ -716,8 +775,8 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
@@ -750,8 +809,8 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
@@ -759,6 +818,20 @@
"symbols": [ # List of symbols in the word.
# The order of the symbols follows the natural reading order.
{ # A single symbol representation.
+ "property": { # Additional information detected on the structural component. # Additional information detected for the symbol.
+ "detectedBreak": { # Detected start or end of a structural component. # Detected start or end of a text segment.
+ "type": "A String", # Detected break type.
+ "isPrefix": True or False, # True if break prepends the element.
+ },
+ "detectedLanguages": [ # A list of detected languages together with confidence.
+ { # Detected language for a structural component.
+ "languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+ # information, see
+ # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+ "confidence": 3.14, # Confidence of detected language. Range [0, 1].
+ },
+ ],
+ },
"boundingBox": { # A bounding polygon for the detected image annotation. # The bounding box for the symbol.
# The vertices are in the order of top-left, top-right, bottom-right,
# bottom-left. When a rotation of the bounding box is detected the rotation
@@ -785,42 +858,28 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
"confidence": 3.14, # Confidence of the OCR results for the symbol. Range [0, 1].
"text": "A String", # The actual UTF-8 representation of the symbol.
- "property": { # Additional information detected on the structural component. # Additional information detected for the symbol.
- "detectedLanguages": [ # A list of detected languages together with confidence.
- { # Detected language for a structural component.
- "confidence": 3.14, # Confidence of detected language. Range [0, 1].
- "languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
- # information, see
- # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
- },
- ],
- "detectedBreak": { # Detected start or end of a structural component. # Detected start or end of a text segment.
- "type": "A String", # Detected break type.
- "isPrefix": True or False, # True if break prepends the element.
- },
- },
},
],
"property": { # Additional information detected on the structural component. # Additional information detected for the word.
- "detectedLanguages": [ # A list of detected languages together with confidence.
- { # Detected language for a structural component.
- "confidence": 3.14, # Confidence of detected language. Range [0, 1].
- "languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
- # information, see
- # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
- },
- ],
"detectedBreak": { # Detected start or end of a structural component. # Detected start or end of a text segment.
"type": "A String", # Detected break type.
"isPrefix": True or False, # True if break prepends the element.
},
+ "detectedLanguages": [ # A list of detected languages together with confidence.
+ { # Detected language for a structural component.
+ "languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+ # information, see
+ # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+ "confidence": 3.14, # Confidence of detected language. Range [0, 1].
+ },
+ ],
},
},
],
@@ -829,20 +888,24 @@
},
],
"property": { # Additional information detected on the structural component. # Additional information detected on the page.
- "detectedLanguages": [ # A list of detected languages together with confidence.
- { # Detected language for a structural component.
- "confidence": 3.14, # Confidence of detected language. Range [0, 1].
- "languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
- # information, see
- # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
- },
- ],
"detectedBreak": { # Detected start or end of a structural component. # Detected start or end of a text segment.
"type": "A String", # Detected break type.
"isPrefix": True or False, # True if break prepends the element.
},
+ "detectedLanguages": [ # A list of detected languages together with confidence.
+ { # Detected language for a structural component.
+ "languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+ # information, see
+ # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+ "confidence": 3.14, # Confidence of detected language. Range [0, 1].
+ },
+ ],
},
"confidence": 3.14, # Confidence of the OCR results on the page. Range [0, 1].
+ "height": 42, # Page height. For PDFs the unit is points. For images (including
+ # TIFFs) the unit is pixels.
+ "width": 42, # Page width. For PDFs the unit is points. For images (including
+ # TIFFs) the unit is pixels.
},
],
"text": "A String", # UTF-8 text detected on the pages.
@@ -889,8 +952,8 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
@@ -915,6 +978,7 @@
"colors": [ # RGB color values with their score and pixel fraction.
{ # Color information consists of RGB channels, score, and the fraction of
# the image that the color occupies in the image.
+ "score": 3.14, # Image-specific score for this color. Value in range [0, 1].
"pixelFraction": 3.14, # The fraction of pixels the color occupies in the image.
# Value in range [0, 1].
"color": { # Represents a color in the RGBA color space. This representation is designed # RGB components of the color.
@@ -1051,7 +1115,6 @@
# If omitted, this color object is to be rendered as a solid color
# (as if the alpha value had been explicitly given with a value of 1.0).
},
- "score": 3.14, # Image-specific score for this color. Value in range [0, 1].
},
],
},
@@ -1098,8 +1161,8 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
@@ -1127,19 +1190,34 @@
# the file used to produce the image.
},
"webDetection": { # Relevant information for the image from the Internet. # If present, web detection has completed successfully.
+ "visuallySimilarImages": [ # The visually similar image results.
+ { # Metadata for online images.
+ "score": 3.14, # (Deprecated) Overall relevancy score for the image.
+ "url": "A String", # The result image URL.
+ },
+ ],
+ "bestGuessLabels": [ # The service's best guess as to the topic of the request image.
+ # Inferred from similar images on the open web.
+ { # Label to provide extra metadata for the web detection.
+ "label": "A String", # Label for extra metadata.
+ "languageCode": "A String", # The BCP-47 language code for `label`, such as "en-US" or "sr-Latn".
+ # For more information, see
+ # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+ },
+ ],
"fullMatchingImages": [ # Fully matching images from the Internet.
# Can include resized copies of the query image.
{ # Metadata for online images.
- "url": "A String", # The result image URL.
"score": 3.14, # (Deprecated) Overall relevancy score for the image.
+ "url": "A String", # The result image URL.
},
],
"webEntities": [ # Deduced entities from similar images on the Internet.
{ # Entity deduced from similar images on the Internet.
- "score": 3.14, # Overall relevancy score for the entity.
- # Not normalized and not comparable across different image queries.
"entityId": "A String", # Opaque entity ID.
"description": "A String", # Canonical description of the entity, in English.
+ "score": 3.14, # Overall relevancy score for the entity.
+ # Not normalized and not comparable across different image queries.
},
],
"pagesWithMatchingImages": [ # Web pages containing the matching images from the Internet.
@@ -1150,8 +1228,8 @@
# example an original image will likely have partial matching for its
# crops.
{ # Metadata for online images.
- "url": "A String", # The result image URL.
"score": 3.14, # (Deprecated) Overall relevancy score for the image.
+ "url": "A String", # The result image URL.
},
],
"url": "A String", # The result web page URL.
@@ -1159,8 +1237,8 @@
"fullMatchingImages": [ # Fully matching images on the page.
# Can include resized copies of the query image.
{ # Metadata for online images.
- "url": "A String", # The result image URL.
"score": 3.14, # (Deprecated) Overall relevancy score for the image.
+ "url": "A String", # The result image URL.
},
],
},
@@ -1169,23 +1247,8 @@
# Those images are similar enough to share some key-point features. For
# example an original image will likely have partial matching for its crops.
{ # Metadata for online images.
- "url": "A String", # The result image URL.
"score": 3.14, # (Deprecated) Overall relevancy score for the image.
- },
- ],
- "visuallySimilarImages": [ # The visually similar image results.
- { # Metadata for online images.
"url": "A String", # The result image URL.
- "score": 3.14, # (Deprecated) Overall relevancy score for the image.
- },
- ],
- "bestGuessLabels": [ # The service's best guess as to the topic of the request image.
- # Inferred from similar images on the open web.
- { # Label to provide extra metadata for the web detection.
- "label": "A String", # Label for extra metadata.
- "languageCode": "A String", # The BCP-47 language code for `label`, such as "en-US" or "sr-Latn".
- # For more information, see
- # http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
},
],
},
@@ -1205,69 +1268,6 @@
# body areas.
"violence": "A String", # Likelihood that this image contains violent content.
},
- "landmarkAnnotations": [ # If present, landmark detection has completed successfully.
- { # Set of detected entity features.
- "score": 3.14, # Overall score of the result. Range [0, 1].
- "locations": [ # The location information for the detected entity. Multiple
- # `LocationInfo` elements can be present because one location may
- # indicate the location of the scene in the image, and another location
- # may indicate the location of the place where the image was taken.
- # Location information is usually present for landmarks.
- { # Detected entity location information.
- "latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # lat/long location coordinates.
- # of doubles representing degrees latitude and degrees longitude. Unless
- # specified otherwise, this must conform to the
- # <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
- # standard</a>. Values must be within normalized ranges.
- "latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].
- "longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].
- },
- },
- ],
- "mid": "A String", # Opaque entity ID. Some IDs may be available in
- # [Google Knowledge Graph Search
- # API](https://developers.google.com/knowledge-graph/).
- "confidence": 3.14, # **Deprecated. Use `score` instead.**
- # The accuracy of the entity detection in an image.
- # For example, for an image in which the "Eiffel Tower" entity is detected,
- # this field represents the confidence that there is a tower in the query
- # image. Range [0, 1].
- "locale": "A String", # The language code for the locale in which the entity textual
- # `description` is expressed.
- "boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Not produced
- # for `LABEL_DETECTION` features.
- "normalizedVertices": [ # The bounding polygon normalized vertices.
- { # A vertex represents a 2D point in the image.
- # NOTE: the normalized vertex coordinates are relative to the original image
- # and range from 0 to 1.
- "y": 3.14, # Y coordinate.
- "x": 3.14, # X coordinate.
- },
- ],
- "vertices": [ # The bounding polygon vertices.
- { # A vertex represents a 2D point in the image.
- # NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
- "x": 42, # X coordinate.
- },
- ],
- },
- "description": "A String", # Entity textual description, expressed in its `locale` language.
- "topicality": 3.14, # The relevancy of the ICA (Image Content Annotation) label to the
- # image. For example, the relevancy of "tower" is likely higher to an image
- # containing the detected "Eiffel Tower" than to an image containing a
- # detected distant towering building, even though the confidence that
- # there is a tower in each image may be the same. Range [0, 1].
- "properties": [ # Some entities may have optional user-supplied `Property` (name/value)
- # fields, such a score or string that qualifies the entity.
- { # A `Property` consists of a user-supplied name/value pair.
- "value": "A String", # Value of the property.
- "uint64Value": "A String", # Value of numeric properties.
- "name": "A String", # Name of the property.
- },
- ],
- },
- ],
},
],
}</pre>
@@ -1302,55 +1302,6 @@
The object takes the form of:
{ # Request for async image annotation for a list of images.
- "parent": "A String", # Optional. Target project and location to make a call.
- #
- # Format: `projects/{project-id}/locations/{location-id}`.
- #
- # If no parent is specified, a region will be chosen automatically.
- #
- # Supported location-ids:
- # `us`: USA country only,
- # `asia`: East asia areas, like Japan, Taiwan,
- # `eu`: The European Union.
- #
- # Example: `projects/project-A/locations/eu`.
- "outputConfig": { # The desired output location and metadata. # Required. The desired output location and metadata (e.g. format).
- "gcsDestination": { # The Google Cloud Storage location where the output will be written to. # The Google Cloud Storage location to write the output(s) to.
- "uri": "A String", # Google Cloud Storage URI prefix where the results will be stored. Results
- # will be in JSON format and preceded by its corresponding input URI prefix.
- # This field can either represent a gcs file prefix or gcs directory. In
- # either case, the uri should be unique because in order to get all of the
- # output files, you will need to do a wildcard gcs search on the uri prefix
- # you provide.
- #
- # Examples:
- #
- # * File Prefix: gs://bucket-name/here/filenameprefix The output files
- # will be created in gs://bucket-name/here/ and the names of the
- # output files will begin with "filenameprefix".
- #
- # * Directory Prefix: gs://bucket-name/some/location/ The output files
- # will be created in gs://bucket-name/some/location/ and the names of the
- # output files could be anything because there was no filename prefix
- # specified.
- #
- # If multiple outputs, each response is still AnnotateFileResponse, each of
- # which contains some subset of the full list of AnnotateImageResponse.
- # Multiple outputs can happen if, for example, the output JSON is too large
- # and overflows into multiple sharded files.
- },
- "batchSize": 42, # The max number of response protos to put into each output JSON file on
- # Google Cloud Storage.
- # The valid range is [1, 100]. If not specified, the default value is 20.
- #
- # For example, for one pdf file with 100 pages, 100 response protos will
- # be generated. If `batch_size` = 20, then 5 json files each
- # containing 20 response protos will be written under the prefix
- # `gcs_destination`.`uri`.
- #
- # Currently, batch_size only applies to GcsDestination, with potential future
- # support for other output configurations.
- },
"requests": [ # Required. Individual image annotation requests for this batch.
{ # Request for performing Google Cloud Vision API tasks over a user-provided
# image, with user-requested features, and with context information.
@@ -1390,12 +1341,12 @@
{ # The type of Google Cloud Vision API detection to perform, and the maximum
# number of results to return for that type. Multiple `Feature` objects can
# be specified in the `features` list.
- "model": "A String", # Model to use for the feature.
- # Supported values: "builtin/stable" (the default if unset) and
- # "builtin/latest".
"type": "A String", # The feature type.
"maxResults": 42, # Maximum number of results of this type. Does not apply to
# `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.
+ "model": "A String", # Model to use for the feature.
+ # Supported values: "builtin/stable" (the default if unset) and
+ # "builtin/latest".
},
],
"imageContext": { # Image context and/or feature-specific parameters. # Additional context that may accompany the image.
@@ -1441,15 +1392,6 @@
],
},
"productSearchParams": { # Parameters for a product search request. # Parameters for product search.
- "productCategories": [ # The list of product categories to search in. Currently, we only consider
- # the first category, and either "homegoods-v2", "apparel-v2", "toys-v2",
- # "packagedgoods-v1", or "general-v1" should be specified. The legacy
- # categories "homegoods", "apparel", and "toys" are still supported but will
- # be deprecated. For new products, please use "homegoods-v2", "apparel-v2",
- # or "toys-v2" for better product search accuracy. It is recommended to
- # migrate existing products to these categories as well.
- "A String",
- ],
"filter": "A String", # The filtering expression. This can be used to restrict search results based
# on Product labels. We currently support an AND of OR of key-value
# expressions, where each expression within an OR must have the same key. An
@@ -1475,15 +1417,73 @@
"vertices": [ # The bounding polygon vertices.
{ # A vertex represents a 2D point in the image.
# NOTE: the vertex coordinates are in the same scale as the original image.
- "y": 42, # Y coordinate.
"x": 42, # X coordinate.
+ "y": 42, # Y coordinate.
},
],
},
+ "productCategories": [ # The list of product categories to search in. Currently, we only consider
+ # the first category, and either "homegoods-v2", "apparel-v2", "toys-v2",
+ # "packagedgoods-v1", or "general-v1" should be specified. The legacy
+ # categories "homegoods", "apparel", and "toys" are still supported but will
+ # be deprecated. For new products, please use "homegoods-v2", "apparel-v2",
+ # or "toys-v2" for better product search accuracy. It is recommended to
+ # migrate existing products to these categories as well.
+ "A String",
+ ],
},
},
},
],
+ "parent": "A String", # Optional. Target project and location to make a call.
+ #
+ # Format: `projects/{project-id}/locations/{location-id}`.
+ #
+ # If no parent is specified, a region will be chosen automatically.
+ #
+ # Supported location-ids:
+ # `us`: USA country only,
+ # `asia`: East asia areas, like Japan, Taiwan,
+ # `eu`: The European Union.
+ #
+ # Example: `projects/project-A/locations/eu`.
+ "outputConfig": { # The desired output location and metadata. # Required. The desired output location and metadata (e.g. format).
+ "batchSize": 42, # The max number of response protos to put into each output JSON file on
+ # Google Cloud Storage.
+ # The valid range is [1, 100]. If not specified, the default value is 20.
+ #
+ # For example, for one pdf file with 100 pages, 100 response protos will
+ # be generated. If `batch_size` = 20, then 5 json files each
+ # containing 20 response protos will be written under the prefix
+ # `gcs_destination`.`uri`.
+ #
+ # Currently, batch_size only applies to GcsDestination, with potential future
+ # support for other output configurations.
+ "gcsDestination": { # The Google Cloud Storage location where the output will be written to. # The Google Cloud Storage location to write the output(s) to.
+ "uri": "A String", # Google Cloud Storage URI prefix where the results will be stored. Results
+ # will be in JSON format and preceded by its corresponding input URI prefix.
+ # This field can either represent a gcs file prefix or gcs directory. In
+ # either case, the uri should be unique because in order to get all of the
+ # output files, you will need to do a wildcard gcs search on the uri prefix
+ # you provide.
+ #
+ # Examples:
+ #
+ # * File Prefix: gs://bucket-name/here/filenameprefix The output files
+ # will be created in gs://bucket-name/here/ and the names of the
+ # output files will begin with "filenameprefix".
+ #
+ # * Directory Prefix: gs://bucket-name/some/location/ The output files
+ # will be created in gs://bucket-name/some/location/ and the names of the
+ # output files could be anything because there was no filename prefix
+ # specified.
+ #
+ # If multiple outputs, each response is still AnnotateFileResponse, each of
+ # which contains some subset of the full list of AnnotateImageResponse.
+ # Multiple outputs can happen if, for example, the output JSON is too large
+ # and overflows into multiple sharded files.
+ },
+ },
}
x__xgafv: string, V1 error format.
@@ -1519,16 +1519,16 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
},
"metadata": { # Service-specific metadata associated with the operation. It typically
# contains progress information and common metadata such as create time.