OLD | NEW |
1 { | 1 { |
2 "auth": { | 2 "auth": { |
3 "oauth2": { | 3 "oauth2": { |
4 "scopes": { | 4 "scopes": { |
| 5 "https://www.googleapis.com/auth/cloud-vision": { |
| 6 "description": "Apply machine learning models to understand
and label images" |
| 7 }, |
5 "https://www.googleapis.com/auth/cloud-platform": { | 8 "https://www.googleapis.com/auth/cloud-platform": { |
6 "description": "View and manage your data across Google Clou
d Platform services" | 9 "description": "View and manage your data across Google Clou
d Platform services" |
7 } | 10 } |
8 } | 11 } |
9 } | 12 } |
10 }, | 13 }, |
11 "basePath": "", | 14 "basePath": "", |
12 "baseUrl": "https://vision.googleapis.com/", | 15 "baseUrl": "https://vision.googleapis.com/", |
13 "batchPath": "batch", | 16 "batchPath": "batch", |
14 "canonicalName": "Vision", | 17 "canonicalName": "Vision", |
15 "description": "Integrates Google Vision features, including image labeling,
face, logo, and landmark detection, optical character recognition (OCR), and de
tection of explicit content, into applications.", | 18 "description": "Integrates Google Vision features, including image labeling,
face, logo, and landmark detection, optical character recognition (OCR), and de
tection of explicit content, into applications.", |
16 "discoveryVersion": "v1", | 19 "discoveryVersion": "v1", |
17 "documentationLink": "https://cloud.google.com/vision/", | 20 "documentationLink": "https://cloud.google.com/vision/", |
18 "icons": { | 21 "icons": { |
19 "x16": "http://www.google.com/images/icons/product/search-16.gif", | 22 "x16": "http://www.google.com/images/icons/product/search-16.gif", |
20 "x32": "http://www.google.com/images/icons/product/search-32.gif" | 23 "x32": "http://www.google.com/images/icons/product/search-32.gif" |
21 }, | 24 }, |
22 "id": "vision:v1", | 25 "id": "vision:v1", |
23 "kind": "discovery#restDescription", | 26 "kind": "discovery#restDescription", |
24 "name": "vision", | 27 "name": "vision", |
25 "ownerDomain": "google.com", | 28 "ownerDomain": "google.com", |
26 "ownerName": "Google", | 29 "ownerName": "Google", |
27 "parameters": { | 30 "parameters": { |
| 31 "quotaUser": { |
| 32 "description": "Available to use for quota purposes for server-side
applications. Can be any arbitrary string assigned to a user, but should not exc
eed 40 characters.", |
| 33 "location": "query", |
| 34 "type": "string" |
| 35 }, |
| 36 "pp": { |
| 37 "default": "true", |
| 38 "description": "Pretty-print response.", |
| 39 "location": "query", |
| 40 "type": "boolean" |
| 41 }, |
| 42 "oauth_token": { |
| 43 "description": "OAuth 2.0 token for the current user.", |
| 44 "location": "query", |
| 45 "type": "string" |
| 46 }, |
| 47 "bearer_token": { |
| 48 "description": "OAuth bearer token.", |
| 49 "location": "query", |
| 50 "type": "string" |
| 51 }, |
28 "upload_protocol": { | 52 "upload_protocol": { |
29 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", | 53 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", |
30 "location": "query", | 54 "location": "query", |
31 "type": "string" | 55 "type": "string" |
32 }, | 56 }, |
33 "prettyPrint": { | 57 "prettyPrint": { |
34 "default": "true", | 58 "default": "true", |
35 "description": "Returns response with indentations and line breaks."
, | 59 "description": "Returns response with indentations and line breaks."
, |
36 "location": "query", | 60 "location": "query", |
37 "type": "boolean" | 61 "type": "boolean" |
38 }, | 62 }, |
39 "uploadType": { | 63 "uploadType": { |
40 "description": "Legacy upload protocol for media (e.g. \"media\", \"
multipart\").", | 64 "description": "Legacy upload protocol for media (e.g. \"media\", \"
multipart\").", |
41 "location": "query", | 65 "location": "query", |
42 "type": "string" | 66 "type": "string" |
43 }, | 67 }, |
44 "fields": { | 68 "fields": { |
45 "description": "Selector specifying which fields to include in a par
tial response.", | 69 "description": "Selector specifying which fields to include in a par
tial response.", |
46 "location": "query", | 70 "location": "query", |
47 "type": "string" | 71 "type": "string" |
48 }, | 72 }, |
| 73 "callback": { |
| 74 "description": "JSONP", |
| 75 "location": "query", |
| 76 "type": "string" |
| 77 }, |
49 "$.xgafv": { | 78 "$.xgafv": { |
50 "description": "V1 error format.", | 79 "description": "V1 error format.", |
51 "enum": [ | 80 "enum": [ |
52 "1", | 81 "1", |
53 "2" | 82 "2" |
54 ], | 83 ], |
55 "enumDescriptions": [ | 84 "enumDescriptions": [ |
56 "v1 error format", | 85 "v1 error format", |
57 "v2 error format" | 86 "v2 error format" |
58 ], | 87 ], |
59 "location": "query", | 88 "location": "query", |
60 "type": "string" | 89 "type": "string" |
61 }, | 90 }, |
62 "callback": { | |
63 "description": "JSONP", | |
64 "location": "query", | |
65 "type": "string" | |
66 }, | |
67 "alt": { | 91 "alt": { |
68 "default": "json", | 92 "default": "json", |
69 "description": "Data format for response.", | 93 "description": "Data format for response.", |
70 "enum": [ | 94 "enum": [ |
71 "json", | 95 "json", |
72 "media", | 96 "media", |
73 "proto" | 97 "proto" |
74 ], | 98 ], |
75 "enumDescriptions": [ | 99 "enumDescriptions": [ |
76 "Responses with Content-Type of application/json", | 100 "Responses with Content-Type of application/json", |
77 "Media download with context-dependent Content-Type", | 101 "Media download with context-dependent Content-Type", |
78 "Responses with Content-Type of application/x-protobuf" | 102 "Responses with Content-Type of application/x-protobuf" |
79 ], | 103 ], |
80 "location": "query", | 104 "location": "query", |
81 "type": "string" | 105 "type": "string" |
82 }, | 106 }, |
83 "access_token": { | |
84 "description": "OAuth access token.", | |
85 "location": "query", | |
86 "type": "string" | |
87 }, | |
88 "key": { | 107 "key": { |
89 "description": "API key. Your API key identifies your project and pr
ovides you with API access, quota, and reports. Required unless you provide an O
Auth 2.0 token.", | 108 "description": "API key. Your API key identifies your project and pr
ovides you with API access, quota, and reports. Required unless you provide an O
Auth 2.0 token.", |
90 "location": "query", | 109 "location": "query", |
91 "type": "string" | 110 "type": "string" |
92 }, | 111 }, |
93 "quotaUser": { | 112 "access_token": { |
94 "description": "Available to use for quota purposes for server-side
applications. Can be any arbitrary string assigned to a user, but should not exc
eed 40 characters.", | 113 "description": "OAuth access token.", |
95 "location": "query", | |
96 "type": "string" | |
97 }, | |
98 "pp": { | |
99 "default": "true", | |
100 "description": "Pretty-print response.", | |
101 "location": "query", | |
102 "type": "boolean" | |
103 }, | |
104 "oauth_token": { | |
105 "description": "OAuth 2.0 token for the current user.", | |
106 "location": "query", | |
107 "type": "string" | |
108 }, | |
109 "bearer_token": { | |
110 "description": "OAuth bearer token.", | |
111 "location": "query", | 114 "location": "query", |
112 "type": "string" | 115 "type": "string" |
113 } | 116 } |
114 }, | 117 }, |
115 "protocol": "rest", | 118 "protocol": "rest", |
116 "resources": { | 119 "resources": { |
117 "images": { | 120 "images": { |
118 "methods": { | 121 "methods": { |
119 "annotate": { | 122 "annotate": { |
120 "description": "Run image detection and annotation for a bat
ch of images.", | 123 "description": "Run image detection and annotation for a bat
ch of images.", |
121 "httpMethod": "POST", | 124 "httpMethod": "POST", |
122 "id": "vision.images.annotate", | 125 "id": "vision.images.annotate", |
123 "parameterOrder": [], | 126 "parameterOrder": [], |
124 "parameters": {}, | 127 "parameters": {}, |
125 "path": "v1/images:annotate", | 128 "path": "v1/images:annotate", |
126 "request": { | 129 "request": { |
127 "$ref": "BatchAnnotateImagesRequest" | 130 "$ref": "BatchAnnotateImagesRequest" |
128 }, | 131 }, |
129 "response": { | 132 "response": { |
130 "$ref": "BatchAnnotateImagesResponse" | 133 "$ref": "BatchAnnotateImagesResponse" |
131 }, | 134 }, |
132 "scopes": [ | 135 "scopes": [ |
133 "https://www.googleapis.com/auth/cloud-platform" | 136 "https://www.googleapis.com/auth/cloud-platform", |
| 137 "https://www.googleapis.com/auth/cloud-vision" |
134 ] | 138 ] |
135 } | 139 } |
136 } | 140 } |
137 } | 141 } |
138 }, | 142 }, |
139 "revision": "20170606", | 143 "revision": "20170626", |
140 "rootUrl": "https://vision.googleapis.com/", | 144 "rootUrl": "https://vision.googleapis.com/", |
141 "schemas": { | 145 "schemas": { |
142 "SafeSearchAnnotation": { | |
143 "description": "Set of features pertaining to the image, computed by
computer vision\nmethods over safe-search verticals (for example, adult, spoof,
medical,\nviolence).", | |
144 "id": "SafeSearchAnnotation", | |
145 "properties": { | |
146 "violence": { | |
147 "description": "Violence likelihood.", | |
148 "enum": [ | |
149 "UNKNOWN", | |
150 "VERY_UNLIKELY", | |
151 "UNLIKELY", | |
152 "POSSIBLE", | |
153 "LIKELY", | |
154 "VERY_LIKELY" | |
155 ], | |
156 "enumDescriptions": [ | |
157 "Unknown likelihood.", | |
158 "It is very unlikely that the image belongs to the speci
fied vertical.", | |
159 "It is unlikely that the image belongs to the specified
vertical.", | |
160 "It is possible that the image belongs to the specified
vertical.", | |
161 "It is likely that the image belongs to the specified ve
rtical.", | |
162 "It is very likely that the image belongs to the specifi
ed vertical." | |
163 ], | |
164 "type": "string" | |
165 }, | |
166 "adult": { | |
167 "description": "Represents the adult content likelihood for
the image.", | |
168 "enum": [ | |
169 "UNKNOWN", | |
170 "VERY_UNLIKELY", | |
171 "UNLIKELY", | |
172 "POSSIBLE", | |
173 "LIKELY", | |
174 "VERY_LIKELY" | |
175 ], | |
176 "enumDescriptions": [ | |
177 "Unknown likelihood.", | |
178 "It is very unlikely that the image belongs to the speci
fied vertical.", | |
179 "It is unlikely that the image belongs to the specified
vertical.", | |
180 "It is possible that the image belongs to the specified
vertical.", | |
181 "It is likely that the image belongs to the specified ve
rtical.", | |
182 "It is very likely that the image belongs to the specifi
ed vertical." | |
183 ], | |
184 "type": "string" | |
185 }, | |
186 "spoof": { | |
187 "description": "Spoof likelihood. The likelihood that an mod
ification\nwas made to the image's canonical version to make it appear\nfunny or
offensive.", | |
188 "enum": [ | |
189 "UNKNOWN", | |
190 "VERY_UNLIKELY", | |
191 "UNLIKELY", | |
192 "POSSIBLE", | |
193 "LIKELY", | |
194 "VERY_LIKELY" | |
195 ], | |
196 "enumDescriptions": [ | |
197 "Unknown likelihood.", | |
198 "It is very unlikely that the image belongs to the speci
fied vertical.", | |
199 "It is unlikely that the image belongs to the specified
vertical.", | |
200 "It is possible that the image belongs to the specified
vertical.", | |
201 "It is likely that the image belongs to the specified ve
rtical.", | |
202 "It is very likely that the image belongs to the specifi
ed vertical." | |
203 ], | |
204 "type": "string" | |
205 }, | |
206 "medical": { | |
207 "description": "Likelihood that this is a medical image.", | |
208 "enum": [ | |
209 "UNKNOWN", | |
210 "VERY_UNLIKELY", | |
211 "UNLIKELY", | |
212 "POSSIBLE", | |
213 "LIKELY", | |
214 "VERY_LIKELY" | |
215 ], | |
216 "enumDescriptions": [ | |
217 "Unknown likelihood.", | |
218 "It is very unlikely that the image belongs to the speci
fied vertical.", | |
219 "It is unlikely that the image belongs to the specified
vertical.", | |
220 "It is possible that the image belongs to the specified
vertical.", | |
221 "It is likely that the image belongs to the specified ve
rtical.", | |
222 "It is very likely that the image belongs to the specifi
ed vertical." | |
223 ], | |
224 "type": "string" | |
225 } | |
226 }, | |
227 "type": "object" | |
228 }, | |
229 "DominantColorsAnnotation": { | |
230 "description": "Set of dominant colors and their corresponding score
s.", | |
231 "id": "DominantColorsAnnotation", | |
232 "properties": { | |
233 "colors": { | |
234 "description": "RGB color values with their score and pixel
fraction.", | |
235 "items": { | |
236 "$ref": "ColorInfo" | |
237 }, | |
238 "type": "array" | |
239 } | |
240 }, | |
241 "type": "object" | |
242 }, | |
243 "TextAnnotation": { | |
244 "description": "TextAnnotation contains a structured representation
of OCR extracted text.\nThe hierarchy of an OCR extracted text structure is like
this:\n TextAnnotation -> Page -> Block -> Paragraph -> Word -> Symbol\nEach
structural component, starting from Page, may further have their own\npropertie
s. Properties describe detected languages, breaks etc.. Please\nrefer to the goo
gle.cloud.vision.v1.TextAnnotation.TextProperty message\ndefinition below for mo
re detail.", | |
245 "id": "TextAnnotation", | |
246 "properties": { | |
247 "pages": { | |
248 "description": "List of pages detected by OCR.", | |
249 "items": { | |
250 "$ref": "Page" | |
251 }, | |
252 "type": "array" | |
253 }, | |
254 "text": { | |
255 "description": "UTF-8 text detected on the pages.", | |
256 "type": "string" | |
257 } | |
258 }, | |
259 "type": "object" | |
260 }, | |
261 "DetectedLanguage": { | |
262 "description": "Detected language for a structural component.", | |
263 "id": "DetectedLanguage", | |
264 "properties": { | |
265 "confidence": { | |
266 "description": "Confidence of detected language. Range [0, 1
].", | |
267 "format": "float", | |
268 "type": "number" | |
269 }, | |
270 "languageCode": { | |
271 "description": "The BCP-47 language code, such as \"en-US\"
or \"sr-Latn\". For more\ninformation, see\nhttp://www.unicode.org/reports/tr35/
#Unicode_locale_identifier.", | |
272 "type": "string" | |
273 } | |
274 }, | |
275 "type": "object" | |
276 }, | |
277 "Vertex": { | |
278 "description": "A vertex represents a 2D point in the image.\nNOTE:
the vertex coordinates are in the same scale as the original image.", | |
279 "id": "Vertex", | |
280 "properties": { | |
281 "x": { | |
282 "description": "X coordinate.", | |
283 "format": "int32", | |
284 "type": "integer" | |
285 }, | |
286 "y": { | |
287 "description": "Y coordinate.", | |
288 "format": "int32", | |
289 "type": "integer" | |
290 } | |
291 }, | |
292 "type": "object" | |
293 }, | |
294 "TextProperty": { | |
295 "description": "Additional information detected on the structural co
mponent.", | |
296 "id": "TextProperty", | |
297 "properties": { | |
298 "detectedLanguages": { | |
299 "description": "A list of detected languages together with c
onfidence.", | |
300 "items": { | |
301 "$ref": "DetectedLanguage" | |
302 }, | |
303 "type": "array" | |
304 }, | |
305 "detectedBreak": { | |
306 "$ref": "DetectedBreak", | |
307 "description": "Detected start or end of a text segment." | |
308 } | |
309 }, | |
310 "type": "object" | |
311 }, | |
312 "WebEntity": { | |
313 "description": "Entity deduced from similar images on the Internet."
, | |
314 "id": "WebEntity", | |
315 "properties": { | |
316 "score": { | |
317 "description": "Overall relevancy score for the entity.\nNot
normalized and not comparable across different image queries.", | |
318 "format": "float", | |
319 "type": "number" | |
320 }, | |
321 "entityId": { | |
322 "description": "Opaque entity ID.", | |
323 "type": "string" | |
324 }, | |
325 "description": { | |
326 "description": "Canonical description of the entity, in Engl
ish.", | |
327 "type": "string" | |
328 } | |
329 }, | |
330 "type": "object" | |
331 }, | |
332 "BoundingPoly": { | |
333 "description": "A bounding polygon for the detected image annotation
.", | |
334 "id": "BoundingPoly", | |
335 "properties": { | |
336 "vertices": { | |
337 "description": "The bounding polygon vertices.", | |
338 "items": { | |
339 "$ref": "Vertex" | |
340 }, | |
341 "type": "array" | |
342 } | |
343 }, | |
344 "type": "object" | |
345 }, | |
346 "AnnotateImageResponse": { | |
347 "description": "Response to an image annotation request.", | |
348 "id": "AnnotateImageResponse", | |
349 "properties": { | |
350 "logoAnnotations": { | |
351 "description": "If present, logo detection has completed suc
cessfully.", | |
352 "items": { | |
353 "$ref": "EntityAnnotation" | |
354 }, | |
355 "type": "array" | |
356 }, | |
357 "cropHintsAnnotation": { | |
358 "$ref": "CropHintsAnnotation", | |
359 "description": "If present, crop hints have completed succes
sfully." | |
360 }, | |
361 "webDetection": { | |
362 "$ref": "WebDetection", | |
363 "description": "If present, web detection has completed succ
essfully." | |
364 }, | |
365 "labelAnnotations": { | |
366 "description": "If present, label detection has completed su
ccessfully.", | |
367 "items": { | |
368 "$ref": "EntityAnnotation" | |
369 }, | |
370 "type": "array" | |
371 }, | |
372 "safeSearchAnnotation": { | |
373 "$ref": "SafeSearchAnnotation", | |
374 "description": "If present, safe-search annotation has compl
eted successfully." | |
375 }, | |
376 "error": { | |
377 "$ref": "Status", | |
378 "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." | |
379 }, | |
380 "fullTextAnnotation": { | |
381 "$ref": "TextAnnotation", | |
382 "description": "If present, text (OCR) detection or document
(OCR) text detection has\ncompleted successfully.\nThis annotation provides the
structural hierarchy for the OCR detected\ntext." | |
383 }, | |
384 "landmarkAnnotations": { | |
385 "description": "If present, landmark detection has completed
successfully.", | |
386 "items": { | |
387 "$ref": "EntityAnnotation" | |
388 }, | |
389 "type": "array" | |
390 }, | |
391 "textAnnotations": { | |
392 "description": "If present, text (OCR) detection has complet
ed successfully.", | |
393 "items": { | |
394 "$ref": "EntityAnnotation" | |
395 }, | |
396 "type": "array" | |
397 }, | |
398 "imagePropertiesAnnotation": { | |
399 "$ref": "ImageProperties", | |
400 "description": "If present, image properties were extracted
successfully." | |
401 }, | |
402 "faceAnnotations": { | |
403 "description": "If present, face detection has completed suc
cessfully.", | |
404 "items": { | |
405 "$ref": "FaceAnnotation" | |
406 }, | |
407 "type": "array" | |
408 } | |
409 }, | |
410 "type": "object" | |
411 }, | |
412 "CropHintsParams": { | |
413 "description": "Parameters for crop hints annotation request.", | |
414 "id": "CropHintsParams", | |
415 "properties": { | |
416 "aspectRatios": { | |
417 "description": "Aspect ratios in floats, representing the ra
tio of the width to the height\nof the image. For example, if the desired aspect
ratio is 4/3, the\ncorresponding float value should be 1.33333. If not specifi
ed, the\nbest possible crop is returned. The number of provided aspect ratios is
\nlimited to a maximum of 16; any aspect ratios provided after the 16th are\nign
ored.", | |
418 "items": { | |
419 "format": "float", | |
420 "type": "number" | |
421 }, | |
422 "type": "array" | |
423 } | |
424 }, | |
425 "type": "object" | |
426 }, | |
427 "Block": { | |
428 "description": "Logical element on the page.", | |
429 "id": "Block", | |
430 "properties": { | |
431 "blockType": { | |
432 "description": "Detected block type (text, image etc) for th
is block.", | |
433 "enum": [ | |
434 "UNKNOWN", | |
435 "TEXT", | |
436 "TABLE", | |
437 "PICTURE", | |
438 "RULER", | |
439 "BARCODE" | |
440 ], | |
441 "enumDescriptions": [ | |
442 "Unknown block type.", | |
443 "Regular text block.", | |
444 "Table block.", | |
445 "Image block.", | |
446 "Horizontal/vertical line box.", | |
447 "Barcode block." | |
448 ], | |
449 "type": "string" | |
450 }, | |
451 "boundingBox": { | |
452 "$ref": "BoundingPoly", | |
453 "description": "The bounding box for the block.\nThe vertice
s are in the order of top-left, top-right, bottom-right,\nbottom-left. When a ro
tation of the bounding box is detected the rotation\nis represented as around th
e top-left corner as defined when the text is\nread in the 'natural' orientation
.\nFor example:\n * when the text is horizontal it might look like:\n 0----
1\n | |\n 3----2\n * when it's rotated 180 degrees around the top-le
ft corner it becomes:\n 2----3\n | |\n 1----0\n and the vertice
order will still be (0, 1, 2, 3)." | |
454 }, | |
455 "paragraphs": { | |
456 "description": "List of paragraphs in this block (if this bl
ocks is of type text).", | |
457 "items": { | |
458 "$ref": "Paragraph" | |
459 }, | |
460 "type": "array" | |
461 }, | |
462 "property": { | |
463 "$ref": "TextProperty", | |
464 "description": "Additional information detected for the bloc
k." | |
465 } | |
466 }, | |
467 "type": "object" | |
468 }, | |
469 "Property": { | |
470 "description": "A `Property` consists of a user-supplied name/value
pair.", | |
471 "id": "Property", | |
472 "properties": { | |
473 "uint64Value": { | |
474 "description": "Value of numeric properties.", | |
475 "format": "uint64", | |
476 "type": "string" | |
477 }, | |
478 "name": { | |
479 "description": "Name of the property.", | |
480 "type": "string" | |
481 }, | |
482 "value": { | |
483 "description": "Value of the property.", | |
484 "type": "string" | |
485 } | |
486 }, | |
487 "type": "object" | |
488 }, | |
489 "LocationInfo": { | |
490 "description": "Detected entity location information.", | |
491 "id": "LocationInfo", | |
492 "properties": { | |
493 "latLng": { | |
494 "$ref": "LatLng", | |
495 "description": "lat/long location coordinates." | |
496 } | |
497 }, | |
498 "type": "object" | |
499 }, | |
500 "ImageSource": { | |
501 "description": "External image source (Google Cloud Storage image lo
cation).", | |
502 "id": "ImageSource", | |
503 "properties": { | |
504 "gcsImageUri": { | |
505 "description": "NOTE: For new code `image_uri` below is pref
erred.\nGoogle Cloud Storage image URI, which must be in the following form:\n`g
s://bucket_name/object_name` (for details, see\n[Google Cloud Storage Request\nU
RIs](https://cloud.google.com/storage/docs/reference-uris)).\nNOTE: Cloud Storag
e object versioning is not supported.", | |
506 "type": "string" | |
507 }, | |
508 "imageUri": { | |
509 "description": "Image URI which supports:\n1) Google Cloud S
torage image URI, which must be in the following form:\n`gs://bucket_name/object
_name` (for details, see\n[Google Cloud Storage Request\nURIs](https://cloud.goo
gle.com/storage/docs/reference-uris)).\nNOTE: Cloud Storage object versioning is
not supported.\n2) Publicly accessible image HTTP/HTTPS URL.\nThis is preferred
over the legacy `gcs_image_uri` above. When both\n`gcs_image_uri` and `image_ur
i` are specified, `image_uri` takes\nprecedence.", | |
510 "type": "string" | |
511 } | |
512 }, | |
513 "type": "object" | |
514 }, | |
515 "BatchAnnotateImagesResponse": { | |
516 "description": "Response to a batch image annotation request.", | |
517 "id": "BatchAnnotateImagesResponse", | |
518 "properties": { | |
519 "responses": { | |
520 "description": "Individual responses to image annotation req
uests within the batch.", | |
521 "items": { | |
522 "$ref": "AnnotateImageResponse" | |
523 }, | |
524 "type": "array" | |
525 } | |
526 }, | |
527 "type": "object" | |
528 }, | |
529 "WebDetection": { | |
530 "description": "Relevant information for the image from the Internet
.", | |
531 "id": "WebDetection", | |
532 "properties": { | |
533 "fullMatchingImages": { | |
534 "description": "Fully matching images from the Internet.\nCa
n include resized copies of the query image.", | |
535 "items": { | |
536 "$ref": "WebImage" | |
537 }, | |
538 "type": "array" | |
539 }, | |
540 "webEntities": { | |
541 "description": "Deduced entities from similar images on the
Internet.", | |
542 "items": { | |
543 "$ref": "WebEntity" | |
544 }, | |
545 "type": "array" | |
546 }, | |
547 "pagesWithMatchingImages": { | |
548 "description": "Web pages containing the matching images fro
m the Internet.", | |
549 "items": { | |
550 "$ref": "WebPage" | |
551 }, | |
552 "type": "array" | |
553 }, | |
554 "partialMatchingImages": { | |
555 "description": "Partial matching images from the Internet.\n
Those images are similar enough to share some key-point features. For\nexample a
n original image will likely have partial matching for its crops.", | |
556 "items": { | |
557 "$ref": "WebImage" | |
558 }, | |
559 "type": "array" | |
560 }, | |
561 "visuallySimilarImages": { | |
562 "description": "The visually similar image results.", | |
563 "items": { | |
564 "$ref": "WebImage" | |
565 }, | |
566 "type": "array" | |
567 } | |
568 }, | |
569 "type": "object" | |
570 }, | |
571 "Position": { | |
572 "description": "A 3D position in the image, used primarily for Face
detection landmarks.\nA valid Position must have both x and y coordinates.\nThe
position coordinates are in the same scale as the original image.", | |
573 "id": "Position", | |
574 "properties": { | |
575 "y": { | |
576 "description": "Y coordinate.", | |
577 "format": "float", | |
578 "type": "number" | |
579 }, | |
580 "x": { | |
581 "description": "X coordinate.", | |
582 "format": "float", | |
583 "type": "number" | |
584 }, | |
585 "z": { | |
586 "description": "Z coordinate (or depth).", | |
587 "format": "float", | |
588 "type": "number" | |
589 } | |
590 }, | |
591 "type": "object" | |
592 }, | |
593 "ColorInfo": { | |
594 "description": "Color information consists of RGB channels, score, a
nd the fraction of\nthe image that the color occupies in the image.", | |
595 "id": "ColorInfo", | |
596 "properties": { | |
597 "pixelFraction": { | |
598 "description": "The fraction of pixels the color occupies in
the image.\nValue in range [0, 1].", | |
599 "format": "float", | |
600 "type": "number" | |
601 }, | |
602 "color": { | |
603 "$ref": "Color", | |
604 "description": "RGB components of the color." | |
605 }, | |
606 "score": { | |
607 "description": "Image-specific score for this color. Value i
n range [0, 1].", | |
608 "format": "float", | |
609 "type": "number" | |
610 } | |
611 }, | |
612 "type": "object" | |
613 }, | |
614 "WebPage": { | |
615 "description": "Metadata for web pages.", | |
616 "id": "WebPage", | |
617 "properties": { | |
618 "url": { | |
619 "description": "The result web page URL.", | |
620 "type": "string" | |
621 }, | |
622 "score": { | |
623 "description": "Overall relevancy score for the web page.\nN
ot normalized and not comparable across different image queries.", | |
624 "format": "float", | |
625 "type": "number" | |
626 } | |
627 }, | |
628 "type": "object" | |
629 }, | |
630 "EntityAnnotation": { | |
631 "description": "Set of detected entity features.", | |
632 "id": "EntityAnnotation", | |
633 "properties": { | |
634 "score": { | |
635 "description": "Overall score of the result. Range [0, 1].", | |
636 "format": "float", | |
637 "type": "number" | |
638 }, | |
639 "locations": { | |
640 "description": "The location information for the detected en
tity. Multiple\n`LocationInfo` elements can be present because one location may\
nindicate the location of the scene in the image, and another location\nmay indi
cate the location of the place where the image was taken.\nLocation information
is usually present for landmarks.", | |
641 "items": { | |
642 "$ref": "LocationInfo" | |
643 }, | |
644 "type": "array" | |
645 }, | |
646 "mid": { | |
647 "description": "Opaque entity ID. Some IDs may be available
in\n[Google Knowledge Graph Search API](https://developers.google.com/knowledge-
graph/).", | |
648 "type": "string" | |
649 }, | |
650 "confidence": { | |
651 "description": "The accuracy of the entity detection in an i
mage.\nFor example, for an image in which the \"Eiffel Tower\" entity is detecte
d,\nthis field represents the confidence that there is a tower in the query\nima
ge. Range [0, 1].", | |
652 "format": "float", | |
653 "type": "number" | |
654 }, | |
655 "locale": { | |
656 "description": "The language code for the locale in which th
e entity textual\n`description` is expressed.", | |
657 "type": "string" | |
658 }, | |
659 "boundingPoly": { | |
660 "$ref": "BoundingPoly", | |
661 "description": "Image region to which this entity belongs. N
ot produced\nfor `LABEL_DETECTION` features." | |
662 }, | |
663 "description": { | |
664 "description": "Entity textual description, expressed in its
`locale` language.", | |
665 "type": "string" | |
666 }, | |
667 "topicality": { | |
668 "description": "The relevancy of the ICA (Image Content Anno
tation) label to the\nimage. For example, the relevancy of \"tower\" is likely h
igher to an image\ncontaining the detected \"Eiffel Tower\" than to an image con
taining a\ndetected distant towering building, even though the confidence that\n
there is a tower in each image may be the same. Range [0, 1].", | |
669 "format": "float", | |
670 "type": "number" | |
671 }, | |
672 "properties": { | |
673 "description": "Some entities may have optional user-supplie
d `Property` (name/value)\nfields, such a score or string that qualifies the ent
ity.", | |
674 "items": { | |
675 "$ref": "Property" | |
676 }, | |
677 "type": "array" | |
678 } | |
679 }, | |
680 "type": "object" | |
681 }, | |
682 "CropHint": { | 146 "CropHint": { |
683 "description": "Single crop hint that is used to generate a new crop
when serving an image.", | 147 "description": "Single crop hint that is used to generate a new crop
when serving an image.", |
684 "id": "CropHint", | 148 "id": "CropHint", |
685 "properties": { | 149 "properties": { |
| 150 "importanceFraction": { |
| 151 "description": "Fraction of importance of this salient regio
n with respect to the original\nimage.", |
| 152 "format": "float", |
| 153 "type": "number" |
| 154 }, |
686 "confidence": { | 155 "confidence": { |
687 "description": "Confidence of this being a salient region.
Range [0, 1].", | 156 "description": "Confidence of this being a salient region.
Range [0, 1].", |
688 "format": "float", | 157 "format": "float", |
689 "type": "number" | 158 "type": "number" |
690 }, | 159 }, |
691 "importanceFraction": { | |
692 "description": "Fraction of importance of this salient regio
n with respect to the original\nimage.", | |
693 "format": "float", | |
694 "type": "number" | |
695 }, | |
696 "boundingPoly": { | 160 "boundingPoly": { |
697 "$ref": "BoundingPoly", | 161 "$ref": "BoundingPoly", |
698 "description": "The bounding polygon for the crop region. Th
e coordinates of the bounding\nbox are in the original image's scale, as returne
d in `ImageParams`." | 162 "description": "The bounding polygon for the crop region. Th
e coordinates of the bounding\nbox are in the original image's scale, as returne
d in `ImageParams`." |
699 } | 163 } |
700 }, | 164 }, |
701 "type": "object" | 165 "type": "object" |
702 }, | 166 }, |
703 "Landmark": { | 167 "Landmark": { |
704 "description": "A face-specific landmark (for example, a face featur
e).\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`.", | 168 "description": "A face-specific landmark (for example, a face featur
e).\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`.", |
705 "id": "Landmark", | 169 "id": "Landmark", |
(...skipping 96 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
802 "description": "The result image URL.", | 266 "description": "The result image URL.", |
803 "type": "string" | 267 "type": "string" |
804 } | 268 } |
805 }, | 269 }, |
806 "type": "object" | 270 "type": "object" |
807 }, | 271 }, |
808 "Word": { | 272 "Word": { |
809 "description": "A word representation.", | 273 "description": "A word representation.", |
810 "id": "Word", | 274 "id": "Word", |
811 "properties": { | 275 "properties": { |
| 276 "property": { |
| 277 "$ref": "TextProperty", |
| 278 "description": "Additional information detected for the word
." |
| 279 }, |
812 "boundingBox": { | 280 "boundingBox": { |
813 "$ref": "BoundingPoly", | 281 "$ref": "BoundingPoly", |
814 "description": "The bounding box for the word.\nThe vertices
are in the order of top-left, top-right, bottom-right,\nbottom-left. When a rot
ation of the bounding box is detected the rotation\nis represented as around the
top-left corner as defined when the text is\nread in the 'natural' orientation.
\nFor example:\n * when the text is horizontal it might look like:\n 0----1
\n | |\n 3----2\n * when it's rotated 180 degrees around the top-lef
t corner it becomes:\n 2----3\n | |\n 1----0\n and the vertice o
rder will still be (0, 1, 2, 3)." | 282 "description": "The bounding box for the word.\nThe vertices
are in the order of top-left, top-right, bottom-right,\nbottom-left. When a rot
ation of the bounding box is detected the rotation\nis represented as around the
top-left corner as defined when the text is\nread in the 'natural' orientation.
\nFor example:\n * when the text is horizontal it might look like:\n 0----1
\n | |\n 3----2\n * when it's rotated 180 degrees around the top-lef
t corner it becomes:\n 2----3\n | |\n 1----0\n and the vertice o
rder will still be (0, 1, 2, 3)." |
815 }, | 283 }, |
816 "symbols": { | 284 "symbols": { |
817 "description": "List of symbols in the word.\nThe order of t
he symbols follows the natural reading order.", | 285 "description": "List of symbols in the word.\nThe order of t
he symbols follows the natural reading order.", |
818 "items": { | 286 "items": { |
819 "$ref": "Symbol" | 287 "$ref": "Symbol" |
820 }, | 288 }, |
821 "type": "array" | 289 "type": "array" |
822 }, | |
823 "property": { | |
824 "$ref": "TextProperty", | |
825 "description": "Additional information detected for the word
." | |
826 } | 290 } |
827 }, | 291 }, |
828 "type": "object" | 292 "type": "object" |
829 }, | 293 }, |
830 "Paragraph": { | 294 "Paragraph": { |
831 "description": "Structural unit of text representing a number of wor
ds in certain order.", | 295 "description": "Structural unit of text representing a number of wor
ds in certain order.", |
832 "id": "Paragraph", | 296 "id": "Paragraph", |
833 "properties": { | 297 "properties": { |
834 "property": { | 298 "property": { |
835 "$ref": "TextProperty", | 299 "$ref": "TextProperty", |
(...skipping 10 matching lines...) Expand all Loading... |
846 }, | 310 }, |
847 "type": "array" | 311 "type": "array" |
848 } | 312 } |
849 }, | 313 }, |
850 "type": "object" | 314 "type": "object" |
851 }, | 315 }, |
852 "Image": { | 316 "Image": { |
853 "description": "Client image to perform Google Cloud Vision API task
s over.", | 317 "description": "Client image to perform Google Cloud Vision API task
s over.", |
854 "id": "Image", | 318 "id": "Image", |
855 "properties": { | 319 "properties": { |
| 320 "source": { |
| 321 "$ref": "ImageSource", |
| 322 "description": "Google Cloud Storage image location. If both
`content` and `source`\nare provided for an image, `content` takes precedence a
nd is\nused to perform the image annotation request." |
| 323 }, |
856 "content": { | 324 "content": { |
857 "description": "Image content, represented as a stream of by
tes.\nNote: as with all `bytes` fields, protobuffers use a pure binary\nrepresen
tation, whereas JSON representations use base64.", | 325 "description": "Image content, represented as a stream of by
tes.\nNote: as with all `bytes` fields, protobuffers use a pure binary\nrepresen
tation, whereas JSON representations use base64.", |
858 "format": "byte", | 326 "format": "byte", |
859 "type": "string" | 327 "type": "string" |
860 }, | |
861 "source": { | |
862 "$ref": "ImageSource", | |
863 "description": "Google Cloud Storage image location. If both
`content` and `source`\nare provided for an image, `content` takes precedence a
nd is\nused to perform the image annotation request." | |
864 } | 328 } |
865 }, | 329 }, |
866 "type": "object" | 330 "type": "object" |
867 }, | 331 }, |
868 "FaceAnnotation": { | 332 "FaceAnnotation": { |
869 "description": "A face annotation object contains the results of fac
e detection.", | 333 "description": "A face annotation object contains the results of fac
e detection.", |
870 "id": "FaceAnnotation", | 334 "id": "FaceAnnotation", |
871 "properties": { | 335 "properties": { |
872 "underExposedLikelihood": { | 336 "tiltAngle": { |
873 "description": "Under-exposed likelihood.", | 337 "description": "Pitch angle, which indicates the upwards/dow
nwards angle that the face is\npointing relative to the image's horizontal plane
. Range [-180,180].", |
| 338 "format": "float", |
| 339 "type": "number" |
| 340 }, |
| 341 "fdBoundingPoly": { |
| 342 "$ref": "BoundingPoly", |
| 343 "description": "The `fd_bounding_poly` bounding polygon is t
ighter than the\n`boundingPoly`, and encloses only the skin part of the face. Ty
pically, 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 de
tection) prefix." |
| 344 }, |
| 345 "surpriseLikelihood": { |
| 346 "description": "Surprise likelihood.", |
874 "enum": [ | 347 "enum": [ |
875 "UNKNOWN", | 348 "UNKNOWN", |
876 "VERY_UNLIKELY", | 349 "VERY_UNLIKELY", |
877 "UNLIKELY", | 350 "UNLIKELY", |
878 "POSSIBLE", | 351 "POSSIBLE", |
879 "LIKELY", | 352 "LIKELY", |
880 "VERY_LIKELY" | 353 "VERY_LIKELY" |
881 ], | 354 ], |
882 "enumDescriptions": [ | 355 "enumDescriptions": [ |
883 "Unknown likelihood.", | 356 "Unknown likelihood.", |
884 "It is very unlikely that the image belongs to the speci
fied vertical.", | 357 "It is very unlikely that the image belongs to the speci
fied vertical.", |
885 "It is unlikely that the image belongs to the specified
vertical.", | 358 "It is unlikely that the image belongs to the specified
vertical.", |
886 "It is possible that the image belongs to the specified
vertical.", | 359 "It is possible that the image belongs to the specified
vertical.", |
887 "It is likely that the image belongs to the specified ve
rtical.", | 360 "It is likely that the image belongs to the specified ve
rtical.", |
888 "It is very likely that the image belongs to the specifi
ed vertical." | 361 "It is very likely that the image belongs to the specifi
ed vertical." |
889 ], | 362 ], |
890 "type": "string" | 363 "type": "string" |
891 }, | 364 }, |
892 "panAngle": { | 365 "landmarks": { |
893 "description": "Yaw angle, which indicates the leftward/righ
tward angle that the face is\npointing relative to the vertical plane perpendicu
lar to the image. Range\n[-180,180].", | 366 "description": "Detected face landmarks.", |
894 "format": "float", | 367 "items": { |
895 "type": "number" | 368 "$ref": "Landmark" |
896 }, | 369 }, |
897 "detectionConfidence": { | 370 "type": "array" |
898 "description": "Detection confidence. Range [0, 1].", | 371 }, |
899 "format": "float", | 372 "angerLikelihood": { |
900 "type": "number" | 373 "description": "Anger likelihood.", |
901 }, | |
902 "blurredLikelihood": { | |
903 "description": "Blurred likelihood.", | |
904 "enum": [ | 374 "enum": [ |
905 "UNKNOWN", | 375 "UNKNOWN", |
906 "VERY_UNLIKELY", | 376 "VERY_UNLIKELY", |
907 "UNLIKELY", | 377 "UNLIKELY", |
908 "POSSIBLE", | 378 "POSSIBLE", |
909 "LIKELY", | 379 "LIKELY", |
910 "VERY_LIKELY" | 380 "VERY_LIKELY" |
911 ], | 381 ], |
912 "enumDescriptions": [ | 382 "enumDescriptions": [ |
913 "Unknown likelihood.", | 383 "Unknown likelihood.", |
914 "It is very unlikely that the image belongs to the speci
fied vertical.", | 384 "It is very unlikely that the image belongs to the speci
fied vertical.", |
915 "It is unlikely that the image belongs to the specified
vertical.", | 385 "It is unlikely that the image belongs to the specified
vertical.", |
916 "It is possible that the image belongs to the specified
vertical.", | 386 "It is possible that the image belongs to the specified
vertical.", |
917 "It is likely that the image belongs to the specified ve
rtical.", | 387 "It is likely that the image belongs to the specified ve
rtical.", |
918 "It is very likely that the image belongs to the specifi
ed vertical." | 388 "It is very likely that the image belongs to the specifi
ed vertical." |
919 ], | 389 ], |
920 "type": "string" | 390 "type": "string" |
921 }, | 391 }, |
| 392 "joyLikelihood": { |
| 393 "description": "Joy likelihood.", |
| 394 "enum": [ |
| 395 "UNKNOWN", |
| 396 "VERY_UNLIKELY", |
| 397 "UNLIKELY", |
| 398 "POSSIBLE", |
| 399 "LIKELY", |
| 400 "VERY_LIKELY" |
| 401 ], |
| 402 "enumDescriptions": [ |
| 403 "Unknown likelihood.", |
| 404 "It is very unlikely that the image belongs to the speci
fied vertical.", |
| 405 "It is unlikely that the image belongs to the specified
vertical.", |
| 406 "It is possible that the image belongs to the specified
vertical.", |
| 407 "It is likely that the image belongs to the specified ve
rtical.", |
| 408 "It is very likely that the image belongs to the specifi
ed vertical." |
| 409 ], |
| 410 "type": "string" |
| 411 }, |
| 412 "landmarkingConfidence": { |
| 413 "description": "Face landmarking confidence. Range [0, 1].", |
| 414 "format": "float", |
| 415 "type": "number" |
| 416 }, |
| 417 "detectionConfidence": { |
| 418 "description": "Detection confidence. Range [0, 1].", |
| 419 "format": "float", |
| 420 "type": "number" |
| 421 }, |
| 422 "panAngle": { |
| 423 "description": "Yaw angle, which indicates the leftward/righ
tward angle that the face is\npointing relative to the vertical plane perpendicu
lar to the image. Range\n[-180,180].", |
| 424 "format": "float", |
| 425 "type": "number" |
| 426 }, |
| 427 "underExposedLikelihood": { |
| 428 "description": "Under-exposed likelihood.", |
| 429 "enum": [ |
| 430 "UNKNOWN", |
| 431 "VERY_UNLIKELY", |
| 432 "UNLIKELY", |
| 433 "POSSIBLE", |
| 434 "LIKELY", |
| 435 "VERY_LIKELY" |
| 436 ], |
| 437 "enumDescriptions": [ |
| 438 "Unknown likelihood.", |
| 439 "It is very unlikely that the image belongs to the speci
fied vertical.", |
| 440 "It is unlikely that the image belongs to the specified
vertical.", |
| 441 "It is possible that the image belongs to the specified
vertical.", |
| 442 "It is likely that the image belongs to the specified ve
rtical.", |
| 443 "It is very likely that the image belongs to the specifi
ed vertical." |
| 444 ], |
| 445 "type": "string" |
| 446 }, |
| 447 "blurredLikelihood": { |
| 448 "description": "Blurred likelihood.", |
| 449 "enum": [ |
| 450 "UNKNOWN", |
| 451 "VERY_UNLIKELY", |
| 452 "UNLIKELY", |
| 453 "POSSIBLE", |
| 454 "LIKELY", |
| 455 "VERY_LIKELY" |
| 456 ], |
| 457 "enumDescriptions": [ |
| 458 "Unknown likelihood.", |
| 459 "It is very unlikely that the image belongs to the speci
fied vertical.", |
| 460 "It is unlikely that the image belongs to the specified
vertical.", |
| 461 "It is possible that the image belongs to the specified
vertical.", |
| 462 "It is likely that the image belongs to the specified ve
rtical.", |
| 463 "It is very likely that the image belongs to the specifi
ed vertical." |
| 464 ], |
| 465 "type": "string" |
| 466 }, |
922 "headwearLikelihood": { | 467 "headwearLikelihood": { |
923 "description": "Headwear likelihood.", | 468 "description": "Headwear likelihood.", |
924 "enum": [ | 469 "enum": [ |
925 "UNKNOWN", | 470 "UNKNOWN", |
926 "VERY_UNLIKELY", | 471 "VERY_UNLIKELY", |
| 472 "UNLIKELY", |
| 473 "POSSIBLE", |
| 474 "LIKELY", |
| 475 "VERY_LIKELY" |
| 476 ], |
| 477 "enumDescriptions": [ |
| 478 "Unknown likelihood.", |
| 479 "It is very unlikely that the image belongs to the speci
fied vertical.", |
| 480 "It is unlikely that the image belongs to the specified
vertical.", |
| 481 "It is possible that the image belongs to the specified
vertical.", |
| 482 "It is likely that the image belongs to the specified ve
rtical.", |
| 483 "It is very likely that the image belongs to the specifi
ed vertical." |
| 484 ], |
| 485 "type": "string" |
| 486 }, |
| 487 "boundingPoly": { |
| 488 "$ref": "BoundingPoly", |
| 489 "description": "The bounding polygon around the face. The co
ordinates 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 accordanc
e with human\nexpectations. It is based on the landmarker results.\nNote that on
e or more x and/or y coordinates may not be generated in the\n`BoundingPoly` (th
e polygon will be unbounded) if only a partial face\nappears in the image to be
annotated." |
| 490 }, |
| 491 "rollAngle": { |
| 492 "description": "Roll angle, which indicates the amount of cl
ockwise/anti-clockwise rotation\nof the face relative to the image vertical abou
t the axis perpendicular to\nthe face. Range [-180,180].", |
| 493 "format": "float", |
| 494 "type": "number" |
| 495 }, |
| 496 "sorrowLikelihood": { |
| 497 "description": "Sorrow likelihood.", |
| 498 "enum": [ |
| 499 "UNKNOWN", |
| 500 "VERY_UNLIKELY", |
| 501 "UNLIKELY", |
| 502 "POSSIBLE", |
| 503 "LIKELY", |
| 504 "VERY_LIKELY" |
| 505 ], |
| 506 "enumDescriptions": [ |
| 507 "Unknown likelihood.", |
| 508 "It is very unlikely that the image belongs to the speci
fied vertical.", |
| 509 "It is unlikely that the image belongs to the specified
vertical.", |
| 510 "It is possible that the image belongs to the specified
vertical.", |
| 511 "It is likely that the image belongs to the specified ve
rtical.", |
| 512 "It is very likely that the image belongs to the specifi
ed vertical." |
| 513 ], |
| 514 "type": "string" |
| 515 } |
| 516 }, |
| 517 "type": "object" |
| 518 }, |
| 519 "BatchAnnotateImagesRequest": { |
| 520 "description": "Multiple image annotation requests are batched into
a single service call.", |
| 521 "id": "BatchAnnotateImagesRequest", |
| 522 "properties": { |
| 523 "requests": { |
| 524 "description": "Individual image annotation requests for thi
s batch.", |
| 525 "items": { |
| 526 "$ref": "AnnotateImageRequest" |
| 527 }, |
| 528 "type": "array" |
| 529 } |
| 530 }, |
| 531 "type": "object" |
| 532 }, |
| 533 "DetectedBreak": { |
| 534 "description": "Detected start or end of a structural component.", |
| 535 "id": "DetectedBreak", |
| 536 "properties": { |
| 537 "isPrefix": { |
| 538 "description": "True if break prepends the element.", |
| 539 "type": "boolean" |
| 540 }, |
| 541 "type": { |
| 542 "description": "Detected break type.", |
| 543 "enum": [ |
| 544 "UNKNOWN", |
| 545 "SPACE", |
| 546 "SURE_SPACE", |
| 547 "EOL_SURE_SPACE", |
| 548 "HYPHEN", |
| 549 "LINE_BREAK" |
| 550 ], |
| 551 "enumDescriptions": [ |
| 552 "Unknown break label type.", |
| 553 "Regular space.", |
| 554 "Sure space (very wide).", |
| 555 "Line-wrapping break.", |
| 556 "End-line hyphen that is not present in text; does not c
o-occur with\n`SPACE`, `LEADER_SPACE`, or `LINE_BREAK`.", |
| 557 "Line break that ends a paragraph." |
| 558 ], |
| 559 "type": "string" |
| 560 } |
| 561 }, |
| 562 "type": "object" |
| 563 }, |
| 564 "ImageContext": { |
| 565 "description": "Image context and/or feature-specific parameters.", |
| 566 "id": "ImageContext", |
| 567 "properties": { |
| 568 "latLongRect": { |
| 569 "$ref": "LatLongRect", |
| 570 "description": "lat/long rectangle that specifies the locati
on of the image." |
| 571 }, |
| 572 "cropHintsParams": { |
| 573 "$ref": "CropHintsParams", |
| 574 "description": "Parameters for crop hints annotation request
." |
| 575 }, |
| 576 "languageHints": { |
| 577 "description": "List of languages to use for TEXT_DETECTION.
In most cases, an empty value\nyields the best results since it enables automat
ic language detection. For\nlanguages based on the Latin alphabet, setting `lang
uage_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 b
e a\nsignificant hindrance if the hint is wrong). Text detection returns an\nerr
or if one or more of the specified languages is not one of the\n[supported langu
ages](/vision/docs/languages).", |
| 578 "items": { |
| 579 "type": "string" |
| 580 }, |
| 581 "type": "array" |
| 582 } |
| 583 }, |
| 584 "type": "object" |
| 585 }, |
| 586 "Page": { |
| 587 "description": "Detected page from OCR.", |
| 588 "id": "Page", |
| 589 "properties": { |
| 590 "width": { |
| 591 "description": "Page width in pixels.", |
| 592 "format": "int32", |
| 593 "type": "integer" |
| 594 }, |
| 595 "blocks": { |
| 596 "description": "List of blocks of text, images etc on this p
age.", |
| 597 "items": { |
| 598 "$ref": "Block" |
| 599 }, |
| 600 "type": "array" |
| 601 }, |
| 602 "property": { |
| 603 "$ref": "TextProperty", |
| 604 "description": "Additional information detected on the page.
" |
| 605 }, |
| 606 "height": { |
| 607 "description": "Page height in pixels.", |
| 608 "format": "int32", |
| 609 "type": "integer" |
| 610 } |
| 611 }, |
| 612 "type": "object" |
| 613 }, |
| 614 "AnnotateImageRequest": { |
| 615 "description": "Request for performing Google Cloud Vision API tasks
over a user-provided\nimage, with user-requested features.", |
| 616 "id": "AnnotateImageRequest", |
| 617 "properties": { |
| 618 "features": { |
| 619 "description": "Requested features.", |
| 620 "items": { |
| 621 "$ref": "Feature" |
| 622 }, |
| 623 "type": "array" |
| 624 }, |
| 625 "image": { |
| 626 "$ref": "Image", |
| 627 "description": "The image to be processed." |
| 628 }, |
| 629 "imageContext": { |
| 630 "$ref": "ImageContext", |
| 631 "description": "Additional context that may accompany the im
age." |
| 632 } |
| 633 }, |
| 634 "type": "object" |
| 635 }, |
| 636 "Status": { |
| 637 "description": "The `Status` type defines a logical error model that
is suitable for different\nprogramming environments, including REST APIs and RP
C APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is desig
ned to be:\n\n- Simple to use and understand for most users\n- Flexible enough t
o meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pie
ces of data: error code, error message,\nand error details. The error code shoul
d be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes
if needed. The\nerror message should be a developer-facing English message tha
t helps\ndevelopers *understand* and *resolve* the error. If a localized user-fa
cing\nerror message is needed, put the localized message in the error details or
\nlocalize it in the client. The optional error details may contain arbitrary\ni
nformation about the error. There is a predefined set of error detail types\nin
the package `google.rpc` that can be used for common error conditions.\n\n# Lang
uage mapping\n\nThe `Status` message is the logical representation of the error
model, but it\nis not necessarily the actual wire format. When the `Status` mess
age is\nexposed in different client libraries and different wire protocols, it c
an be\nmapped differently. For example, it will likely be mapped to some excepti
ons\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n
\nThe error model and the `Status` message can be used in a variety of\nenvironm
ents, either with or without APIs, to provide a\nconsistent developer experience
across different environments.\n\nExample uses of this error model include:\n\n
- Partial errors. If a service needs to return partial errors to the client,\n
it may embed the `Status` in the normal response to indicate the partial\n
errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step m
ay\n have a `Status` message for error reporting.\n\n- Batch operations. If a
client uses batch request and batch response, the\n `Status` message should
be used directly inside batch response, one for\n each error sub-response.\n\
n- Asynchronous operations. If an API call embeds asynchronous operation\n re
sults in its response, the status of those operations should be\n represented
directly using the `Status` message.\n\n- Logging. If some API errors are store
d in logs, the message `Status` could\n be used directly after any stripping
needed for security/privacy reasons.", |
| 638 "id": "Status", |
| 639 "properties": { |
| 640 "code": { |
| 641 "description": "The status code, which should be an enum val
ue of google.rpc.Code.", |
| 642 "format": "int32", |
| 643 "type": "integer" |
| 644 }, |
| 645 "message": { |
| 646 "description": "A developer-facing error message, which shou
ld be in English. Any\nuser-facing error message should be localized and sent in
the\ngoogle.rpc.Status.details field, or localized by the client.", |
| 647 "type": "string" |
| 648 }, |
| 649 "details": { |
| 650 "description": "A list of messages that carry the error deta
ils. There will be a\ncommon set of message types for APIs to use.", |
| 651 "items": { |
| 652 "additionalProperties": { |
| 653 "description": "Properties of the object. Contains f
ield @type with type URL.", |
| 654 "type": "any" |
| 655 }, |
| 656 "type": "object" |
| 657 }, |
| 658 "type": "array" |
| 659 } |
| 660 }, |
| 661 "type": "object" |
| 662 }, |
| 663 "LatLongRect": { |
| 664 "description": "Rectangle determined by min and max `LatLng` pairs."
, |
| 665 "id": "LatLongRect", |
| 666 "properties": { |
| 667 "minLatLng": { |
| 668 "$ref": "LatLng", |
| 669 "description": "Min lat/long pair." |
| 670 }, |
| 671 "maxLatLng": { |
| 672 "$ref": "LatLng", |
| 673 "description": "Max lat/long pair." |
| 674 } |
| 675 }, |
| 676 "type": "object" |
| 677 }, |
| 678 "Symbol": { |
| 679 "description": "A single symbol representation.", |
| 680 "id": "Symbol", |
| 681 "properties": { |
| 682 "boundingBox": { |
| 683 "$ref": "BoundingPoly", |
| 684 "description": "The bounding box for the symbol.\nThe vertic
es are in the order of top-left, top-right, bottom-right,\nbottom-left. When a r
otation of the bounding box is detected the rotation\nis represented as around t
he top-left corner as defined when the text is\nread in the 'natural' orientatio
n.\nFor example:\n * when the text is horizontal it might look like:\n 0---
-1\n | |\n 3----2\n * when it's rotated 180 degrees around the top-l
eft corner it becomes:\n 2----3\n | |\n 1----0\n and the vertice
order will still be (0, 1, 2, 3)." |
| 685 }, |
| 686 "text": { |
| 687 "description": "The actual UTF-8 representation of the symbo
l.", |
| 688 "type": "string" |
| 689 }, |
| 690 "property": { |
| 691 "$ref": "TextProperty", |
| 692 "description": "Additional information detected for the symb
ol." |
| 693 } |
| 694 }, |
| 695 "type": "object" |
| 696 }, |
| 697 "CropHintsAnnotation": { |
| 698 "description": "Set of crop hints that are used to generate new crop
s when serving images.", |
| 699 "id": "CropHintsAnnotation", |
| 700 "properties": { |
| 701 "cropHints": { |
| 702 "description": "Crop hint results.", |
| 703 "items": { |
| 704 "$ref": "CropHint" |
| 705 }, |
| 706 "type": "array" |
| 707 } |
| 708 }, |
| 709 "type": "object" |
| 710 }, |
| 711 "LatLng": { |
| 712 "description": "An object representing a latitude/longitude pair. Th
is is expressed as a pair\nof doubles representing degrees latitude and degrees
longitude. Unless\nspecified otherwise, this must conform to the\n<a href=\"http
://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf\">WGS84\nstandard</a>. Values
must be within normalized ranges.\n\nExample of normalization code in Python:\n
\n def NormalizeLongitude(longitude):\n \"\"\"Wraps decimal degrees long
itude to [-180.0, 180.0].\"\"\"\n q, r = divmod(longitude, 360.0)\n if
r > 180.0 or (r == 180.0 and q <= -1.0):\n return r - 360.0\n retur
n 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], resp
ectively.\"\"\"\n r = latitude % 360.0\n if r <= 90.0:\n return
r, NormalizeLongitude(longitude)\n elif r >= 270.0:\n return r - 36
0, NormalizeLongitude(longitude)\n else:\n return 180 - r, Normalize
Longitude(longitude + 180.0)\n\n assert 180.0 == NormalizeLongitude(180.0)\n
assert -180.0 == NormalizeLongitude(-180.0)\n assert -179.0 == NormalizeLo
ngitude(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) == Normali
zeLatLng(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 as
sert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0)\n assert (90.0, 10.0) == N
ormalizeLatLng(-270.0, 10.0)", |
| 713 "id": "LatLng", |
| 714 "properties": { |
| 715 "latitude": { |
| 716 "description": "The latitude in degrees. It must be in the r
ange [-90.0, +90.0].", |
| 717 "format": "double", |
| 718 "type": "number" |
| 719 }, |
| 720 "longitude": { |
| 721 "description": "The longitude in degrees. It must be in the
range [-180.0, +180.0].", |
| 722 "format": "double", |
| 723 "type": "number" |
| 724 } |
| 725 }, |
| 726 "type": "object" |
| 727 }, |
| 728 "Color": { |
| 729 "description": "Represents a color in the RGBA color space. This rep
resentation is designed\nfor simplicity of conversion to/from color representati
ons in various\nlanguages over compactness; for example, the fields of this repr
esentation\ncan be trivially provided to the constructor of \"java.awt.Color\" i
n Java; it\ncan also be trivially provided to UIColor's \"+colorWithRed:green:bl
ue:alpha\"\nmethod in iOS; and, with just a little work, it can be easily format
ted into\na CSS \"rgba()\" string in JavaScript, as well. Here are some examples
:\n\nExample (Java):\n\n import com.google.type.Color;\n\n // ...\n
public static java.awt.Color fromProto(Color protocolor) {\n float alpha =
protocolor.hasAlpha()\n ? protocolor.getAlpha().getValue()\n
: 1.0;\n\n return new java.awt.Color(\n protocolor.getRed(),\n
protocolor.getGreen(),\n protocolor.getBlue(),\n
alpha);\n }\n\n public static Color toProto(java.awt.Color color) {\n
float red = (float) color.getRed();\n float green = (float) color.getG
reen();\n float blue = (float) color.getBlue();\n float denominator
= 255.0;\n Color.Builder resultBuilder =\n Color\n
.newBuilder()\n .setRed(red / denominator)\n .setGr
een(green / denominator)\n .setBlue(blue / denominator);\n i
nt alpha = color.getAlpha();\n if (alpha != 255) {\n result.setAlp
ha(\n FloatValue\n .newBuilder()\n .
setValue(((float) alpha) / denominator)\n .build());\n }\n
return resultBuilder.build();\n }\n // ...\n\nExample (iOS / Obj-
C):\n\n // ...\n static UIColor* fromProto(Color* protocolor) {\n
float red = [protocolor red];\n float green = [protocolor green];\n
float blue = [protocolor blue];\n FloatValue* alpha_wrapper = [protoco
lor alpha];\n float alpha = 1.0;\n if (alpha_wrapper != nil) {\n
alpha = [alpha_wrapper value];\n }\n return [UIColor color
WithRed:red green:green blue:blue alpha:alpha];\n }\n\n static Color* to
Proto(UIColor* color) {\n CGFloat red, green, blue, alpha;\n if
(![color getRed:&red green:&green blue:&blue alpha:&alpha]) {\n return
nil;\n }\n Color* result = [Color alloc] init];\n [resu
lt setRed:red];\n [result setGreen:green];\n [result setBlue:blu
e];\n if (alpha <= 0.9999) {\n [result setAlpha:floatWrapperWi
thValue(alpha)];\n }\n [result autorelease];\n return re
sult;\n }\n // ...\n\n Example (JavaScript):\n\n // ...\n\n var prot
oToCssColor = function(rgb_color) {\n var redFrac = rgb_color.red || 0.0;\
n var greenFrac = rgb_color.green || 0.0;\n var blueFrac = rgb_color
.blue || 0.0;\n var red = Math.floor(redFrac * 255);\n var green = M
ath.floor(greenFrac * 255);\n var blue = Math.floor(blueFrac * 255);\n\n
if (!('alpha' in rgb_color)) {\n return rgbToCssColor_(red, green,
blue);\n }\n\n var alphaFrac = rgb_color.alpha.value || 0.0;\n
var rgbParams = [red, green, blue].join(',');\n return ['rgba(', rgbPara
ms, ',', alphaFrac, ')'].join('');\n };\n\n var rgbToCssColor_ = function(
red, green, blue) {\n var rgbNumber = new Number((red << 16) | (green << 8)
| blue);\n var hexString = rgbNumber.toString(16);\n var missingZeros
= 6 - hexString.length;\n var resultBuilder = ['#'];\n for (var i = 0
; i < missingZeros; i++) {\n resultBuilder.push('0');\n }\n re
sultBuilder.push(hexString);\n return resultBuilder.join('');\n };\n\n
// ...", |
| 730 "id": "Color", |
| 731 "properties": { |
| 732 "red": { |
| 733 "description": "The amount of red in the color as a value in
the interval [0, 1].", |
| 734 "format": "float", |
| 735 "type": "number" |
| 736 }, |
| 737 "alpha": { |
| 738 "description": "The fraction of this color that should be ap
plied to the pixel. That is,\nthe final pixel color is defined by the equation:\
n\n pixel color = alpha * (this color) + (1.0 - alpha) * (background color)\n\n
This means that a value of 1.0 corresponds to a solid color, whereas\na value of
0.0 corresponds to a completely transparent color. This\nuses a wrapper message
rather than a simple float scalar so that it is\npossible to distinguish betwee
n a default value and the value being unset.\nIf omitted, this color object is t
o be rendered as a solid color\n(as if the alpha value had been explicitly given
with a value of 1.0).", |
| 739 "format": "float", |
| 740 "type": "number" |
| 741 }, |
| 742 "blue": { |
| 743 "description": "The amount of blue in the color as a value i
n the interval [0, 1].", |
| 744 "format": "float", |
| 745 "type": "number" |
| 746 }, |
| 747 "green": { |
| 748 "description": "The amount of green in the color as a value
in the interval [0, 1].", |
| 749 "format": "float", |
| 750 "type": "number" |
| 751 } |
| 752 }, |
| 753 "type": "object" |
| 754 }, |
| 755 "Feature": { |
| 756 "description": "Users describe the type of Google Cloud Vision API t
asks 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\nverti
cal to operate on and the number of top-scoring results to return.", |
| 757 "id": "Feature", |
| 758 "properties": { |
| 759 "maxResults": { |
| 760 "description": "Maximum number of results of this type.", |
| 761 "format": "int32", |
| 762 "type": "integer" |
| 763 }, |
| 764 "type": { |
| 765 "description": "The feature type.", |
| 766 "enum": [ |
| 767 "TYPE_UNSPECIFIED", |
| 768 "FACE_DETECTION", |
| 769 "LANDMARK_DETECTION", |
| 770 "LOGO_DETECTION", |
| 771 "LABEL_DETECTION", |
| 772 "TEXT_DETECTION", |
| 773 "DOCUMENT_TEXT_DETECTION", |
| 774 "SAFE_SEARCH_DETECTION", |
| 775 "IMAGE_PROPERTIES", |
| 776 "CROP_HINTS", |
| 777 "WEB_DETECTION" |
| 778 ], |
| 779 "enumDescriptions": [ |
| 780 "Unspecified feature type.", |
| 781 "Run face detection.", |
| 782 "Run landmark detection.", |
| 783 "Run logo detection.", |
| 784 "Run label detection.", |
| 785 "Run OCR.", |
| 786 "Run dense text document OCR. Takes precedence when both
\nDOCUMENT_TEXT_DETECTION and TEXT_DETECTION are present.", |
| 787 "Run computer vision models to compute image safe-search
properties.", |
| 788 "Compute a set of image properties, such as the image's
dominant colors.", |
| 789 "Run crop hints.", |
| 790 "Run web detection." |
| 791 ], |
| 792 "type": "string" |
| 793 } |
| 794 }, |
| 795 "type": "object" |
| 796 }, |
| 797 "ImageProperties": { |
| 798 "description": "Stores image properties, such as dominant colors.", |
| 799 "id": "ImageProperties", |
| 800 "properties": { |
| 801 "dominantColors": { |
| 802 "$ref": "DominantColorsAnnotation", |
| 803 "description": "If present, dominant colors completed succes
sfully." |
| 804 } |
| 805 }, |
| 806 "type": "object" |
| 807 }, |
| 808 "SafeSearchAnnotation": { |
| 809 "description": "Set of features pertaining to the image, computed by
computer vision\nmethods over safe-search verticals (for example, adult, spoof,
medical,\nviolence).", |
| 810 "id": "SafeSearchAnnotation", |
| 811 "properties": { |
| 812 "spoof": { |
| 813 "description": "Spoof likelihood. The likelihood that an mod
ification\nwas made to the image's canonical version to make it appear\nfunny or
offensive.", |
| 814 "enum": [ |
| 815 "UNKNOWN", |
| 816 "VERY_UNLIKELY", |
927 "UNLIKELY", | 817 "UNLIKELY", |
928 "POSSIBLE", | 818 "POSSIBLE", |
929 "LIKELY", | 819 "LIKELY", |
930 "VERY_LIKELY" | 820 "VERY_LIKELY" |
931 ], | 821 ], |
932 "enumDescriptions": [ | 822 "enumDescriptions": [ |
933 "Unknown likelihood.", | 823 "Unknown likelihood.", |
934 "It is very unlikely that the image belongs to the speci
fied vertical.", | 824 "It is very unlikely that the image belongs to the speci
fied vertical.", |
935 "It is unlikely that the image belongs to the specified
vertical.", | 825 "It is unlikely that the image belongs to the specified
vertical.", |
936 "It is possible that the image belongs to the specified
vertical.", | 826 "It is possible that the image belongs to the specified
vertical.", |
937 "It is likely that the image belongs to the specified ve
rtical.", | 827 "It is likely that the image belongs to the specified ve
rtical.", |
938 "It is very likely that the image belongs to the specifi
ed vertical." | 828 "It is very likely that the image belongs to the specifi
ed vertical." |
939 ], | 829 ], |
940 "type": "string" | 830 "type": "string" |
941 }, | 831 }, |
942 "boundingPoly": { | 832 "medical": { |
943 "$ref": "BoundingPoly", | 833 "description": "Likelihood that this is a medical image.", |
944 "description": "The bounding polygon around the face. The co
ordinates 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 accordanc
e with human\nexpectations. It is based on the landmarker results.\nNote that on
e or more x and/or y coordinates may not be generated in the\n`BoundingPoly` (th
e polygon will be unbounded) if only a partial face\nappears in the image to be
annotated." | |
945 }, | |
946 "rollAngle": { | |
947 "description": "Roll angle, which indicates the amount of cl
ockwise/anti-clockwise rotation\nof the face relative to the image vertical abou
t the axis perpendicular to\nthe face. Range [-180,180].", | |
948 "format": "float", | |
949 "type": "number" | |
950 }, | |
951 "sorrowLikelihood": { | |
952 "description": "Sorrow likelihood.", | |
953 "enum": [ | 834 "enum": [ |
954 "UNKNOWN", | 835 "UNKNOWN", |
955 "VERY_UNLIKELY", | 836 "VERY_UNLIKELY", |
956 "UNLIKELY", | 837 "UNLIKELY", |
957 "POSSIBLE", | 838 "POSSIBLE", |
958 "LIKELY", | 839 "LIKELY", |
959 "VERY_LIKELY" | 840 "VERY_LIKELY" |
960 ], | 841 ], |
961 "enumDescriptions": [ | 842 "enumDescriptions": [ |
962 "Unknown likelihood.", | 843 "Unknown likelihood.", |
963 "It is very unlikely that the image belongs to the speci
fied vertical.", | 844 "It is very unlikely that the image belongs to the speci
fied vertical.", |
964 "It is unlikely that the image belongs to the specified
vertical.", | 845 "It is unlikely that the image belongs to the specified
vertical.", |
965 "It is possible that the image belongs to the specified
vertical.", | 846 "It is possible that the image belongs to the specified
vertical.", |
966 "It is likely that the image belongs to the specified ve
rtical.", | 847 "It is likely that the image belongs to the specified ve
rtical.", |
967 "It is very likely that the image belongs to the specifi
ed vertical." | 848 "It is very likely that the image belongs to the specifi
ed vertical." |
968 ], | 849 ], |
969 "type": "string" | 850 "type": "string" |
970 }, | 851 }, |
971 "tiltAngle": { | 852 "violence": { |
972 "description": "Pitch angle, which indicates the upwards/dow
nwards angle that the face is\npointing relative to the image's horizontal plane
. Range [-180,180].", | 853 "description": "Violence likelihood.", |
973 "format": "float", | |
974 "type": "number" | |
975 }, | |
976 "fdBoundingPoly": { | |
977 "$ref": "BoundingPoly", | |
978 "description": "The `fd_bounding_poly` bounding polygon is t
ighter than the\n`boundingPoly`, and encloses only the skin part of the face. Ty
pically, 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 de
tection) prefix." | |
979 }, | |
980 "angerLikelihood": { | |
981 "description": "Anger likelihood.", | |
982 "enum": [ | 854 "enum": [ |
983 "UNKNOWN", | 855 "UNKNOWN", |
984 "VERY_UNLIKELY", | 856 "VERY_UNLIKELY", |
985 "UNLIKELY", | 857 "UNLIKELY", |
986 "POSSIBLE", | 858 "POSSIBLE", |
987 "LIKELY", | 859 "LIKELY", |
988 "VERY_LIKELY" | 860 "VERY_LIKELY" |
989 ], | 861 ], |
990 "enumDescriptions": [ | 862 "enumDescriptions": [ |
991 "Unknown likelihood.", | 863 "Unknown likelihood.", |
992 "It is very unlikely that the image belongs to the speci
fied vertical.", | 864 "It is very unlikely that the image belongs to the speci
fied vertical.", |
993 "It is unlikely that the image belongs to the specified
vertical.", | 865 "It is unlikely that the image belongs to the specified
vertical.", |
994 "It is possible that the image belongs to the specified
vertical.", | 866 "It is possible that the image belongs to the specified
vertical.", |
995 "It is likely that the image belongs to the specified ve
rtical.", | 867 "It is likely that the image belongs to the specified ve
rtical.", |
996 "It is very likely that the image belongs to the specifi
ed vertical." | 868 "It is very likely that the image belongs to the specifi
ed vertical." |
997 ], | 869 ], |
998 "type": "string" | 870 "type": "string" |
999 }, | 871 }, |
1000 "landmarks": { | 872 "adult": { |
1001 "description": "Detected face landmarks.", | 873 "description": "Represents the adult content likelihood for
the image.", |
1002 "items": { | |
1003 "$ref": "Landmark" | |
1004 }, | |
1005 "type": "array" | |
1006 }, | |
1007 "surpriseLikelihood": { | |
1008 "description": "Surprise likelihood.", | |
1009 "enum": [ | 874 "enum": [ |
1010 "UNKNOWN", | 875 "UNKNOWN", |
1011 "VERY_UNLIKELY", | 876 "VERY_UNLIKELY", |
1012 "UNLIKELY", | 877 "UNLIKELY", |
1013 "POSSIBLE", | 878 "POSSIBLE", |
1014 "LIKELY", | 879 "LIKELY", |
1015 "VERY_LIKELY" | 880 "VERY_LIKELY" |
1016 ], | 881 ], |
1017 "enumDescriptions": [ | 882 "enumDescriptions": [ |
1018 "Unknown likelihood.", | 883 "Unknown likelihood.", |
1019 "It is very unlikely that the image belongs to the speci
fied vertical.", | 884 "It is very unlikely that the image belongs to the speci
fied vertical.", |
1020 "It is unlikely that the image belongs to the specified
vertical.", | 885 "It is unlikely that the image belongs to the specified
vertical.", |
1021 "It is possible that the image belongs to the specified
vertical.", | 886 "It is possible that the image belongs to the specified
vertical.", |
1022 "It is likely that the image belongs to the specified ve
rtical.", | 887 "It is likely that the image belongs to the specified ve
rtical.", |
1023 "It is very likely that the image belongs to the specifi
ed vertical." | 888 "It is very likely that the image belongs to the specifi
ed vertical." |
1024 ], | 889 ], |
1025 "type": "string" | 890 "type": "string" |
1026 }, | 891 } |
1027 "joyLikelihood": { | 892 }, |
1028 "description": "Joy likelihood.", | 893 "type": "object" |
| 894 }, |
| 895 "DominantColorsAnnotation": { |
| 896 "description": "Set of dominant colors and their corresponding score
s.", |
| 897 "id": "DominantColorsAnnotation", |
| 898 "properties": { |
| 899 "colors": { |
| 900 "description": "RGB color values with their score and pixel
fraction.", |
| 901 "items": { |
| 902 "$ref": "ColorInfo" |
| 903 }, |
| 904 "type": "array" |
| 905 } |
| 906 }, |
| 907 "type": "object" |
| 908 }, |
| 909 "TextAnnotation": { |
| 910 "description": "TextAnnotation contains a structured representation
of OCR extracted text.\nThe hierarchy of an OCR extracted text structure is like
this:\n TextAnnotation -> Page -> Block -> Paragraph -> Word -> Symbol\nEach
structural component, starting from Page, may further have their own\npropertie
s. Properties describe detected languages, breaks etc.. Please\nrefer to the goo
gle.cloud.vision.v1.TextAnnotation.TextProperty message\ndefinition below for mo
re detail.", |
| 911 "id": "TextAnnotation", |
| 912 "properties": { |
| 913 "pages": { |
| 914 "description": "List of pages detected by OCR.", |
| 915 "items": { |
| 916 "$ref": "Page" |
| 917 }, |
| 918 "type": "array" |
| 919 }, |
| 920 "text": { |
| 921 "description": "UTF-8 text detected on the pages.", |
| 922 "type": "string" |
| 923 } |
| 924 }, |
| 925 "type": "object" |
| 926 }, |
| 927 "DetectedLanguage": { |
| 928 "description": "Detected language for a structural component.", |
| 929 "id": "DetectedLanguage", |
| 930 "properties": { |
| 931 "languageCode": { |
| 932 "description": "The BCP-47 language code, such as \"en-US\"
or \"sr-Latn\". For more\ninformation, see\nhttp://www.unicode.org/reports/tr35/
#Unicode_locale_identifier.", |
| 933 "type": "string" |
| 934 }, |
| 935 "confidence": { |
| 936 "description": "Confidence of detected language. Range [0, 1
].", |
| 937 "format": "float", |
| 938 "type": "number" |
| 939 } |
| 940 }, |
| 941 "type": "object" |
| 942 }, |
| 943 "Vertex": { |
| 944 "description": "A vertex represents a 2D point in the image.\nNOTE:
the vertex coordinates are in the same scale as the original image.", |
| 945 "id": "Vertex", |
| 946 "properties": { |
| 947 "y": { |
| 948 "description": "Y coordinate.", |
| 949 "format": "int32", |
| 950 "type": "integer" |
| 951 }, |
| 952 "x": { |
| 953 "description": "X coordinate.", |
| 954 "format": "int32", |
| 955 "type": "integer" |
| 956 } |
| 957 }, |
| 958 "type": "object" |
| 959 }, |
| 960 "WebEntity": { |
| 961 "description": "Entity deduced from similar images on the Internet."
, |
| 962 "id": "WebEntity", |
| 963 "properties": { |
| 964 "score": { |
| 965 "description": "Overall relevancy score for the entity.\nNot
normalized and not comparable across different image queries.", |
| 966 "format": "float", |
| 967 "type": "number" |
| 968 }, |
| 969 "entityId": { |
| 970 "description": "Opaque entity ID.", |
| 971 "type": "string" |
| 972 }, |
| 973 "description": { |
| 974 "description": "Canonical description of the entity, in Engl
ish.", |
| 975 "type": "string" |
| 976 } |
| 977 }, |
| 978 "type": "object" |
| 979 }, |
| 980 "BoundingPoly": { |
| 981 "description": "A bounding polygon for the detected image annotation
.", |
| 982 "id": "BoundingPoly", |
| 983 "properties": { |
| 984 "vertices": { |
| 985 "description": "The bounding polygon vertices.", |
| 986 "items": { |
| 987 "$ref": "Vertex" |
| 988 }, |
| 989 "type": "array" |
| 990 } |
| 991 }, |
| 992 "type": "object" |
| 993 }, |
| 994 "TextProperty": { |
| 995 "description": "Additional information detected on the structural co
mponent.", |
| 996 "id": "TextProperty", |
| 997 "properties": { |
| 998 "detectedBreak": { |
| 999 "$ref": "DetectedBreak", |
| 1000 "description": "Detected start or end of a text segment." |
| 1001 }, |
| 1002 "detectedLanguages": { |
| 1003 "description": "A list of detected languages together with c
onfidence.", |
| 1004 "items": { |
| 1005 "$ref": "DetectedLanguage" |
| 1006 }, |
| 1007 "type": "array" |
| 1008 } |
| 1009 }, |
| 1010 "type": "object" |
| 1011 }, |
| 1012 "AnnotateImageResponse": { |
| 1013 "description": "Response to an image annotation request.", |
| 1014 "id": "AnnotateImageResponse", |
| 1015 "properties": { |
| 1016 "safeSearchAnnotation": { |
| 1017 "$ref": "SafeSearchAnnotation", |
| 1018 "description": "If present, safe-search annotation has compl
eted successfully." |
| 1019 }, |
| 1020 "labelAnnotations": { |
| 1021 "description": "If present, label detection has completed su
ccessfully.", |
| 1022 "items": { |
| 1023 "$ref": "EntityAnnotation" |
| 1024 }, |
| 1025 "type": "array" |
| 1026 }, |
| 1027 "error": { |
| 1028 "$ref": "Status", |
| 1029 "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." |
| 1030 }, |
| 1031 "fullTextAnnotation": { |
| 1032 "$ref": "TextAnnotation", |
| 1033 "description": "If present, text (OCR) detection or document
(OCR) text detection has\ncompleted successfully.\nThis annotation provides the
structural hierarchy for the OCR detected\ntext." |
| 1034 }, |
| 1035 "landmarkAnnotations": { |
| 1036 "description": "If present, landmark detection has completed
successfully.", |
| 1037 "items": { |
| 1038 "$ref": "EntityAnnotation" |
| 1039 }, |
| 1040 "type": "array" |
| 1041 }, |
| 1042 "textAnnotations": { |
| 1043 "description": "If present, text (OCR) detection has complet
ed successfully.", |
| 1044 "items": { |
| 1045 "$ref": "EntityAnnotation" |
| 1046 }, |
| 1047 "type": "array" |
| 1048 }, |
| 1049 "faceAnnotations": { |
| 1050 "description": "If present, face detection has completed suc
cessfully.", |
| 1051 "items": { |
| 1052 "$ref": "FaceAnnotation" |
| 1053 }, |
| 1054 "type": "array" |
| 1055 }, |
| 1056 "imagePropertiesAnnotation": { |
| 1057 "$ref": "ImageProperties", |
| 1058 "description": "If present, image properties were extracted
successfully." |
| 1059 }, |
| 1060 "logoAnnotations": { |
| 1061 "description": "If present, logo detection has completed suc
cessfully.", |
| 1062 "items": { |
| 1063 "$ref": "EntityAnnotation" |
| 1064 }, |
| 1065 "type": "array" |
| 1066 }, |
| 1067 "webDetection": { |
| 1068 "$ref": "WebDetection", |
| 1069 "description": "If present, web detection has completed succ
essfully." |
| 1070 }, |
| 1071 "cropHintsAnnotation": { |
| 1072 "$ref": "CropHintsAnnotation", |
| 1073 "description": "If present, crop hints have completed succes
sfully." |
| 1074 } |
| 1075 }, |
| 1076 "type": "object" |
| 1077 }, |
| 1078 "CropHintsParams": { |
| 1079 "description": "Parameters for crop hints annotation request.", |
| 1080 "id": "CropHintsParams", |
| 1081 "properties": { |
| 1082 "aspectRatios": { |
| 1083 "description": "Aspect ratios in floats, representing the ra
tio of the width to the height\nof the image. For example, if the desired aspect
ratio is 4/3, the\ncorresponding float value should be 1.33333. If not specifi
ed, the\nbest possible crop is returned. The number of provided aspect ratios is
\nlimited to a maximum of 16; any aspect ratios provided after the 16th are\nign
ored.", |
| 1084 "items": { |
| 1085 "format": "float", |
| 1086 "type": "number" |
| 1087 }, |
| 1088 "type": "array" |
| 1089 } |
| 1090 }, |
| 1091 "type": "object" |
| 1092 }, |
| 1093 "Block": { |
| 1094 "description": "Logical element on the page.", |
| 1095 "id": "Block", |
| 1096 "properties": { |
| 1097 "boundingBox": { |
| 1098 "$ref": "BoundingPoly", |
| 1099 "description": "The bounding box for the block.\nThe vertice
s are in the order of top-left, top-right, bottom-right,\nbottom-left. When a ro
tation of the bounding box is detected the rotation\nis represented as around th
e top-left corner as defined when the text is\nread in the 'natural' orientation
.\nFor example:\n * when the text is horizontal it might look like:\n 0----
1\n | |\n 3----2\n * when it's rotated 180 degrees around the top-le
ft corner it becomes:\n 2----3\n | |\n 1----0\n and the vertice
order will still be (0, 1, 2, 3)." |
| 1100 }, |
| 1101 "paragraphs": { |
| 1102 "description": "List of paragraphs in this block (if this bl
ocks is of type text).", |
| 1103 "items": { |
| 1104 "$ref": "Paragraph" |
| 1105 }, |
| 1106 "type": "array" |
| 1107 }, |
| 1108 "property": { |
| 1109 "$ref": "TextProperty", |
| 1110 "description": "Additional information detected for the bloc
k." |
| 1111 }, |
| 1112 "blockType": { |
| 1113 "description": "Detected block type (text, image etc) for th
is block.", |
1029 "enum": [ | 1114 "enum": [ |
1030 "UNKNOWN", | 1115 "UNKNOWN", |
1031 "VERY_UNLIKELY", | 1116 "TEXT", |
1032 "UNLIKELY", | 1117 "TABLE", |
1033 "POSSIBLE", | 1118 "PICTURE", |
1034 "LIKELY", | 1119 "RULER", |
1035 "VERY_LIKELY" | 1120 "BARCODE" |
1036 ], | 1121 ], |
1037 "enumDescriptions": [ | 1122 "enumDescriptions": [ |
1038 "Unknown likelihood.", | 1123 "Unknown block type.", |
1039 "It is very unlikely that the image belongs to the speci
fied vertical.", | 1124 "Regular text block.", |
1040 "It is unlikely that the image belongs to the specified
vertical.", | 1125 "Table block.", |
1041 "It is possible that the image belongs to the specified
vertical.", | 1126 "Image block.", |
1042 "It is likely that the image belongs to the specified ve
rtical.", | 1127 "Horizontal/vertical line box.", |
1043 "It is very likely that the image belongs to the specifi
ed vertical." | 1128 "Barcode block." |
1044 ], | 1129 ], |
1045 "type": "string" | 1130 "type": "string" |
1046 }, | 1131 } |
1047 "landmarkingConfidence": { | 1132 }, |
1048 "description": "Face landmarking confidence. Range [0, 1].", | 1133 "type": "object" |
1049 "format": "float", | 1134 }, |
1050 "type": "number" | 1135 "Property": { |
1051 } | 1136 "description": "A `Property` consists of a user-supplied name/value
pair.", |
1052 }, | 1137 "id": "Property", |
1053 "type": "object" | 1138 "properties": { |
1054 }, | 1139 "name": { |
1055 "BatchAnnotateImagesRequest": { | 1140 "description": "Name of the property.", |
1056 "description": "Multiple image annotation requests are batched into
a single service call.", | 1141 "type": "string" |
1057 "id": "BatchAnnotateImagesRequest", | 1142 }, |
1058 "properties": { | 1143 "value": { |
1059 "requests": { | 1144 "description": "Value of the property.", |
1060 "description": "Individual image annotation requests for thi
s batch.", | 1145 "type": "string" |
1061 "items": { | 1146 }, |
1062 "$ref": "AnnotateImageRequest" | 1147 "uint64Value": { |
1063 }, | 1148 "description": "Value of numeric properties.", |
1064 "type": "array" | 1149 "format": "uint64", |
1065 } | 1150 "type": "string" |
1066 }, | 1151 } |
1067 "type": "object" | 1152 }, |
1068 }, | 1153 "type": "object" |
1069 "DetectedBreak": { | 1154 }, |
1070 "description": "Detected start or end of a structural component.", | 1155 "LocationInfo": { |
1071 "id": "DetectedBreak", | 1156 "description": "Detected entity location information.", |
1072 "properties": { | 1157 "id": "LocationInfo", |
1073 "isPrefix": { | 1158 "properties": { |
1074 "description": "True if break prepends the element.", | 1159 "latLng": { |
1075 "type": "boolean" | |
1076 }, | |
1077 "type": { | |
1078 "description": "Detected break type.", | |
1079 "enum": [ | |
1080 "UNKNOWN", | |
1081 "SPACE", | |
1082 "SURE_SPACE", | |
1083 "EOL_SURE_SPACE", | |
1084 "HYPHEN", | |
1085 "LINE_BREAK" | |
1086 ], | |
1087 "enumDescriptions": [ | |
1088 "Unknown break label type.", | |
1089 "Regular space.", | |
1090 "Sure space (very wide).", | |
1091 "Line-wrapping break.", | |
1092 "End-line hyphen that is not present in text; does not c
o-occur with\n`SPACE`, `LEADER_SPACE`, or `LINE_BREAK`.", | |
1093 "Line break that ends a paragraph." | |
1094 ], | |
1095 "type": "string" | |
1096 } | |
1097 }, | |
1098 "type": "object" | |
1099 }, | |
1100 "ImageContext": { | |
1101 "description": "Image context and/or feature-specific parameters.", | |
1102 "id": "ImageContext", | |
1103 "properties": { | |
1104 "latLongRect": { | |
1105 "$ref": "LatLongRect", | |
1106 "description": "lat/long rectangle that specifies the locati
on of the image." | |
1107 }, | |
1108 "cropHintsParams": { | |
1109 "$ref": "CropHintsParams", | |
1110 "description": "Parameters for crop hints annotation request
." | |
1111 }, | |
1112 "languageHints": { | |
1113 "description": "List of languages to use for TEXT_DETECTION.
In most cases, an empty value\nyields the best results since it enables automat
ic language detection. For\nlanguages based on the Latin alphabet, setting `lang
uage_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 b
e a\nsignificant hindrance if the hint is wrong). Text detection returns an\nerr
or if one or more of the specified languages is not one of the\n[supported langu
ages](/vision/docs/languages).", | |
1114 "items": { | |
1115 "type": "string" | |
1116 }, | |
1117 "type": "array" | |
1118 } | |
1119 }, | |
1120 "type": "object" | |
1121 }, | |
1122 "Page": { | |
1123 "description": "Detected page from OCR.", | |
1124 "id": "Page", | |
1125 "properties": { | |
1126 "property": { | |
1127 "$ref": "TextProperty", | |
1128 "description": "Additional information detected on the page.
" | |
1129 }, | |
1130 "height": { | |
1131 "description": "Page height in pixels.", | |
1132 "format": "int32", | |
1133 "type": "integer" | |
1134 }, | |
1135 "width": { | |
1136 "description": "Page width in pixels.", | |
1137 "format": "int32", | |
1138 "type": "integer" | |
1139 }, | |
1140 "blocks": { | |
1141 "description": "List of blocks of text, images etc on this p
age.", | |
1142 "items": { | |
1143 "$ref": "Block" | |
1144 }, | |
1145 "type": "array" | |
1146 } | |
1147 }, | |
1148 "type": "object" | |
1149 }, | |
1150 "AnnotateImageRequest": { | |
1151 "description": "Request for performing Google Cloud Vision API tasks
over a user-provided\nimage, with user-requested features.", | |
1152 "id": "AnnotateImageRequest", | |
1153 "properties": { | |
1154 "imageContext": { | |
1155 "$ref": "ImageContext", | |
1156 "description": "Additional context that may accompany the im
age." | |
1157 }, | |
1158 "image": { | |
1159 "$ref": "Image", | |
1160 "description": "The image to be processed." | |
1161 }, | |
1162 "features": { | |
1163 "description": "Requested features.", | |
1164 "items": { | |
1165 "$ref": "Feature" | |
1166 }, | |
1167 "type": "array" | |
1168 } | |
1169 }, | |
1170 "type": "object" | |
1171 }, | |
1172 "Status": { | |
1173 "description": "The `Status` type defines a logical error model that
is suitable for different\nprogramming environments, including REST APIs and RP
C APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is desig
ned to be:\n\n- Simple to use and understand for most users\n- Flexible enough t
o meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pie
ces of data: error code, error message,\nand error details. The error code shoul
d be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes
if needed. The\nerror message should be a developer-facing English message tha
t helps\ndevelopers *understand* and *resolve* the error. If a localized user-fa
cing\nerror message is needed, put the localized message in the error details or
\nlocalize it in the client. The optional error details may contain arbitrary\ni
nformation about the error. There is a predefined set of error detail types\nin
the package `google.rpc` that can be used for common error conditions.\n\n# Lang
uage mapping\n\nThe `Status` message is the logical representation of the error
model, but it\nis not necessarily the actual wire format. When the `Status` mess
age is\nexposed in different client libraries and different wire protocols, it c
an be\nmapped differently. For example, it will likely be mapped to some excepti
ons\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n
\nThe error model and the `Status` message can be used in a variety of\nenvironm
ents, either with or without APIs, to provide a\nconsistent developer experience
across different environments.\n\nExample uses of this error model include:\n\n
- Partial errors. If a service needs to return partial errors to the client,\n
it may embed the `Status` in the normal response to indicate the partial\n
errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step m
ay\n have a `Status` message for error reporting.\n\n- Batch operations. If a
client uses batch request and batch response, the\n `Status` message should
be used directly inside batch response, one for\n each error sub-response.\n\
n- Asynchronous operations. If an API call embeds asynchronous operation\n re
sults in its response, the status of those operations should be\n represented
directly using the `Status` message.\n\n- Logging. If some API errors are store
d in logs, the message `Status` could\n be used directly after any stripping
needed for security/privacy reasons.", | |
1174 "id": "Status", | |
1175 "properties": { | |
1176 "details": { | |
1177 "description": "A list of messages that carry the error deta
ils. There will be a\ncommon set of message types for APIs to use.", | |
1178 "items": { | |
1179 "additionalProperties": { | |
1180 "description": "Properties of the object. Contains f
ield @type with type URL.", | |
1181 "type": "any" | |
1182 }, | |
1183 "type": "object" | |
1184 }, | |
1185 "type": "array" | |
1186 }, | |
1187 "code": { | |
1188 "description": "The status code, which should be an enum val
ue of google.rpc.Code.", | |
1189 "format": "int32", | |
1190 "type": "integer" | |
1191 }, | |
1192 "message": { | |
1193 "description": "A developer-facing error message, which shou
ld be in English. Any\nuser-facing error message should be localized and sent in
the\ngoogle.rpc.Status.details field, or localized by the client.", | |
1194 "type": "string" | |
1195 } | |
1196 }, | |
1197 "type": "object" | |
1198 }, | |
1199 "LatLongRect": { | |
1200 "description": "Rectangle determined by min and max `LatLng` pairs."
, | |
1201 "id": "LatLongRect", | |
1202 "properties": { | |
1203 "maxLatLng": { | |
1204 "$ref": "LatLng", | 1160 "$ref": "LatLng", |
1205 "description": "Max lat/long pair." | 1161 "description": "lat/long location coordinates." |
1206 }, | 1162 } |
1207 "minLatLng": { | 1163 }, |
1208 "$ref": "LatLng", | 1164 "type": "object" |
1209 "description": "Min lat/long pair." | 1165 }, |
1210 } | 1166 "ImageSource": { |
1211 }, | 1167 "description": "External image source (Google Cloud Storage image lo
cation).", |
1212 "type": "object" | 1168 "id": "ImageSource", |
1213 }, | 1169 "properties": { |
1214 "Symbol": { | 1170 "gcsImageUri": { |
1215 "description": "A single symbol representation.", | 1171 "description": "NOTE: For new code `image_uri` below is pref
erred.\nGoogle Cloud Storage image URI, which must be in the following form:\n`g
s://bucket_name/object_name` (for details, see\n[Google Cloud Storage Request\nU
RIs](https://cloud.google.com/storage/docs/reference-uris)).\nNOTE: Cloud Storag
e object versioning is not supported.", |
1216 "id": "Symbol", | 1172 "type": "string" |
1217 "properties": { | 1173 }, |
1218 "text": { | 1174 "imageUri": { |
1219 "description": "The actual UTF-8 representation of the symbo
l.", | 1175 "description": "Image URI which supports:\n1) Google Cloud S
torage image URI, which must be in the following form:\n`gs://bucket_name/object
_name` (for details, see\n[Google Cloud Storage Request\nURIs](https://cloud.goo
gle.com/storage/docs/reference-uris)).\nNOTE: Cloud Storage object versioning is
not supported.\n2) Publicly accessible image HTTP/HTTPS URL.\nThis is preferred
over the legacy `gcs_image_uri` above. When both\n`gcs_image_uri` and `image_ur
i` are specified, `image_uri` takes\nprecedence.", |
1220 "type": "string" | 1176 "type": "string" |
1221 }, | 1177 } |
1222 "property": { | 1178 }, |
1223 "$ref": "TextProperty", | 1179 "type": "object" |
1224 "description": "Additional information detected for the symb
ol." | 1180 }, |
1225 }, | 1181 "BatchAnnotateImagesResponse": { |
1226 "boundingBox": { | 1182 "description": "Response to a batch image annotation request.", |
| 1183 "id": "BatchAnnotateImagesResponse", |
| 1184 "properties": { |
| 1185 "responses": { |
| 1186 "description": "Individual responses to image annotation req
uests within the batch.", |
| 1187 "items": { |
| 1188 "$ref": "AnnotateImageResponse" |
| 1189 }, |
| 1190 "type": "array" |
| 1191 } |
| 1192 }, |
| 1193 "type": "object" |
| 1194 }, |
| 1195 "WebDetection": { |
| 1196 "description": "Relevant information for the image from the Internet
.", |
| 1197 "id": "WebDetection", |
| 1198 "properties": { |
| 1199 "visuallySimilarImages": { |
| 1200 "description": "The visually similar image results.", |
| 1201 "items": { |
| 1202 "$ref": "WebImage" |
| 1203 }, |
| 1204 "type": "array" |
| 1205 }, |
| 1206 "partialMatchingImages": { |
| 1207 "description": "Partial matching images from the Internet.\n
Those images are similar enough to share some key-point features. For\nexample a
n original image will likely have partial matching for its crops.", |
| 1208 "items": { |
| 1209 "$ref": "WebImage" |
| 1210 }, |
| 1211 "type": "array" |
| 1212 }, |
| 1213 "fullMatchingImages": { |
| 1214 "description": "Fully matching images from the Internet.\nCa
n include resized copies of the query image.", |
| 1215 "items": { |
| 1216 "$ref": "WebImage" |
| 1217 }, |
| 1218 "type": "array" |
| 1219 }, |
| 1220 "webEntities": { |
| 1221 "description": "Deduced entities from similar images on the
Internet.", |
| 1222 "items": { |
| 1223 "$ref": "WebEntity" |
| 1224 }, |
| 1225 "type": "array" |
| 1226 }, |
| 1227 "pagesWithMatchingImages": { |
| 1228 "description": "Web pages containing the matching images fro
m the Internet.", |
| 1229 "items": { |
| 1230 "$ref": "WebPage" |
| 1231 }, |
| 1232 "type": "array" |
| 1233 } |
| 1234 }, |
| 1235 "type": "object" |
| 1236 }, |
| 1237 "Position": { |
| 1238 "description": "A 3D position in the image, used primarily for Face
detection landmarks.\nA valid Position must have both x and y coordinates.\nThe
position coordinates are in the same scale as the original image.", |
| 1239 "id": "Position", |
| 1240 "properties": { |
| 1241 "y": { |
| 1242 "description": "Y coordinate.", |
| 1243 "format": "float", |
| 1244 "type": "number" |
| 1245 }, |
| 1246 "z": { |
| 1247 "description": "Z coordinate (or depth).", |
| 1248 "format": "float", |
| 1249 "type": "number" |
| 1250 }, |
| 1251 "x": { |
| 1252 "description": "X coordinate.", |
| 1253 "format": "float", |
| 1254 "type": "number" |
| 1255 } |
| 1256 }, |
| 1257 "type": "object" |
| 1258 }, |
| 1259 "WebPage": { |
| 1260 "description": "Metadata for web pages.", |
| 1261 "id": "WebPage", |
| 1262 "properties": { |
| 1263 "url": { |
| 1264 "description": "The result web page URL.", |
| 1265 "type": "string" |
| 1266 }, |
| 1267 "score": { |
| 1268 "description": "Overall relevancy score for the web page.\nN
ot normalized and not comparable across different image queries.", |
| 1269 "format": "float", |
| 1270 "type": "number" |
| 1271 } |
| 1272 }, |
| 1273 "type": "object" |
| 1274 }, |
| 1275 "ColorInfo": { |
| 1276 "description": "Color information consists of RGB channels, score, a
nd the fraction of\nthe image that the color occupies in the image.", |
| 1277 "id": "ColorInfo", |
| 1278 "properties": { |
| 1279 "pixelFraction": { |
| 1280 "description": "The fraction of pixels the color occupies in
the image.\nValue in range [0, 1].", |
| 1281 "format": "float", |
| 1282 "type": "number" |
| 1283 }, |
| 1284 "color": { |
| 1285 "$ref": "Color", |
| 1286 "description": "RGB components of the color." |
| 1287 }, |
| 1288 "score": { |
| 1289 "description": "Image-specific score for this color. Value i
n range [0, 1].", |
| 1290 "format": "float", |
| 1291 "type": "number" |
| 1292 } |
| 1293 }, |
| 1294 "type": "object" |
| 1295 }, |
| 1296 "EntityAnnotation": { |
| 1297 "description": "Set of detected entity features.", |
| 1298 "id": "EntityAnnotation", |
| 1299 "properties": { |
| 1300 "description": { |
| 1301 "description": "Entity textual description, expressed in its
`locale` language.", |
| 1302 "type": "string" |
| 1303 }, |
| 1304 "topicality": { |
| 1305 "description": "The relevancy of the ICA (Image Content Anno
tation) label to the\nimage. For example, the relevancy of \"tower\" is likely h
igher to an image\ncontaining the detected \"Eiffel Tower\" than to an image con
taining a\ndetected distant towering building, even though the confidence that\n
there is a tower in each image may be the same. Range [0, 1].", |
| 1306 "format": "float", |
| 1307 "type": "number" |
| 1308 }, |
| 1309 "properties": { |
| 1310 "description": "Some entities may have optional user-supplie
d `Property` (name/value)\nfields, such a score or string that qualifies the ent
ity.", |
| 1311 "items": { |
| 1312 "$ref": "Property" |
| 1313 }, |
| 1314 "type": "array" |
| 1315 }, |
| 1316 "score": { |
| 1317 "description": "Overall score of the result. Range [0, 1].", |
| 1318 "format": "float", |
| 1319 "type": "number" |
| 1320 }, |
| 1321 "locations": { |
| 1322 "description": "The location information for the detected en
tity. Multiple\n`LocationInfo` elements can be present because one location may\
nindicate the location of the scene in the image, and another location\nmay indi
cate the location of the place where the image was taken.\nLocation information
is usually present for landmarks.", |
| 1323 "items": { |
| 1324 "$ref": "LocationInfo" |
| 1325 }, |
| 1326 "type": "array" |
| 1327 }, |
| 1328 "mid": { |
| 1329 "description": "Opaque entity ID. Some IDs may be available
in\n[Google Knowledge Graph Search API](https://developers.google.com/knowledge-
graph/).", |
| 1330 "type": "string" |
| 1331 }, |
| 1332 "confidence": { |
| 1333 "description": "The accuracy of the entity detection in an i
mage.\nFor example, for an image in which the \"Eiffel Tower\" entity is detecte
d,\nthis field represents the confidence that there is a tower in the query\nima
ge. Range [0, 1].", |
| 1334 "format": "float", |
| 1335 "type": "number" |
| 1336 }, |
| 1337 "locale": { |
| 1338 "description": "The language code for the locale in which th
e entity textual\n`description` is expressed.", |
| 1339 "type": "string" |
| 1340 }, |
| 1341 "boundingPoly": { |
1227 "$ref": "BoundingPoly", | 1342 "$ref": "BoundingPoly", |
1228 "description": "The bounding box for the symbol.\nThe vertic
es are in the order of top-left, top-right, bottom-right,\nbottom-left. When a r
otation of the bounding box is detected the rotation\nis represented as around t
he top-left corner as defined when the text is\nread in the 'natural' orientatio
n.\nFor example:\n * when the text is horizontal it might look like:\n 0---
-1\n | |\n 3----2\n * when it's rotated 180 degrees around the top-l
eft corner it becomes:\n 2----3\n | |\n 1----0\n and the vertice
order will still be (0, 1, 2, 3)." | 1343 "description": "Image region to which this entity belongs. N
ot produced\nfor `LABEL_DETECTION` features." |
1229 } | 1344 } |
1230 }, | 1345 }, |
1231 "type": "object" | 1346 "type": "object" |
1232 }, | |
1233 "CropHintsAnnotation": { | |
1234 "description": "Set of crop hints that are used to generate new crop
s when serving images.", | |
1235 "id": "CropHintsAnnotation", | |
1236 "properties": { | |
1237 "cropHints": { | |
1238 "description": "Crop hint results.", | |
1239 "items": { | |
1240 "$ref": "CropHint" | |
1241 }, | |
1242 "type": "array" | |
1243 } | |
1244 }, | |
1245 "type": "object" | |
1246 }, | |
1247 "LatLng": { | |
1248 "description": "An object representing a latitude/longitude pair. Th
is is expressed as a pair\nof doubles representing degrees latitude and degrees
longitude. Unless\nspecified otherwise, this must conform to the\n<a href=\"http
://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf\">WGS84\nstandard</a>. Values
must be within normalized ranges.\n\nExample of normalization code in Python:\n
\n def NormalizeLongitude(longitude):\n \"\"\"Wraps decimal degrees long
itude to [-180.0, 180.0].\"\"\"\n q, r = divmod(longitude, 360.0)\n if
r > 180.0 or (r == 180.0 and q <= -1.0):\n return r - 360.0\n retur
n 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], resp
ectively.\"\"\"\n r = latitude % 360.0\n if r <= 90.0:\n return
r, NormalizeLongitude(longitude)\n elif r >= 270.0:\n return r - 36
0, NormalizeLongitude(longitude)\n else:\n return 180 - r, Normalize
Longitude(longitude + 180.0)\n\n assert 180.0 == NormalizeLongitude(180.0)\n
assert -180.0 == NormalizeLongitude(-180.0)\n assert -179.0 == NormalizeLo
ngitude(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) == Normali
zeLatLng(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 as
sert (-90.0, 10.0) == NormalizeLatLng(270.0, 10.0)\n assert (90.0, 10.0) == N
ormalizeLatLng(-270.0, 10.0)", | |
1249 "id": "LatLng", | |
1250 "properties": { | |
1251 "latitude": { | |
1252 "description": "The latitude in degrees. It must be in the r
ange [-90.0, +90.0].", | |
1253 "format": "double", | |
1254 "type": "number" | |
1255 }, | |
1256 "longitude": { | |
1257 "description": "The longitude in degrees. It must be in the
range [-180.0, +180.0].", | |
1258 "format": "double", | |
1259 "type": "number" | |
1260 } | |
1261 }, | |
1262 "type": "object" | |
1263 }, | |
1264 "Color": { | |
1265 "description": "Represents a color in the RGBA color space. This rep
resentation is designed\nfor simplicity of conversion to/from color representati
ons in various\nlanguages over compactness; for example, the fields of this repr
esentation\ncan be trivially provided to the constructor of \"java.awt.Color\" i
n Java; it\ncan also be trivially provided to UIColor's \"+colorWithRed:green:bl
ue:alpha\"\nmethod in iOS; and, with just a little work, it can be easily format
ted into\na CSS \"rgba()\" string in JavaScript, as well. Here are some examples
:\n\nExample (Java):\n\n import com.google.type.Color;\n\n // ...\n
public static java.awt.Color fromProto(Color protocolor) {\n float alpha =
protocolor.hasAlpha()\n ? protocolor.getAlpha().getValue()\n
: 1.0;\n\n return new java.awt.Color(\n protocolor.getRed(),\n
protocolor.getGreen(),\n protocolor.getBlue(),\n
alpha);\n }\n\n public static Color toProto(java.awt.Color color) {\n
float red = (float) color.getRed();\n float green = (float) color.getG
reen();\n float blue = (float) color.getBlue();\n float denominator
= 255.0;\n Color.Builder resultBuilder =\n Color\n
.newBuilder()\n .setRed(red / denominator)\n .setGr
een(green / denominator)\n .setBlue(blue / denominator);\n i
nt alpha = color.getAlpha();\n if (alpha != 255) {\n result.setAlp
ha(\n FloatValue\n .newBuilder()\n .
setValue(((float) alpha) / denominator)\n .build());\n }\n
return resultBuilder.build();\n }\n // ...\n\nExample (iOS / Obj-
C):\n\n // ...\n static UIColor* fromProto(Color* protocolor) {\n
float red = [protocolor red];\n float green = [protocolor green];\n
float blue = [protocolor blue];\n FloatValue* alpha_wrapper = [protoco
lor alpha];\n float alpha = 1.0;\n if (alpha_wrapper != nil) {\n
alpha = [alpha_wrapper value];\n }\n return [UIColor color
WithRed:red green:green blue:blue alpha:alpha];\n }\n\n static Color* to
Proto(UIColor* color) {\n CGFloat red, green, blue, alpha;\n if
(![color getRed:&red green:&green blue:&blue alpha:&alpha]) {\n return
nil;\n }\n Color* result = [Color alloc] init];\n [resu
lt setRed:red];\n [result setGreen:green];\n [result setBlue:blu
e];\n if (alpha <= 0.9999) {\n [result setAlpha:floatWrapperWi
thValue(alpha)];\n }\n [result autorelease];\n return re
sult;\n }\n // ...\n\n Example (JavaScript):\n\n // ...\n\n var prot
oToCssColor = function(rgb_color) {\n var redFrac = rgb_color.red || 0.0;\
n var greenFrac = rgb_color.green || 0.0;\n var blueFrac = rgb_color
.blue || 0.0;\n var red = Math.floor(redFrac * 255);\n var green = M
ath.floor(greenFrac * 255);\n var blue = Math.floor(blueFrac * 255);\n\n
if (!('alpha' in rgb_color)) {\n return rgbToCssColor_(red, green,
blue);\n }\n\n var alphaFrac = rgb_color.alpha.value || 0.0;\n
var rgbParams = [red, green, blue].join(',');\n return ['rgba(', rgbPara
ms, ',', alphaFrac, ')'].join('');\n };\n\n var rgbToCssColor_ = function(
red, green, blue) {\n var rgbNumber = new Number((red << 16) | (green << 8)
| blue);\n var hexString = rgbNumber.toString(16);\n var missingZeros
= 6 - hexString.length;\n var resultBuilder = ['#'];\n for (var i = 0
; i < missingZeros; i++) {\n resultBuilder.push('0');\n }\n re
sultBuilder.push(hexString);\n return resultBuilder.join('');\n };\n\n
// ...", | |
1266 "id": "Color", | |
1267 "properties": { | |
1268 "red": { | |
1269 "description": "The amount of red in the color as a value in
the interval [0, 1].", | |
1270 "format": "float", | |
1271 "type": "number" | |
1272 }, | |
1273 "green": { | |
1274 "description": "The amount of green in the color as a value
in the interval [0, 1].", | |
1275 "format": "float", | |
1276 "type": "number" | |
1277 }, | |
1278 "blue": { | |
1279 "description": "The amount of blue in the color as a value i
n the interval [0, 1].", | |
1280 "format": "float", | |
1281 "type": "number" | |
1282 }, | |
1283 "alpha": { | |
1284 "description": "The fraction of this color that should be ap
plied to the pixel. That is,\nthe final pixel color is defined by the equation:\
n\n pixel color = alpha * (this color) + (1.0 - alpha) * (background color)\n\n
This means that a value of 1.0 corresponds to a solid color, whereas\na value of
0.0 corresponds to a completely transparent color. This\nuses a wrapper message
rather than a simple float scalar so that it is\npossible to distinguish betwee
n a default value and the value being unset.\nIf omitted, this color object is t
o be rendered as a solid color\n(as if the alpha value had been explicitly given
with a value of 1.0).", | |
1285 "format": "float", | |
1286 "type": "number" | |
1287 } | |
1288 }, | |
1289 "type": "object" | |
1290 }, | |
1291 "Feature": { | |
1292 "description": "Users describe the type of Google Cloud Vision API t
asks 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\nverti
cal to operate on and the number of top-scoring results to return.", | |
1293 "id": "Feature", | |
1294 "properties": { | |
1295 "type": { | |
1296 "description": "The feature type.", | |
1297 "enum": [ | |
1298 "TYPE_UNSPECIFIED", | |
1299 "FACE_DETECTION", | |
1300 "LANDMARK_DETECTION", | |
1301 "LOGO_DETECTION", | |
1302 "LABEL_DETECTION", | |
1303 "TEXT_DETECTION", | |
1304 "DOCUMENT_TEXT_DETECTION", | |
1305 "SAFE_SEARCH_DETECTION", | |
1306 "IMAGE_PROPERTIES", | |
1307 "CROP_HINTS", | |
1308 "WEB_DETECTION" | |
1309 ], | |
1310 "enumDescriptions": [ | |
1311 "Unspecified feature type.", | |
1312 "Run face detection.", | |
1313 "Run landmark detection.", | |
1314 "Run logo detection.", | |
1315 "Run label detection.", | |
1316 "Run OCR.", | |
1317 "Run dense text document OCR. Takes precedence when both
\nDOCUMENT_TEXT_DETECTION and TEXT_DETECTION are present.", | |
1318 "Run computer vision models to compute image safe-search
properties.", | |
1319 "Compute a set of image properties, such as the image's
dominant colors.", | |
1320 "Run crop hints.", | |
1321 "Run web detection." | |
1322 ], | |
1323 "type": "string" | |
1324 }, | |
1325 "maxResults": { | |
1326 "description": "Maximum number of results of this type.", | |
1327 "format": "int32", | |
1328 "type": "integer" | |
1329 } | |
1330 }, | |
1331 "type": "object" | |
1332 }, | |
1333 "ImageProperties": { | |
1334 "description": "Stores image properties, such as dominant colors.", | |
1335 "id": "ImageProperties", | |
1336 "properties": { | |
1337 "dominantColors": { | |
1338 "$ref": "DominantColorsAnnotation", | |
1339 "description": "If present, dominant colors completed succes
sfully." | |
1340 } | |
1341 }, | |
1342 "type": "object" | |
1343 } | 1347 } |
1344 }, | 1348 }, |
1345 "servicePath": "", | 1349 "servicePath": "", |
1346 "title": "Google Cloud Vision API", | 1350 "title": "Google Cloud Vision API", |
1347 "version": "v1" | 1351 "version": "v1" |
1348 } | 1352 } |
OLD | NEW |