@@ -42,7 +42,7 @@
42 "type": "object",
42 "type": "object",
43 "properties": {
43 "properties": {
44 "gcsImageUri": {
44 "gcsImageUri": {
45− "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!",
45+ "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.",
46 "type": "string"
46 "type": "string"
@@ -75,21 +75,21 @@
75 "type": "object",
75 "type": "object",
76 "properties": {
76 "properties": {
77 "labelAnnotations": {
77 "labelAnnotations": {
78− "description": "If present, label detection completed successfully.",
78+ "description": "If present, label detection has completed successfully.",
79 "type": "array",
79 "type": "array",
80 "items": {
80 "items": {
81 "$ref": "EntityAnnotation"
81 "$ref": "EntityAnnotation"
84 "landmarkAnnotations": {
84 "landmarkAnnotations": {
85− "description": "If present, landmark detection completed successfully.",
85+ "description": "If present, landmark detection has completed successfully.",
86 "type": "array",
86 "type": "array",
87 "items": {
87 "items": {
88 "$ref": "EntityAnnotation"
88 "$ref": "EntityAnnotation"
91 "safeSearchAnnotation": {
91 "safeSearchAnnotation": {
92− "description": "If present, safe-search annotation completed successfully.",
92+ "description": "If present, safe-search annotation has completed successfully.",
93 "$ref": "SafeSearchAnnotation"
93 "$ref": "SafeSearchAnnotation"
95 "imagePropertiesAnnotation": {
95 "imagePropertiesAnnotation": {
@@ -97,35 +97,35 @@
97 "$ref": "ImageProperties"
97 "$ref": "ImageProperties"
99 "textAnnotations": {
99 "textAnnotations": {
100− "description": "If present, text (OCR) detection completed successfully.",
100+ "description": "If present, text (OCR) detection has completed successfully.",
101 "type": "array",
101 "type": "array",
102 "items": {
102 "items": {
103 "$ref": "EntityAnnotation"
103 "$ref": "EntityAnnotation"
106 "logoAnnotations": {
106 "logoAnnotations": {
107− "description": "If present, logo detection completed successfully.",
107+ "description": "If present, logo detection has completed successfully.",
108 "type": "array",
108 "type": "array",
109 "items": {
109 "items": {
110 "$ref": "EntityAnnotation"
110 "$ref": "EntityAnnotation"
113 "faceAnnotations": {
113 "faceAnnotations": {
114− "description": "If present, face detection completed successfully.",
114+ "description": "If present, face detection has completed successfully.",
115 "type": "array",
115 "type": "array",
116 "items": {
116 "items": {
117 "$ref": "FaceAnnotation"
117 "$ref": "FaceAnnotation"
120 "error": {
120 "error": {
121− "description": "If set, represents the error message for the operation.\nNote that filled-in mage annotations are guaranteed to be\ncorrect, even when \u003ccode\u003eerror\u003c/code\u003e is non-empty.",
121+ "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.",
122 "$ref": "Status"
122 "$ref": "Status"
125 "id": "AnnotateImageResponse"
125 "id": "AnnotateImageResponse"
127 "LatLongRect": {
127 "LatLongRect": {
128− "description": "Rectangle determined by min and max LatLng pairs.",
128+ "description": "Rectangle determined by min and max `LatLng` pairs.",
129 "type": "object",
129 "type": "object",
130 "properties": {
130 "properties": {
131 "maxLatLng": {
131 "maxLatLng": {
@@ -171,7 +171,7 @@
171 "type": "object",
171 "type": "object",
172 "properties": {
172 "properties": {
173 "tiltAngle": {
173 "tiltAngle": {
174− "description": "Pitch angle. Indicates the upwards/downwards angle that the face is\npointing\nrelative to the image's horizontal plane. Range [-180,180].",
174+ "description": "Pitch angle, which indicates the upwards/downwards angle that the face is\npointing relative to the image's horizontal plane. Range [-180,180].",
175 "type": "number",
175 "type": "number",
176 "format": "float"
176 "format": "float"
@@ -187,16 +187,16 @@
188 "enumDescriptions": [
188 "enumDescriptions": [
189 "Unknown likelihood.",
189 "Unknown likelihood.",
190− "The image very unlikely belongs to the vertical specified.",
190+ "It is very unlikely that the image belongs to the specified vertical.",
191− "The image unlikely belongs to the vertical specified.",
191+ "It is unlikely that the image belongs to the specified vertical.",
192− "The image possibly belongs to the vertical specified.",
192+ "It is possible that the image belongs to the specified vertical.",
193− "The image likely belongs to the vertical specified.",
193+ "It is likely that the image belongs to the specified vertical.",
194− "The image very likely belongs to the vertical specified."
194+ "It is very likely that the image belongs to the specified vertical."
196 "type": "string"
196 "type": "string"
198 "fdBoundingPoly": {
198 "fdBoundingPoly": {
199− "description": "This bounding polygon is tighter than the previous\n\u003ccode\u003eboundingPoly\u003c/code\u003e, 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 \u003ccode\u003efd\u003c/code\u003e (face detection) prefix.",
199+ "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 \u003ccode\u003efd\u003c/code\u003e (face detection) prefix.",
200 "$ref": "BoundingPoly"
200 "$ref": "BoundingPoly"
202 "landmarkingConfidence": {
202 "landmarkingConfidence": {
@@ -216,11 +216,11 @@
217 "enumDescriptions": [
217 "enumDescriptions": [
218 "Unknown likelihood.",
218 "Unknown likelihood.",
219− "The image very unlikely belongs to the vertical specified.",
219+ "It is very unlikely that the image belongs to the specified vertical.",
220− "The image unlikely belongs to the vertical specified.",
220+ "It is unlikely that the image belongs to the specified vertical.",
221− "The image possibly belongs to the vertical specified.",
221+ "It is possible that the image belongs to the specified vertical.",
222− "The image likely belongs to the vertical specified.",
222+ "It is likely that the image belongs to the specified vertical.",
223− "The image very likely belongs to the vertical specified."
223+ "It is very likely that the image belongs to the specified vertical."
225 "type": "string"
225 "type": "string"
@@ -241,11 +241,11 @@
242 "enumDescriptions": [
242 "enumDescriptions": [
243 "Unknown likelihood.",
243 "Unknown likelihood.",
244− "The image very unlikely belongs to the vertical specified.",
244+ "It is very unlikely that the image belongs to the specified vertical.",
245− "The image unlikely belongs to the vertical specified.",
245+ "It is unlikely that the image belongs to the specified vertical.",
246− "The image possibly belongs to the vertical specified.",
246+ "It is possible that the image belongs to the specified vertical.",
247− "The image likely belongs to the vertical specified.",
247+ "It is likely that the image belongs to the specified vertical.",
248− "The image very likely belongs to the vertical specified."
248+ "It is very likely that the image belongs to the specified vertical."
250 "type": "string"
250 "type": "string"
@@ -261,11 +261,11 @@
262 "enumDescriptions": [
262 "enumDescriptions": [
263 "Unknown likelihood.",
263 "Unknown likelihood.",
264− "The image very unlikely belongs to the vertical specified.",
264+ "It is very unlikely that the image belongs to the specified vertical.",
265− "The image unlikely belongs to the vertical specified.",
265+ "It is unlikely that the image belongs to the specified vertical.",
266− "The image possibly belongs to the vertical specified.",
266+ "It is possible that the image belongs to the specified vertical.",
267− "The image likely belongs to the vertical specified.",
267+ "It is likely that the image belongs to the specified vertical.",
268− "The image very likely belongs to the vertical specified."
268+ "It is very likely that the image belongs to the specified vertical."
270 "type": "string"
270 "type": "string"
@@ -281,21 +281,21 @@
282 "enumDescriptions": [
282 "enumDescriptions": [
283 "Unknown likelihood.",
283 "Unknown likelihood.",
284− "The image very unlikely belongs to the vertical specified.",
284+ "It is very unlikely that the image belongs to the specified vertical.",
285− "The image unlikely belongs to the vertical specified.",
285+ "It is unlikely that the image belongs to the specified vertical.",
286− "The image possibly belongs to the vertical specified.",
286+ "It is possible that the image belongs to the specified vertical.",
287− "The image likely belongs to the vertical specified.",
287+ "It is likely that the image belongs to the specified vertical.",
288− "The image very likely belongs to the vertical specified."
288+ "It is very likely that the image belongs to the specified vertical."
290 "type": "string"
290 "type": "string"
292 "panAngle": {
292 "panAngle": {
293− "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].",
293+ "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].",
294 "type": "number",
294 "type": "number",
295 "format": "float"
295 "format": "float"
297 "boundingPoly": {
297 "boundingPoly": {
298− "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.",
298+ "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.",
299 "$ref": "BoundingPoly"
299 "$ref": "BoundingPoly"
301 "landmarks": {
301 "landmarks": {
@@ -317,16 +317,16 @@
318 "enumDescriptions": [
318 "enumDescriptions": [
319 "Unknown likelihood.",
319 "Unknown likelihood.",
320− "The image very unlikely belongs to the vertical specified.",
320+ "It is very unlikely that the image belongs to the specified vertical.",
321− "The image unlikely belongs to the vertical specified.",
321+ "It is unlikely that the image belongs to the specified vertical.",
322− "The image possibly belongs to the vertical specified.",
322+ "It is possible that the image belongs to the specified vertical.",
323− "The image likely belongs to the vertical specified.",
323+ "It is likely that the image belongs to the specified vertical.",
324− "The image very likely belongs to the vertical specified."
324+ "It is very likely that the image belongs to the specified vertical."
326 "type": "string"
326 "type": "string"
328 "rollAngle": {
328 "rollAngle": {
329− "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].",
329+ "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].",
330 "type": "number",
330 "type": "number",
331 "format": "float"
331 "format": "float"
@@ -342,11 +342,11 @@
343 "enumDescriptions": [
343 "enumDescriptions": [
344 "Unknown likelihood.",
344 "Unknown likelihood.",
345− "The image very unlikely belongs to the vertical specified.",
345+ "It is very unlikely that the image belongs to the specified vertical.",
346− "The image unlikely belongs to the vertical specified.",
346+ "It is unlikely that the image belongs to the specified vertical.",
347− "The image possibly belongs to the vertical specified.",
347+ "It is possible that the image belongs to the specified vertical.",
348− "The image likely belongs to the vertical specified.",
348+ "It is likely that the image belongs to the specified vertical.",
349− "The image very likely belongs to the vertical specified."
349+ "It is very likely that the image belongs to the specified vertical."
351 "type": "string"
351 "type": "string"
@@ -371,11 +371,11 @@
371 "id": "Vertex"
371 "id": "Vertex"
373 "ColorInfo": {
373 "ColorInfo": {
374− "description": "Color information consists of RGB channels, score and fraction of\nimage the color occupies in the image.",
374+ "description": "Color information consists of RGB channels, score, and the fraction of\nthe image that the color occupies in the image.",
375 "type": "object",
375 "type": "object",
376 "properties": {
376 "properties": {
377 "pixelFraction": {
377 "pixelFraction": {
378− "description": "Stores the fraction of pixels the color occupies in the image.\nValue in range [0, 1].",
378+ "description": "The fraction of pixels the color occupies in the image.\nValue in range [0, 1].",
379 "type": "number",
379 "type": "number",
380 "format": "float"
380 "format": "float"
@@ -406,7 +406,7 @@
406 "id": "BoundingPoly"
406 "id": "BoundingPoly"
408 "Landmark": {
408 "Landmark": {
409− "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 \u003c= x \u003c width or 0 \u003c= y \u003c height.",
409+ "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 \u003c= x \u003c width` or\n`0 \u003c= y \u003c height`.",
410 "type": "object",
410 "type": "object",
411 "properties": {
411 "properties": {
412 "position": {
412 "position": {
@@ -495,15 +495,15 @@
495 "id": "Landmark"
495 "id": "Landmark"
497 "ImageContext": {
497 "ImageContext": {
498− "description": "Image context.",
498+ "description": "Image context and/or feature-specific parameters.",
499 "type": "object",
499 "type": "object",
500 "properties": {
500 "properties": {
501 "latLongRect": {
501 "latLongRect": {
502− "description": "Lat/long rectangle that specifies the location of the image.",
502+ "description": "lat/long rectangle that specifies the location of the image.",
503 "$ref": "LatLongRect"
503 "$ref": "LatLongRect"
505 "languageHints": {
505 "languageHints": {
506− "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).",
506+ "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).",
507 "type": "array",
507 "type": "array",
508 "items": {
508 "items": {
509 "type": "string"
509 "type": "string"
@@ -531,24 +531,24 @@
531 "type": "object",
531 "type": "object",
532 "properties": {
532 "properties": {
534− "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/",
534+ "description": "Opaque entity ID. Some IDs may be available in\n[Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph/).",
535 "type": "string"
535 "type": "string"
537 "description": {
537 "description": {
538− "description": "Entity textual description, expressed in its \u003ccode\u003elocale\u003c/code\u003e language.",
538+ "description": "Entity textual description, expressed in its `locale` language.",
539 "type": "string"
539 "type": "string"
541 "topicality": {
541 "topicality": {
542− "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].",
542+ "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].",
543 "type": "number",
543 "type": "number",
544 "format": "float"
544 "format": "float"
546 "locale": {
546 "locale": {
547− "description": "The language code for the locale in which the entity textual\n\u003ccode\u003edescription\u003c/code\u003e (next field) is expressed.",
547+ "description": "The language code for the locale in which the entity textual\n`description` is expressed.",
548 "type": "string"
548 "type": "string"
550 "properties": {
550 "properties": {
551− "description": "Some entities can have additional optional \u003ccode\u003eProperty\u003c/code\u003e fields.\nFor example a different kind of score or string that qualifies the entity.",
551+ "description": "Some entities may have optional user-supplied `Property` (name/value)\nfields, such a score or string that qualifies the entity.",
552 "type": "array",
552 "type": "array",
553 "items": {
553 "items": {
554 "$ref": "Property"
554 "$ref": "Property"
@@ -560,18 +560,18 @@
560 "format": "float"
560 "format": "float"
562 "boundingPoly": {
562 "boundingPoly": {
563− "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.",
563+ "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.",
564 "$ref": "BoundingPoly"
564 "$ref": "BoundingPoly"
566 "locations": {
566 "locations": {
567− "description": "The location information for the detected entity. Multiple\n\u003ccode\u003eLocationInfo\u003c/code\u003e 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.",
567+ "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.",
568 "type": "array",
568 "type": "array",
569 "items": {
569 "items": {
570 "$ref": "LocationInfo"
570 "$ref": "LocationInfo"
573 "confidence": {
573 "confidence": {
574− "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].",
574+ "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].",
575 "type": "number",
575 "type": "number",
576 "format": "float"
576 "format": "float"
@@ -579,7 +579,7 @@
579 "id": "EntityAnnotation"
579 "id": "EntityAnnotation"
581 "Property": {
581 "Property": {
582− "description": "Arbitrary name/value pair.",
582+ "description": "A `Property` consists of a user-supplied name/value pair.",
583 "type": "object",
583 "type": "object",
584 "properties": {
584 "properties": {
585 "value": {
585 "value": {
@@ -625,18 +625,17 @@
625 "type": "object",
625 "type": "object",
626 "properties": {
626 "properties": {
627 "latLng": {
627 "latLng": {
628− "description": "Lat - long location coordinates.",
628+ "description": "lat/long location coordinates.",
629 "$ref": "LatLng"
629 "$ref": "LatLng"
632 "id": "LocationInfo"
632 "id": "LocationInfo"
634 "SafeSearchAnnotation": {
634 "SafeSearchAnnotation": {
635− "description": "Set of features pertaining to the image, computed by various computer vision\nmethods over safe-search verticals (for example, adult, spoof, medical,\nviolence).",
636 "type": "object",
635 "type": "object",
637 "properties": {
636 "properties": {
638 "medical": {
637 "medical": {
639− "description": "Likelihood this is a medical image.",
638+ "description": "Likelihood that this is a medical image.",
640 "enum": [
639 "enum": [
641 "UNKNOWN",
640 "UNKNOWN",
642 "VERY_UNLIKELY",
641 "VERY_UNLIKELY",
@@ -647,16 +646,16 @@
648 "enumDescriptions": [
647 "enumDescriptions": [
649 "Unknown likelihood.",
648 "Unknown likelihood.",
650− "The image very unlikely belongs to the vertical specified.",
649+ "It is very unlikely that the image belongs to the specified vertical.",
651− "The image unlikely belongs to the vertical specified.",
650+ "It is unlikely that the image belongs to the specified vertical.",
652− "The image possibly belongs to the vertical specified.",
651+ "It is possible that the image belongs to the specified vertical.",
653− "The image likely belongs to the vertical specified.",
652+ "It is likely that the image belongs to the specified vertical.",
654− "The image very likely belongs to the vertical specified."
653+ "It is very likely that the image belongs to the specified vertical."
656 "type": "string"
655 "type": "string"
658 "spoof": {
657 "spoof": {
659− "description": "Spoof likelihood. The likelihood that an obvious modification\nwas made to the image's canonical version to make it appear\nfunny or offensive.",
658+ "description": "Spoof likelihood. The likelihood that an modification\nwas made to the image's canonical version to make it appear\nfunny or offensive.",
660 "enum": [
659 "enum": [
661 "UNKNOWN",
660 "UNKNOWN",
662 "VERY_UNLIKELY",
661 "VERY_UNLIKELY",
@@ -667,11 +666,11 @@
668 "enumDescriptions": [
667 "enumDescriptions": [
669 "Unknown likelihood.",
668 "Unknown likelihood.",
670− "The image very unlikely belongs to the vertical specified.",
669+ "It is very unlikely that the image belongs to the specified vertical.",
671− "The image unlikely belongs to the vertical specified.",
670+ "It is unlikely that the image belongs to the specified vertical.",
672− "The image possibly belongs to the vertical specified.",
671+ "It is possible that the image belongs to the specified vertical.",
673− "The image likely belongs to the vertical specified.",
672+ "It is likely that the image belongs to the specified vertical.",
674− "The image very likely belongs to the vertical specified."
673+ "It is very likely that the image belongs to the specified vertical."
676 "type": "string"
675 "type": "string"
@@ -687,16 +686,16 @@
688 "enumDescriptions": [
687 "enumDescriptions": [
689 "Unknown likelihood.",
688 "Unknown likelihood.",
690− "The image very unlikely belongs to the vertical specified.",
689+ "It is very unlikely that the image belongs to the specified vertical.",
691− "The image unlikely belongs to the vertical specified.",
690+ "It is unlikely that the image belongs to the specified vertical.",
692− "The image possibly belongs to the vertical specified.",
691+ "It is possible that the image belongs to the specified vertical.",
693− "The image likely belongs to the vertical specified.",
692+ "It is likely that the image belongs to the specified vertical.",
694− "The image very likely belongs to the vertical specified."
693+ "It is very likely that the image belongs to the specified vertical."
696 "type": "string"
695 "type": "string"
698 "adult": {
697 "adult": {
699− "description": "Represents the adult contents likelihood for the image.",
698+ "description": "Represents the adult content likelihood for the image.",
700 "enum": [
699 "enum": [
701 "UNKNOWN",
700 "UNKNOWN",
702 "VERY_UNLIKELY",
701 "VERY_UNLIKELY",
@@ -707,11 +706,11 @@
708 "enumDescriptions": [
707 "enumDescriptions": [
709 "Unknown likelihood.",
708 "Unknown likelihood.",
710− "The image very unlikely belongs to the vertical specified.",
709+ "It is very unlikely that the image belongs to the specified vertical.",
711− "The image unlikely belongs to the vertical specified.",
710+ "It is unlikely that the image belongs to the specified vertical.",
712− "The image possibly belongs to the vertical specified.",
711+ "It is possible that the image belongs to the specified vertical.",
713− "The image likely belongs to the vertical specified.",
712+ "It is likely that the image belongs to the specified vertical.",
714− "The image very likely belongs to the vertical specified."
713+ "It is very likely that the image belongs to the specified vertical."
716 "type": "string"
715 "type": "string"
@@ -723,7 +722,7 @@
723 "type": "object",
722 "type": "object",
724 "properties": {
723 "properties": {
725 "source": {
724 "source": {
726− "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.",
725+ "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.",
727 "$ref": "ImageSource"
726 "$ref": "ImageSource"
729 "content": {
728 "content": {
@@ -739,7 +738,7 @@
739 "type": "object",
738 "type": "object",
740 "properties": {
739 "properties": {
741 "colors": {
740 "colors": {
742− "description": "RGB color values, with their score and pixel fraction.",
741+ "description": "RGB color values with their score and pixel fraction.",
743 "type": "array",
742 "type": "array",
744 "items": {
743 "items": {
745 "$ref": "ColorInfo"
744 "$ref": "ColorInfo"
@@ -749,7 +748,7 @@
749 "id": "DominantColorsAnnotation"
748 "id": "DominantColorsAnnotation"
751 "Feature": {
750 "Feature": {
752− "description": "The \u003cem\u003eFeature\u003c/em\u003e 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 \u003cem\u003eFeature\u003c/em\u003es. Features encode the Cloud Vision API\nvertical to operate on and the number of top-scoring results to return.",
751+ "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.",
753 "type": "object",
752 "type": "object",
754 "properties": {
753 "properties": {
755 "type": {
754 "type": {
@@ -771,8 +770,8 @@
771 "Run logo detection.",
770 "Run logo detection.",
772 "Run label detection.",
771 "Run label detection.",
773 "Run OCR.",
772 "Run OCR.",
774− "Run various computer vision models to compute image safe-search properties.",
773+ "Run computer vision models to compute image safe-search properties.",
775− "Compute a set of properties about the image (such as the image's dominant colors)."
774+ "Compute a set of image properties, such as the image's dominant colors."
777 "type": "string"
776 "type": "string"
@@ -799,7 +798,7 @@
799 "id": "BatchAnnotateImagesResponse"
798 "id": "BatchAnnotateImagesResponse"
801 "ImageProperties": {
800 "ImageProperties": {
802− "description": "Stores image properties (e.g. dominant colors).",
801+ "description": "Stores image properties, such as dominant colors.",
803 "type": "object",
802 "type": "object",
804 "properties": {
803 "properties": {
805 "dominantColors": {
804 "dominantColors": {
@@ -810,7 +809,7 @@
810 "id": "ImageProperties"
809 "id": "ImageProperties"
812 "LatLng": {
811 "LatLng": {
813− "description": "An object representing a latitude/longitude pair. This is expressed as a pair\nof doubles representing degrees latitude and degrees longitude. Unless\nspecified otherwise, this must conform to the\n\u003ca href=\"http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf\"\u003eWGS84\nstandard\u003c/a\u003e. Values must be within normalized ranges.\n\nExample of normalization code in Python:\n\n def NormalizeLongitude(longitude):\n \"\"\"Wraps decimal degrees longitude to [-180.0, 180.0].\"\"\"\n q, r = divmod(longitude, 360.0)\n if r \u003e 180.0 or (r == 180.0 and q \u003c= -1.0):\n return r - 360.0\n return r\n\n def NormalizeLatLng(latitude, longitude):\n \"\"\"Wraps decimal degrees latitude and longitude to\n [-90.0, 90.0] and [-180.0, 180.0], respectively.\"\"\"\n r = latitude % 360.0\n if r \u003c= 90.0:\n return r, NormalizeLongitude(longitude)\n elif r \u003e= 270.0:\n return r - 360, NormalizeLongitude(longitude)\n else:\n return 180 - r, NormalizeLongitude(longitude + 180.0)\n\n assert 180.0 == NormalizeLongitude(180.0)\n assert -180.0 == NormalizeLongitude(-180.0)\n assert -179.0 == NormalizeLongitude(181.0)\n assert (0.0, 0.0) == NormalizeLatLng(360.0, 0.0)\n assert (0.0, 0.0) == NormalizeLatLng(-360.0, 0.0)\n assert (85.0, 180.0) == NormalizeLatLng(95.0, 0.0)\n assert (-85.0, -170.0) == NormalizeLatLng(-95.0, 10.0)\n assert (90.0, 10.0) == NormalizeLatLng(90.0, 10.0)\n assert (-90.0, -10.0) == NormalizeLatLng(-90.0, -10.0)\n assert (0.0, -170.0) == NormalizeLatLng(-180.0, 10.0)\n assert (0.0, -170.0) == NormalizeLatLng(180.0, 10.0)\n assert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0)\n assert (90.0, 10.0) == NormalizeLatLng(-270.0, 10.0)",
812+ "description": "An object representing a latitude/longitude pair. This is expressed as a pair\nof doubles representing degrees latitude and degrees longitude. Unless\nspecified otherwise, this must conform to the\n\u003ca href=\"http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf\"\u003eWGS84\nstandard\u003c/a\u003e. Values must be within normalized ranges.\n\nExample of normalization code in Python:\n\n def NormalizeLongitude(longitude):\n \"\"\"Wraps decimal degrees longitude to [-180.0, 180.0].\"\"\"\n q, r = divmod(longitude, 360.0)\n if r \u003e 180.0 or (r == 180.0 and q \u003c= -1.0):\n return r - 360.0\n return r\n\n def NormalizeLatLng(latitude, longitude):\n \"\"\"Wraps decimal degrees latitude and longitude to\n [-90.0, 90.0] and [-180.0, 180.0], respectively.\"\"\"\n r = latitude % 360.0\n if r \u003c= 90.0:\n return r, NormalizeLongitude(longitude)\n elif r \u003e= 270.0:\n return r - 360, NormalizeLongitude(longitude)\n else:\n return 180 - r, NormalizeLongitude(longitude + 180.0)\n\n assert 180.0 == NormalizeLongitude(180.0)\n assert -180.0 == NormalizeLongitude(-180.0)\n assert -179.0 == NormalizeLongitude(181.0)\n assert (0.0, 0.0) == NormalizeLatLng(360.0, 0.0)\n assert (0.0, 0.0) == NormalizeLatLng(-360.0, 0.0)\n assert (85.0, 180.0) == NormalizeLatLng(95.0, 0.0)\n assert (-85.0, -170.0) == NormalizeLatLng(-95.0, 10.0)\n assert (90.0, 10.0) == NormalizeLatLng(90.0, 10.0)\n assert (-90.0, -10.0) == NormalizeLatLng(-90.0, -10.0)\n assert (0.0, -170.0) == NormalizeLatLng(-180.0, 10.0)\n assert (0.0, -170.0) == NormalizeLatLng(180.0, 10.0)\n assert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0)\n assert (90.0, 10.0) == NormalizeLatLng(-270.0, 10.0)\n\nThe code in logs/storage/validator/logs_validator_traits.cc treats this type\nas if it were annotated as ST_LOCATION.",
814 "type": "object",
813 "type": "object",
815 "properties": {
814 "properties": {
816 "latitude": {
815 "latitude": {
@@ -849,13 +848,14 @@
849 "id": "Position"
848 "id": "Position"
852− "revision": "20160726",
851+ "revision": "20170112",
853 "basePath": "",
852 "basePath": "",
854 "icons": {
853 "icons": {
855 "x32": "http://www.google.com/images/icons/product/search-32.gif",
854 "x32": "http://www.google.com/images/icons/product/search-32.gif",
856 "x16": "http://www.google.com/images/icons/product/search-16.gif"
855 "x16": "http://www.google.com/images/icons/product/search-16.gif"
858 "version_module": "True",
857 "version_module": "True",
858+ "canonicalName": "Vision",
859 "discoveryVersion": "v1",
859 "discoveryVersion": "v1",
860 "baseUrl": "https://vision.googleapis.com/",
860 "baseUrl": "https://vision.googleapis.com/",
861 "name": "vision",
861 "name": "vision",