Index: discovery/googleapis/vision__v1.json |
diff --git a/discovery/googleapis/vision__v1.json b/discovery/googleapis/vision__v1.json |
index 869cffbabe53541c7ad5211c56ecee246124f61f..3b8e38dfee34c149b295a99141cf4c988b274de5 100644 |
--- a/discovery/googleapis/vision__v1.json |
+++ b/discovery/googleapis/vision__v1.json |
@@ -11,6 +11,7 @@ |
"basePath": "", |
"baseUrl": "https://vision.googleapis.com/", |
"batchPath": "batch", |
+ "canonicalName": "Vision", |
"description": "Integrates Google Vision features, including image labeling, face, logo, and landmark detection, optical character recognition (OCR), and detection of explicit content, into applications.", |
"discoveryVersion": "v1", |
"documentationLink": "https://cloud.google.com/vision/", |
@@ -135,7 +136,7 @@ |
} |
} |
}, |
- "revision": "20161031", |
+ "revision": "20161128", |
"rootUrl": "https://vision.googleapis.com/", |
"schemas": { |
"ImageSource": { |
@@ -143,7 +144,7 @@ |
"id": "ImageSource", |
"properties": { |
"gcsImageUri": { |
- "description": "Google Cloud Storage image URI. It must be in the following form:\n`gs://bucket_name/object_name`. For more\ndetails, please see: https://cloud.google.com/storage/docs/reference-uris.\nNOTE: Cloud Storage object versioning is not supported!", |
+ "description": "Google Cloud Storage image URI, which must be in the following form:\n`gs://bucket_name/object_name` (for details, see\n[Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris)).\nNOTE: Cloud Storage object versioning is not supported.", |
"type": "string" |
} |
}, |
@@ -176,14 +177,14 @@ |
"id": "AnnotateImageResponse", |
"properties": { |
"labelAnnotations": { |
- "description": "If present, label detection completed successfully.", |
+ "description": "If present, label detection has completed successfully.", |
"items": { |
"$ref": "EntityAnnotation" |
}, |
"type": "array" |
}, |
"landmarkAnnotations": { |
- "description": "If present, landmark detection completed successfully.", |
+ "description": "If present, landmark detection has completed successfully.", |
"items": { |
"$ref": "EntityAnnotation" |
}, |
@@ -191,28 +192,28 @@ |
}, |
"safeSearchAnnotation": { |
"$ref": "SafeSearchAnnotation", |
- "description": "If present, safe-search annotation completed successfully." |
+ "description": "If present, safe-search annotation has completed successfully." |
}, |
"imagePropertiesAnnotation": { |
"$ref": "ImageProperties", |
"description": "If present, image properties were extracted successfully." |
}, |
"textAnnotations": { |
- "description": "If present, text (OCR) detection completed successfully.", |
+ "description": "If present, text (OCR) detection has completed successfully.", |
"items": { |
"$ref": "EntityAnnotation" |
}, |
"type": "array" |
}, |
"logoAnnotations": { |
- "description": "If present, logo detection completed successfully.", |
+ "description": "If present, logo detection has completed successfully.", |
"items": { |
"$ref": "EntityAnnotation" |
}, |
"type": "array" |
}, |
"faceAnnotations": { |
- "description": "If present, face detection completed successfully.", |
+ "description": "If present, face detection has completed successfully.", |
"items": { |
"$ref": "FaceAnnotation" |
}, |
@@ -220,13 +221,13 @@ |
}, |
"error": { |
"$ref": "Status", |
- "description": "If set, represents the error message for the operation.\nNote that filled-in mage annotations are guaranteed to be\ncorrect, even when <code>error</code> is non-empty." |
+ "description": "If set, represents the error message for the operation.\nNote that filled-in image annotations are guaranteed to be\ncorrect, even when `error` is set." |
} |
}, |
"type": "object" |
}, |
"LatLongRect": { |
- "description": "Rectangle determined by min and max LatLng pairs.", |
+ "description": "Rectangle determined by min and max `LatLng` pairs.", |
"id": "LatLongRect", |
"properties": { |
"maxLatLng": { |
@@ -272,7 +273,7 @@ |
"id": "FaceAnnotation", |
"properties": { |
"tiltAngle": { |
- "description": "Pitch angle. Indicates the upwards/downwards angle that the face is\npointing\nrelative to the image's horizontal plane. Range [-180,180].", |
+ "description": "Pitch angle, which indicates the upwards/downwards angle that the face is\npointing relative to the image's horizontal plane. Range [-180,180].", |
"format": "float", |
"type": "number" |
}, |
@@ -288,17 +289,17 @@ |
], |
"enumDescriptions": [ |
"Unknown likelihood.", |
- "The image very unlikely belongs to the vertical specified.", |
- "The image unlikely belongs to the vertical specified.", |
- "The image possibly belongs to the vertical specified.", |
- "The image likely belongs to the vertical specified.", |
- "The image very likely belongs to the vertical specified." |
+ "It is very unlikely that the image belongs to the specified vertical.", |
+ "It is unlikely that the image belongs to the specified vertical.", |
+ "It is possible that the image belongs to the specified vertical.", |
+ "It is likely that the image belongs to the specified vertical.", |
+ "It is very likely that the image belongs to the specified vertical." |
], |
"type": "string" |
}, |
"fdBoundingPoly": { |
"$ref": "BoundingPoly", |
- "description": "This bounding polygon is tighter than the previous\n<code>boundingPoly</code>, and\nencloses only the skin part of the face. Typically, it is used to\neliminate the face from any image analysis that detects the\n\"amount of skin\" visible in an image. It is not based on the\nlandmarker results, only on the initial face detection, hence\nthe <code>fd</code> (face detection) prefix." |
+ "description": "The `fd_bounding_poly` bounding polygon is tighter than the\n`boundingPoly`, and encloses only the skin part of the face. Typically, it\nis used to eliminate the face from any image analysis that detects the\n\"amount of skin\" visible in an image. It is not based on the\nlandmarker results, only on the initial face detection, hence\nthe <code>fd</code> (face detection) prefix." |
}, |
"landmarkingConfidence": { |
"description": "Face landmarking confidence. Range [0, 1].", |
@@ -317,11 +318,11 @@ |
], |
"enumDescriptions": [ |
"Unknown likelihood.", |
- "The image very unlikely belongs to the vertical specified.", |
- "The image unlikely belongs to the vertical specified.", |
- "The image possibly belongs to the vertical specified.", |
- "The image likely belongs to the vertical specified.", |
- "The image very likely belongs to the vertical specified." |
+ "It is very unlikely that the image belongs to the specified vertical.", |
+ "It is unlikely that the image belongs to the specified vertical.", |
+ "It is possible that the image belongs to the specified vertical.", |
+ "It is likely that the image belongs to the specified vertical.", |
+ "It is very likely that the image belongs to the specified vertical." |
], |
"type": "string" |
}, |
@@ -342,11 +343,11 @@ |
], |
"enumDescriptions": [ |
"Unknown likelihood.", |
- "The image very unlikely belongs to the vertical specified.", |
- "The image unlikely belongs to the vertical specified.", |
- "The image possibly belongs to the vertical specified.", |
- "The image likely belongs to the vertical specified.", |
- "The image very likely belongs to the vertical specified." |
+ "It is very unlikely that the image belongs to the specified vertical.", |
+ "It is unlikely that the image belongs to the specified vertical.", |
+ "It is possible that the image belongs to the specified vertical.", |
+ "It is likely that the image belongs to the specified vertical.", |
+ "It is very likely that the image belongs to the specified vertical." |
], |
"type": "string" |
}, |
@@ -362,11 +363,11 @@ |
], |
"enumDescriptions": [ |
"Unknown likelihood.", |
- "The image very unlikely belongs to the vertical specified.", |
- "The image unlikely belongs to the vertical specified.", |
- "The image possibly belongs to the vertical specified.", |
- "The image likely belongs to the vertical specified.", |
- "The image very likely belongs to the vertical specified." |
+ "It is very unlikely that the image belongs to the specified vertical.", |
+ "It is unlikely that the image belongs to the specified vertical.", |
+ "It is possible that the image belongs to the specified vertical.", |
+ "It is likely that the image belongs to the specified vertical.", |
+ "It is very likely that the image belongs to the specified vertical." |
], |
"type": "string" |
}, |
@@ -382,22 +383,22 @@ |
], |
"enumDescriptions": [ |
"Unknown likelihood.", |
- "The image very unlikely belongs to the vertical specified.", |
- "The image unlikely belongs to the vertical specified.", |
- "The image possibly belongs to the vertical specified.", |
- "The image likely belongs to the vertical specified.", |
- "The image very likely belongs to the vertical specified." |
+ "It is very unlikely that the image belongs to the specified vertical.", |
+ "It is unlikely that the image belongs to the specified vertical.", |
+ "It is possible that the image belongs to the specified vertical.", |
+ "It is likely that the image belongs to the specified vertical.", |
+ "It is very likely that the image belongs to the specified vertical." |
], |
"type": "string" |
}, |
"panAngle": { |
- "description": "Yaw angle. Indicates the leftward/rightward angle that the face is\npointing, relative to the vertical plane perpendicular to the image. Range\n[-180,180].", |
+ "description": "Yaw angle, which indicates the leftward/rightward angle that the face is\npointing relative to the vertical plane perpendicular to the image. Range\n[-180,180].", |
"format": "float", |
"type": "number" |
}, |
"boundingPoly": { |
"$ref": "BoundingPoly", |
- "description": "The bounding polygon around the face. The coordinates of the bounding box\nare in the original image's scale, as returned in ImageParams.\nThe bounding box is computed to \"frame\" the face in accordance with human\nexpectations. It is based on the landmarker results.\nNote that one or more x and/or y coordinates may not be generated in the\nBoundingPoly (the polygon will be unbounded) if only a partial face appears in\nthe image to be annotated." |
+ "description": "The bounding polygon around the face. The coordinates of the bounding box\nare in the original image's scale, as returned in `ImageParams`.\nThe bounding box is computed to \"frame\" the face in accordance with human\nexpectations. It is based on the landmarker results.\nNote that one or more x and/or y coordinates may not be generated in the\n`BoundingPoly` (the polygon will be unbounded) if only a partial face\nappears in the image to be annotated." |
}, |
"landmarks": { |
"description": "Detected face landmarks.", |
@@ -418,16 +419,16 @@ |
], |
"enumDescriptions": [ |
"Unknown likelihood.", |
- "The image very unlikely belongs to the vertical specified.", |
- "The image unlikely belongs to the vertical specified.", |
- "The image possibly belongs to the vertical specified.", |
- "The image likely belongs to the vertical specified.", |
- "The image very likely belongs to the vertical specified." |
+ "It is very unlikely that the image belongs to the specified vertical.", |
+ "It is unlikely that the image belongs to the specified vertical.", |
+ "It is possible that the image belongs to the specified vertical.", |
+ "It is likely that the image belongs to the specified vertical.", |
+ "It is very likely that the image belongs to the specified vertical." |
], |
"type": "string" |
}, |
"rollAngle": { |
- "description": "Roll angle. Indicates the amount of clockwise/anti-clockwise rotation of\nthe\nface relative to the image vertical, about the axis perpendicular to the\nface. Range [-180,180].", |
+ "description": "Roll angle, which indicates the amount of clockwise/anti-clockwise rotation\nof the face relative to the image vertical about the axis perpendicular to\nthe face. Range [-180,180].", |
"format": "float", |
"type": "number" |
}, |
@@ -443,11 +444,11 @@ |
], |
"enumDescriptions": [ |
"Unknown likelihood.", |
- "The image very unlikely belongs to the vertical specified.", |
- "The image unlikely belongs to the vertical specified.", |
- "The image possibly belongs to the vertical specified.", |
- "The image likely belongs to the vertical specified.", |
- "The image very likely belongs to the vertical specified." |
+ "It is very unlikely that the image belongs to the specified vertical.", |
+ "It is unlikely that the image belongs to the specified vertical.", |
+ "It is possible that the image belongs to the specified vertical.", |
+ "It is likely that the image belongs to the specified vertical.", |
+ "It is very likely that the image belongs to the specified vertical." |
], |
"type": "string" |
} |
@@ -472,11 +473,11 @@ |
"type": "object" |
}, |
"ColorInfo": { |
- "description": "Color information consists of RGB channels, score and fraction of\nimage the color occupies in the image.", |
+ "description": "Color information consists of RGB channels, score, and the fraction of\nthe image that the color occupies in the image.", |
"id": "ColorInfo", |
"properties": { |
"pixelFraction": { |
- "description": "Stores the fraction of pixels the color occupies in the image.\nValue in range [0, 1].", |
+ "description": "The fraction of pixels the color occupies in the image.\nValue in range [0, 1].", |
"format": "float", |
"type": "number" |
}, |
@@ -507,7 +508,7 @@ |
"type": "object" |
}, |
"Landmark": { |
- "description": "A face-specific landmark (for example, a face feature).\nLandmark positions may fall outside the bounds of the image\nwhen the face is near one or more edges of the image.\nTherefore it is NOT guaranteed that 0 <= x < width or 0 <= y < height.", |
+ "description": "A face-specific landmark (for example, a face feature).\nLandmark positions may fall outside the bounds of the image\nif the face is near one or more edges of the image.\nTherefore it is NOT guaranteed that `0 <= x < width` or\n`0 <= y < height`.", |
"id": "Landmark", |
"properties": { |
"position": { |
@@ -601,10 +602,10 @@ |
"properties": { |
"latLongRect": { |
"$ref": "LatLongRect", |
- "description": "Lat/long rectangle that specifies the location of the image." |
+ "description": "lat/long rectangle that specifies the location of the image." |
}, |
"languageHints": { |
- "description": "List of languages to use for TEXT_DETECTION. In most cases, an empty value\nyields the best results since it enables automatic language detection. For\nlanguages based on the Latin alphabet, setting `language_hints` is not\nneeded. In rare cases, when the language of the text in the image is known,\nsetting a hint will help get better results (although it will be a\nsignificant hindrance if the hint is wrong). Text detection returns an\nerror if one or more of the specified languages is not one of the\n[supported\nlanguages](/translate/v2/translate-reference#supported_languages).", |
+ "description": "List of languages to use for TEXT_DETECTION. In most cases, an empty value\nyields the best results since it enables automatic language detection. For\nlanguages based on the Latin alphabet, setting `language_hints` is not\nneeded. In rare cases, when the language of the text in the image is known,\nsetting a hint will help get better results (although it will be a\nsignificant hindrance if the hint is wrong). Text detection returns an\nerror if one or more of the specified languages is not one of the\n[supported languages](/vision/docs/languages).", |
"items": { |
"type": "string" |
}, |
@@ -632,24 +633,24 @@ |
"id": "EntityAnnotation", |
"properties": { |
"mid": { |
- "description": "Opaque entity ID. Some IDs might be available in Knowledge Graph(KG).\nFor more details on KG please see:\nhttps://developers.google.com/knowledge-graph/", |
+ "description": "Opaque entity ID. Some IDs may be available in\n[Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph/).", |
"type": "string" |
}, |
"description": { |
- "description": "Entity textual description, expressed in its <code>locale</code> language.", |
+ "description": "Entity textual description, expressed in its `locale` language.", |
"type": "string" |
}, |
"topicality": { |
- "description": "The relevancy of the ICA (Image Content Annotation) label to the\nimage. For example, the relevancy of 'tower' to an image containing\n'Eiffel Tower' is likely higher than an image containing a distant towering\nbuilding, though the confidence that there is a tower may be the same.\nRange [0, 1].", |
+ "description": "The relevancy of the ICA (Image Content Annotation) label to the\nimage. For example, the relevancy of \"tower\" is likely higher to an image\ncontaining the detected \"Eiffel Tower\" than to an image containing a\ndetected distant towering building, even though the confidence that\nthere is a tower in each image may be the same. Range [0, 1].", |
"format": "float", |
"type": "number" |
}, |
"locale": { |
- "description": "The language code for the locale in which the entity textual\n<code>description</code> (next field) is expressed.", |
+ "description": "The language code for the locale in which the entity textual\n`description` is expressed.", |
"type": "string" |
}, |
"properties": { |
- "description": "Some entities can have additional optional <code>Property</code> fields.\nFor example a different kind of score or string that qualifies the entity.", |
+ "description": "Some entities may have optional user-supplied `Property` (name/value)\nfields, such a score or string that qualifies the entity.", |
"items": { |
"$ref": "Property" |
}, |
@@ -662,17 +663,17 @@ |
}, |
"boundingPoly": { |
"$ref": "BoundingPoly", |
- "description": "Image region to which this entity belongs. Not filled currently\nfor `LABEL_DETECTION` features. For `TEXT_DETECTION` (OCR), `boundingPoly`s\nare produced for the entire text detected in an image region, followed by\n`boundingPoly`s for each word within the detected text." |
+ "description": "Image region to which this entity belongs. Currently not produced\nfor `LABEL_DETECTION` features. For `TEXT_DETECTION` (OCR), `boundingPoly`s\nare produced for the entire text detected in an image region, followed by\n`boundingPoly`s for each word within the detected text." |
}, |
"locations": { |
- "description": "The location information for the detected entity. Multiple\n<code>LocationInfo</code> elements can be present since one location may\nindicate the location of the scene in the query image, and another the\nlocation of the place where the query image was taken. Location information\nis usually present for landmarks.", |
+ "description": "The location information for the detected entity. Multiple\n`LocationInfo` elements can be present because one location may\nindicate the location of the scene in the image, and another location\nmay indicate the location of the place where the image was taken.\nLocation information is usually present for landmarks.", |
"items": { |
"$ref": "LocationInfo" |
}, |
"type": "array" |
}, |
"confidence": { |
- "description": "The accuracy of the entity detection in an image.\nFor example, for an image containing 'Eiffel Tower,' this field represents\nthe confidence that there is a tower in the query image. Range [0, 1].", |
+ "description": "The accuracy of the entity detection in an image.\nFor example, for an image in which the \"Eiffel Tower\" entity is detected,\nthis field represents the confidence that there is a tower in the query\nimage. Range [0, 1].", |
"format": "float", |
"type": "number" |
} |
@@ -680,7 +681,7 @@ |
"type": "object" |
}, |
"Property": { |
- "description": "Arbitrary name/value pair.", |
+ "description": "A `Property` consists of a user-supplied name/value pair.", |
"id": "Property", |
"properties": { |
"value": { |
@@ -727,17 +728,16 @@ |
"properties": { |
"latLng": { |
"$ref": "LatLng", |
- "description": "Lat - long location coordinates." |
+ "description": "lat/long location coordinates." |
} |
}, |
"type": "object" |
}, |
"SafeSearchAnnotation": { |
- "description": "Set of features pertaining to the image, computed by various computer vision\nmethods over safe-search verticals (for example, adult, spoof, medical,\nviolence).", |
"id": "SafeSearchAnnotation", |
"properties": { |
"medical": { |
- "description": "Likelihood this is a medical image.", |
+ "description": "Likelihood that this is a medical image.", |
"enum": [ |
"UNKNOWN", |
"VERY_UNLIKELY", |
@@ -748,16 +748,16 @@ |
], |
"enumDescriptions": [ |
"Unknown likelihood.", |
- "The image very unlikely belongs to the vertical specified.", |
- "The image unlikely belongs to the vertical specified.", |
- "The image possibly belongs to the vertical specified.", |
- "The image likely belongs to the vertical specified.", |
- "The image very likely belongs to the vertical specified." |
+ "It is very unlikely that the image belongs to the specified vertical.", |
+ "It is unlikely that the image belongs to the specified vertical.", |
+ "It is possible that the image belongs to the specified vertical.", |
+ "It is likely that the image belongs to the specified vertical.", |
+ "It is very likely that the image belongs to the specified vertical." |
], |
"type": "string" |
}, |
"spoof": { |
- "description": "Spoof likelihood. The likelihood that an obvious modification\nwas made to the image's canonical version to make it appear\nfunny or offensive.", |
+ "description": "Spoof likelihood. The likelihood that an modification\nwas made to the image's canonical version to make it appear\nfunny or offensive.", |
"enum": [ |
"UNKNOWN", |
"VERY_UNLIKELY", |
@@ -768,11 +768,11 @@ |
], |
"enumDescriptions": [ |
"Unknown likelihood.", |
- "The image very unlikely belongs to the vertical specified.", |
- "The image unlikely belongs to the vertical specified.", |
- "The image possibly belongs to the vertical specified.", |
- "The image likely belongs to the vertical specified.", |
- "The image very likely belongs to the vertical specified." |
+ "It is very unlikely that the image belongs to the specified vertical.", |
+ "It is unlikely that the image belongs to the specified vertical.", |
+ "It is possible that the image belongs to the specified vertical.", |
+ "It is likely that the image belongs to the specified vertical.", |
+ "It is very likely that the image belongs to the specified vertical." |
], |
"type": "string" |
}, |
@@ -788,16 +788,16 @@ |
], |
"enumDescriptions": [ |
"Unknown likelihood.", |
- "The image very unlikely belongs to the vertical specified.", |
- "The image unlikely belongs to the vertical specified.", |
- "The image possibly belongs to the vertical specified.", |
- "The image likely belongs to the vertical specified.", |
- "The image very likely belongs to the vertical specified." |
+ "It is very unlikely that the image belongs to the specified vertical.", |
+ "It is unlikely that the image belongs to the specified vertical.", |
+ "It is possible that the image belongs to the specified vertical.", |
+ "It is likely that the image belongs to the specified vertical.", |
+ "It is very likely that the image belongs to the specified vertical." |
], |
"type": "string" |
}, |
"adult": { |
- "description": "Represents the adult contents likelihood for the image.", |
+ "description": "Represents the adult content likelihood for the image.", |
"enum": [ |
"UNKNOWN", |
"VERY_UNLIKELY", |
@@ -808,11 +808,11 @@ |
], |
"enumDescriptions": [ |
"Unknown likelihood.", |
- "The image very unlikely belongs to the vertical specified.", |
- "The image unlikely belongs to the vertical specified.", |
- "The image possibly belongs to the vertical specified.", |
- "The image likely belongs to the vertical specified.", |
- "The image very likely belongs to the vertical specified." |
+ "It is very unlikely that the image belongs to the specified vertical.", |
+ "It is unlikely that the image belongs to the specified vertical.", |
+ "It is possible that the image belongs to the specified vertical.", |
+ "It is likely that the image belongs to the specified vertical.", |
+ "It is very likely that the image belongs to the specified vertical." |
], |
"type": "string" |
} |
@@ -825,7 +825,7 @@ |
"properties": { |
"source": { |
"$ref": "ImageSource", |
- "description": "Google Cloud Storage image location. If both 'content' and 'source'\nare filled for an image, 'content' takes precedence and it will be\nused for performing the image annotation request." |
+ "description": "Google Cloud Storage image location. If both `content` and `source`\nare provided for an image, `content` takes precedence and is\nused to perform the image annotation request." |
}, |
"content": { |
"description": "Image content, represented as a stream of bytes.\nNote: as with all `bytes` fields, protobuffers use a pure binary\nrepresentation, whereas JSON representations use base64.", |
@@ -840,7 +840,7 @@ |
"id": "DominantColorsAnnotation", |
"properties": { |
"colors": { |
- "description": "RGB color values, with their score and pixel fraction.", |
+ "description": "RGB color values with their score and pixel fraction.", |
"items": { |
"$ref": "ColorInfo" |
}, |
@@ -850,7 +850,7 @@ |
"type": "object" |
}, |
"Feature": { |
- "description": "The <em>Feature</em> indicates what type of image detection task to perform.\nUsers describe the type of Google Cloud Vision API tasks to perform over\nimages by using <em>Feature</em>s. Features encode the Cloud Vision API\nvertical to operate on and the number of top-scoring results to return.", |
+ "description": "Users describe the type of Google Cloud Vision API tasks to perform over\nimages by using *Feature*s. Each Feature indicates a type of image\ndetection task to perform. Features encode the Cloud Vision API\nvertical to operate on and the number of top-scoring results to return.", |
"id": "Feature", |
"properties": { |
"type": { |
@@ -872,8 +872,8 @@ |
"Run logo detection.", |
"Run label detection.", |
"Run OCR.", |
- "Run various computer vision models to compute image safe-search properties.", |
- "Compute a set of properties about the image (such as the image's dominant colors)." |
+ "Run computer vision models to compute image safe-search properties.", |
+ "Compute a set of image properties, such as the image's dominant colors." |
], |
"type": "string" |
}, |
@@ -900,7 +900,7 @@ |
"type": "object" |
}, |
"ImageProperties": { |
- "description": "Stores image properties (e.g. dominant colors).", |
+ "description": "Stores image properties, such as dominant colors.", |
"id": "ImageProperties", |
"properties": { |
"dominantColors": { |