Blame - docs/dyn/vision_v1p2beta1.projects.images.html - platform/external/python/google-api-python-client

2020-05-20 12:08:20 -0700

[diff] [blame]

105

"requests": [ # Required. Individual image annotation requests for this batch.

106

{ # Request for performing Google Cloud Vision API tasks over a user-provided

107

# image, with user-requested features, and with context information.

108

"image": { # Client image to perform Google Cloud Vision API tasks over. # The image to be processed.

109

"content": "A String", # Image content, represented as a stream of bytes.

110

# Note: As with all `bytes` fields, protobuffers use a pure binary

111

# representation, whereas JSON representations use base64.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

112

#

113

# Currently, this field only works for BatchAnnotateImages requests. It does

114

# not work for AsyncBatchAnnotateImages requests.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

115

"source": { # External image source (Google Cloud Storage or web URL image location). # Google Cloud Storage image location, or publicly-accessible image

116

# URL. If both `content` and `source` are provided for an image, `content`

117

# takes precedence and is used to perform the image annotation request.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

118

"gcsImageUri": "A String", # **Use `image_uri` instead.**

119

#

120

# The Google Cloud Storage URI of the form

121

# `gs://bucket_name/object_name`. Object versioning is not supported. See

122

# [Google Cloud Storage Request

123

# URIs](https://cloud.google.com/storage/docs/reference-uris) for more info.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

124

"imageUri": "A String", # The URI of the source image. Can be either:

125

#

126

# 1. A Google Cloud Storage URI of the form

127

# `gs://bucket_name/object_name`. Object versioning is not supported. See

128

# [Google Cloud Storage Request

129

# URIs](https://cloud.google.com/storage/docs/reference-uris) for more

130

# info.

131

#

132

# 2. A publicly-accessible image HTTP/HTTPS URL. When fetching images from

133

# HTTP/HTTPS URLs, Google cannot guarantee that the request will be

134

# completed. Your request may fail if the specified host denies the

135

# request (e.g. due to request throttling or DOS prevention), or if Google

136

# throttles requests to the site for abuse prevention. You should not

137

# depend on externally-hosted images for production applications.

138

#

139

# When both `gcs_image_uri` and `image_uri` are specified, `image_uri` takes

140

# precedence.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

141

},

142

},

143

"features": [ # Requested features.

144

{ # The type of Google Cloud Vision API detection to perform, and the maximum

145

# number of results to return for that type. Multiple `Feature` objects can

146

# be specified in the `features` list.

147

"type": "A String", # The feature type.

148

"maxResults": 42, # Maximum number of results of this type. Does not apply to

149

# `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.

150

"model": "A String", # Model to use for the feature.

151

# Supported values: "builtin/stable" (the default if unset) and

# "builtin/latest".

},

],

"imageContext": { # Image context and/or feature-specific parameters. # Additional context that may accompany the image.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

156

"cropHintsParams": { # Parameters for crop hints annotation request. # Parameters for crop hints annotation request.

157

"aspectRatios": [ # Aspect ratios in floats, representing the ratio of the width to the height

158

# of the image. For example, if the desired aspect ratio is 4/3, the

159

# corresponding float value should be 1.33333. If not specified, the

160

# best possible crop is returned. The number of provided aspect ratios is

161

# limited to a maximum of 16; any aspect ratios provided after the 16th are

# ignored.

3.14,

],

},

"productSearchParams": { # Parameters for a product search request. # Parameters for product search.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

167

"productCategories": [ # The list of product categories to search in. Currently, we only consider

168

# the first category, and either "homegoods-v2", "apparel-v2", "toys-v2",

169

# "packagedgoods-v1", or "general-v1" should be specified. The legacy

170

# categories "homegoods", "apparel", and "toys" are still supported but will

171

# be deprecated. For new products, please use "homegoods-v2", "apparel-v2",

172

# or "toys-v2" for better product search accuracy. It is recommended to

173

# migrate existing products to these categories as well.

174

"A String",

175

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

176

"boundingPoly": { # A bounding polygon for the detected image annotation. # The bounding polygon around the area of interest in the image.

177

# If it is not specified, system discretion will be applied.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

178

"vertices": [ # The bounding polygon vertices.

179

{ # A vertex represents a 2D point in the image.

180

# NOTE: the vertex coordinates are in the same scale as the original image.

181

"x": 42, # X coordinate.

182

"y": 42, # Y coordinate.

183

},

184

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

185

"normalizedVertices": [ # The bounding polygon normalized vertices.

186

{ # A vertex represents a 2D point in the image.

187

# NOTE: the normalized vertex coordinates are relative to the original image

188

# and range from 0 to 1.

189

"x": 3.14, # X coordinate.

190

"y": 3.14, # Y coordinate.

191

},

192

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

193

},

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

194

"productSet": "A String", # The resource name of a ProductSet to be searched for similar images.

195

#

196

# Format is:

197

# `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.

198

"filter": "A String", # The filtering expression. This can be used to restrict search results based

199

# on Product labels. We currently support an AND of OR of key-value

200

# expressions, where each expression within an OR must have the same key. An

201

# '=' should be used to connect the key and value.

202

#

203

# For example, "(color = red OR color = blue) AND brand = Google" is

204

# acceptable, but "(color = red OR brand = Google)" is not acceptable.

205

# "color: red" is not acceptable because it uses a ':' instead of an '='.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

206

},

207

"languageHints": [ # List of languages to use for TEXT_DETECTION. In most cases, an empty value

208

# yields the best results since it enables automatic language detection. For

209

# languages based on the Latin alphabet, setting `language_hints` is not

210

# needed. In rare cases, when the language of the text in the image is known,

211

# setting a hint will help get better results (although it will be a

212

# significant hindrance if the hint is wrong). Text detection returns an

213

# error if one or more of the specified languages is not one of the

214

# [supported languages](https://cloud.google.com/vision/docs/languages).

215

"A String",

216

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

217

"latLongRect": { # Rectangle determined by min and max `LatLng` pairs. # Not used.

218

"maxLatLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Max lat/long pair.

219

# of doubles representing degrees latitude and degrees longitude. Unless

220

# specified otherwise, this must conform to the

221

# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84

222

# standard</a>. Values must be within normalized ranges.

223

"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].

224

"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].

225

},

226

"minLatLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Min lat/long pair.

227

# of doubles representing degrees latitude and degrees longitude. Unless

228

# specified otherwise, this must conform to the

229

# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84

230

# standard</a>. Values must be within normalized ranges.

231

"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].

232

"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].

233

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

234

},

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

235

"webDetectionParams": { # Parameters for web detection request. # Parameters for web detection.

236

"includeGeoResults": True or False, # Whether to include results derived from the geo information in the image.

237

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

238

},

239

},

240

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

241

"parent": "A String", # Optional. Target project and location to make a call.

242

#

243

# Format: `projects/{project-id}/locations/{location-id}`.

244

#

245

# If no parent is specified, a region will be chosen automatically.

246

#

247

# Supported location-ids:

248

# `us`: USA country only,

249

# `asia`: East asia areas, like Japan, Taiwan,

250

# `eu`: The European Union.

251

#

252

# Example: `projects/project-A/locations/eu`.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

253

}

254

255

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

262

263

{ # Response to a batch image annotation request.

264

"responses": [ # Individual responses to image annotation requests within the batch.

265

{ # Response to an image annotation request.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

266

"productSearchResults": { # Results for a product search request. # If present, product search has completed successfully.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

267

"indexTime": "A String", # Timestamp of the index which provided these results. Products added to the

268

# product set and products removed from the product set after this time are

269

# not reflected in the current results.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

270

"results": [ # List of results, one for each product match.

271

{ # Information about a product.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

272

"score": 3.14, # A confidence level on the match, ranging from 0 (no confidence) to

273

# 1 (full confidence).

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

274

"image": "A String", # The resource name of the image from the product that is the closest match

275

# to the query.

276

"product": { # A Product contains ReferenceImages. # The Product.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

277

"displayName": "A String", # The user-provided name for this Product. Must not be empty. Must be at most

278

# 4096 characters long.

279

"name": "A String", # The resource name of the product.

280

#

281

# Format is:

282

# `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.

283

#

284

# This field is ignored when creating a product.

285

"description": "A String", # User-provided metadata to be stored with this product. Must be at most 4096

286

# characters long.

287

"productCategory": "A String", # Immutable. The category for the product identified by the reference image. This should

288

# be either "homegoods-v2", "apparel-v2", or "toys-v2". The legacy categories

289

# "homegoods", "apparel", and "toys" are still supported, but these should

290

# not be used for new products.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

291

"productLabels": [ # Key-value pairs that can be attached to a product. At query time,

292

# constraints can be specified based on the product_labels.

293

#

294

# Note that integer values can be provided as strings, e.g. "1199". Only

295

# strings with integer values can match a range-based restriction which is

296

# to be supported soon.

297

#

298

# Multiple values can be assigned to the same key. One product may have up to

299

# 500 product_labels.

300

#

301

# Notice that the total number of distinct product_labels over all products

302

# in one ProductSet cannot exceed 1M, otherwise the product search pipeline

303

# will refuse to work for that ProductSet.

304

{ # A product label represented as a key-value pair.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

305

"key": "A String", # The key of the label attached to the product. Cannot be empty and cannot

306

# exceed 128 bytes.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

307

"value": "A String", # The value of the label attached to the product. Cannot be empty and

308

# cannot exceed 128 bytes.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

309

},

310

],

311

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

312

},

313

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

314

"productGroupedResults": [ # List of results grouped by products detected in the query image. Each entry

315

# corresponds to one bounding polygon in the query image, and contains the

316

# matching products specific to that region. There may be duplicate product

317

# matches in the union of all the per-product results.

318

{ # Information about the products similar to a single product in a query

319

# image.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

320

"boundingPoly": { # A bounding polygon for the detected image annotation. # The bounding polygon around the product detected in the query image.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

321

"vertices": [ # The bounding polygon vertices.

322

{ # A vertex represents a 2D point in the image.

323

# NOTE: the vertex coordinates are in the same scale as the original image.

324

"x": 42, # X coordinate.

325

"y": 42, # Y coordinate.

326

},

327

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

328

"normalizedVertices": [ # The bounding polygon normalized vertices.

329

{ # A vertex represents a 2D point in the image.

330

# NOTE: the normalized vertex coordinates are relative to the original image

331

# and range from 0 to 1.

332

"x": 3.14, # X coordinate.

333

"y": 3.14, # Y coordinate.

334

},

335

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

336

},

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

337

"objectAnnotations": [ # List of generic predictions for the object in the bounding box.

338

{ # Prediction for what the object in the bounding box is.

339

"score": 3.14, # Score of the result. Range [0, 1].

340

"languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more

341

# information, see

342

# http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

343

"mid": "A String", # Object ID that should align with EntityAnnotation mid.

344

"name": "A String", # Object name, expressed in its `language_code` language.

345

},

346

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

347

"results": [ # List of results, one for each product match.

348

{ # Information about a product.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

349

"score": 3.14, # A confidence level on the match, ranging from 0 (no confidence) to

350

# 1 (full confidence).

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

351

"image": "A String", # The resource name of the image from the product that is the closest match

352

# to the query.

353

"product": { # A Product contains ReferenceImages. # The Product.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

354

"displayName": "A String", # The user-provided name for this Product. Must not be empty. Must be at most

355

# 4096 characters long.

356

"name": "A String", # The resource name of the product.

357

#

358

# Format is:

359

# `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.

360

#

361

# This field is ignored when creating a product.

362

"description": "A String", # User-provided metadata to be stored with this product. Must be at most 4096

363

# characters long.

364

"productCategory": "A String", # Immutable. The category for the product identified by the reference image. This should

365

# be either "homegoods-v2", "apparel-v2", or "toys-v2". The legacy categories

366

# "homegoods", "apparel", and "toys" are still supported, but these should

367

# not be used for new products.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

368

"productLabels": [ # Key-value pairs that can be attached to a product. At query time,

369

# constraints can be specified based on the product_labels.

370

#

371

# Note that integer values can be provided as strings, e.g. "1199". Only

372

# strings with integer values can match a range-based restriction which is

373

# to be supported soon.

374

#

375

# Multiple values can be assigned to the same key. One product may have up to

376

# 500 product_labels.

377

#

378

# Notice that the total number of distinct product_labels over all products

379

# in one ProductSet cannot exceed 1M, otherwise the product search pipeline

380

# will refuse to work for that ProductSet.

381

{ # A product label represented as a key-value pair.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

382

"key": "A String", # The key of the label attached to the product. Cannot be empty and cannot

383

# exceed 128 bytes.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

384

"value": "A String", # The value of the label attached to the product. Cannot be empty and

385

# cannot exceed 128 bytes.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

386

},

387

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

388

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

},

],

},

],

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

393

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

394

"textAnnotations": [ # If present, text (OCR) detection has completed successfully.

395

{ # Set of detected entity features.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

396

"topicality": 3.14, # The relevancy of the ICA (Image Content Annotation) label to the

397

# image. For example, the relevancy of "tower" is likely higher to an image

398

# containing the detected "Eiffel Tower" than to an image containing a

399

# detected distant towering building, even though the confidence that

400

# there is a tower in each image may be the same. Range [0, 1].

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

401

"locale": "A String", # The language code for the locale in which the entity textual

402

# `description` is expressed.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

403

"locations": [ # The location information for the detected entity. Multiple

404

# `LocationInfo` elements can be present because one location may

405

# indicate the location of the scene in the image, and another location

406

# may indicate the location of the place where the image was taken.

407

# Location information is usually present for landmarks.

408

{ # Detected entity location information.

409

"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # lat/long location coordinates.

410

# of doubles representing degrees latitude and degrees longitude. Unless

411

# specified otherwise, this must conform to the

412

# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84

413

# standard</a>. Values must be within normalized ranges.

414

"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].

415

"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].

},

},

],

"mid": "A String", # Opaque entity ID. Some IDs may be available in

420

# [Google Knowledge Graph Search

421

# API](https://developers.google.com/knowledge-graph/).

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

422

"description": "A String", # Entity textual description, expressed in its `locale` language.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

423

"confidence": 3.14, # **Deprecated. Use `score` instead.**

424

# The accuracy of the entity detection in an image.

425

# For example, for an image in which the "Eiffel Tower" entity is detected,

426

# this field represents the confidence that there is a tower in the query

427

# image. Range [0, 1].

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

428

"boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Not produced

429

# for `LABEL_DETECTION` features.

430

"vertices": [ # The bounding polygon vertices.

431

{ # A vertex represents a 2D point in the image.

432

# NOTE: the vertex coordinates are in the same scale as the original image.

433

"x": 42, # X coordinate.

434

"y": 42, # Y coordinate.

435

},

436

],

437

"normalizedVertices": [ # The bounding polygon normalized vertices.

438

{ # A vertex represents a 2D point in the image.

439

# NOTE: the normalized vertex coordinates are relative to the original image

440

# and range from 0 to 1.

441

"x": 3.14, # X coordinate.

442

"y": 3.14, # Y coordinate.

},

],

},

"properties": [ # Some entities may have optional user-supplied `Property` (name/value)

447

# fields, such a score or string that qualifies the entity.

448

{ # A `Property` consists of a user-supplied name/value pair.

449

"uint64Value": "A String", # Value of numeric properties.

450

"value": "A String", # Value of the property.

451

"name": "A String", # Name of the property.

452

},

453

],

454

"score": 3.14, # Overall score of the result. Range [0, 1].

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

455

},

456

],

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

457

"safeSearchAnnotation": { # Set of features pertaining to the image, computed by computer vision # If present, safe-search annotation has completed successfully.

458

# methods over safe-search verticals (for example, adult, spoof, medical,

459

# violence).

460

"racy": "A String", # Likelihood that the request image contains racy content. Racy content may

461

# include (but is not limited to) skimpy or sheer clothing, strategically

462

# covered nudity, lewd or provocative poses, or close-ups of sensitive

463

# body areas.

464

"medical": "A String", # Likelihood that this is a medical image.

465

"adult": "A String", # Represents the adult content likelihood for the image. Adult content may

466

# contain elements such as nudity, pornographic images or cartoons, or

467

# sexual activities.

468

"violence": "A String", # Likelihood that this image contains violent content.

469

"spoof": "A String", # Spoof likelihood. The likelihood that an modification

470

# was made to the image's canonical version to make it appear

471

# funny or offensive.

472

},

473

"webDetection": { # Relevant information for the image from the Internet. # If present, web detection has completed successfully.

474

"fullMatchingImages": [ # Fully matching images from the Internet.

475

# Can include resized copies of the query image.

476

{ # Metadata for online images.

477

"score": 3.14, # (Deprecated) Overall relevancy score for the image.

478

"url": "A String", # The result image URL.

479

},

480

],

481

"bestGuessLabels": [ # The service's best guess as to the topic of the request image.

482

# Inferred from similar images on the open web.

483

{ # Label to provide extra metadata for the web detection.

484

"languageCode": "A String", # The BCP-47 language code for `label`, such as "en-US" or "sr-Latn".

485

# For more information, see

486

# http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

487

"label": "A String", # Label for extra metadata.

488

},

489

],

490

"visuallySimilarImages": [ # The visually similar image results.

491

{ # Metadata for online images.

492

"score": 3.14, # (Deprecated) Overall relevancy score for the image.

493

"url": "A String", # The result image URL.

494

},

495

],

496

"partialMatchingImages": [ # Partial matching images from the Internet.

497

# Those images are similar enough to share some key-point features. For

498

# example an original image will likely have partial matching for its crops.

499

{ # Metadata for online images.

500

"score": 3.14, # (Deprecated) Overall relevancy score for the image.

501

"url": "A String", # The result image URL.

502

},

503

],

504

"webEntities": [ # Deduced entities from similar images on the Internet.

505

{ # Entity deduced from similar images on the Internet.

506

"entityId": "A String", # Opaque entity ID.

507

"score": 3.14, # Overall relevancy score for the entity.

508

# Not normalized and not comparable across different image queries.

509

"description": "A String", # Canonical description of the entity, in English.

510

},

511

],

512

"pagesWithMatchingImages": [ # Web pages containing the matching images from the Internet.

513

{ # Metadata for web pages.

514

"partialMatchingImages": [ # Partial matching images on the page.

515

# Those images are similar enough to share some key-point features. For

516

# example an original image will likely have partial matching for its

517

# crops.

518

{ # Metadata for online images.

519

"score": 3.14, # (Deprecated) Overall relevancy score for the image.

520

"url": "A String", # The result image URL.

521

},

522

],

523

"url": "A String", # The result web page URL.

524

"fullMatchingImages": [ # Fully matching images on the page.

525

# Can include resized copies of the query image.

526

{ # Metadata for online images.

527

"score": 3.14, # (Deprecated) Overall relevancy score for the image.

528

"url": "A String", # The result image URL.

529

},

530

],

531

"score": 3.14, # (Deprecated) Overall relevancy score for the web page.

532

"pageTitle": "A String", # Title for the web page, may contain HTML markups.

533

},

534

],

535

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

536

"imagePropertiesAnnotation": { # Stores image properties, such as dominant colors. # If present, image properties were extracted successfully.

537

"dominantColors": { # Set of dominant colors and their corresponding scores. # If present, dominant colors completed successfully.

538

"colors": [ # RGB color values with their score and pixel fraction.

539

{ # Color information consists of RGB channels, score, and the fraction of

540

# the image that the color occupies in the image.

541

"pixelFraction": 3.14, # The fraction of pixels the color occupies in the image.

542

# Value in range [0, 1].

543

"color": { # Represents a color in the RGBA color space. This representation is designed # RGB components of the color.

544

# for simplicity of conversion to/from color representations in various

545

# languages over compactness; for example, the fields of this representation

546

# can be trivially provided to the constructor of "java.awt.Color" in Java; it

547

# can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"

548

# method in iOS; and, with just a little work, it can be easily formatted into

549

# a CSS "rgba()" string in JavaScript, as well.

550

#

551

# Note: this proto does not carry information about the absolute color space

552

# that should be used to interpret the RGB value (e.g. sRGB, Adobe RGB,

553

# DCI-P3, BT.2020, etc.). By default, applications SHOULD assume the sRGB color

554

# space.

555

#

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

556

# Note: when color equality needs to be decided, implementations, unless

557

# documented otherwise, will treat two colors to be equal if all their red,

558

# green, blue and alpha values each differ by at most 1e-5.

559

#

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

560

# Example (Java):

561

#

562

# import com.google.type.Color;

563

#

564

# // ...

565

# public static java.awt.Color fromProto(Color protocolor) {

566

# float alpha = protocolor.hasAlpha()

567

# ? protocolor.getAlpha().getValue()

568

# : 1.0;

569

#

570

# return new java.awt.Color(

571

# protocolor.getRed(),

572

# protocolor.getGreen(),

573

# protocolor.getBlue(),

# alpha);

# }

#

# public static Color toProto(java.awt.Color color) {

578

# float red = (float) color.getRed();

579

# float green = (float) color.getGreen();

580

# float blue = (float) color.getBlue();

581

# float denominator = 255.0;

582

# Color.Builder resultBuilder =

583

# Color

584

# .newBuilder()

585

# .setRed(red / denominator)

586

# .setGreen(green / denominator)

587

# .setBlue(blue / denominator);

588

# int alpha = color.getAlpha();

589

# if (alpha != 255) {

# result.setAlpha(

# FloatValue

# .newBuilder()

# .setValue(((float) alpha) / denominator)

594

# .build());

595

# }

596

# return resultBuilder.build();

# }

# // ...

#

# Example (iOS / Obj-C):

601

#

602

# // ...

603

# static UIColor* fromProto(Color* protocolor) {

604

# float red = [protocolor red];

605

# float green = [protocolor green];

606

# float blue = [protocolor blue];

607

# FloatValue* alpha_wrapper = [protocolor alpha];

608

# float alpha = 1.0;

609

# if (alpha_wrapper != nil) {

610

# alpha = [alpha_wrapper value];

611

# }

612

# return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];

613

# }

614

#

615

# static Color* toProto(UIColor* color) {

616

# CGFloat red, green, blue, alpha;

617

# if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {

618

# return nil;

619

# }

620

# Color* result = [[Color alloc] init];

621

# [result setRed:red];

622

# [result setGreen:green];

623

# [result setBlue:blue];

624

# if (alpha <= 0.9999) {

625

# [result setAlpha:floatWrapperWithValue(alpha)];

626

# }

627

# [result autorelease];

# return result;

# }

# // ...

#

# Example (JavaScript):

#

# // ...

#

# var protoToCssColor = function(rgb_color) {

637

# var redFrac = rgb_color.red || 0.0;

638

# var greenFrac = rgb_color.green || 0.0;

639

# var blueFrac = rgb_color.blue || 0.0;

640

# var red = Math.floor(redFrac * 255);

641

# var green = Math.floor(greenFrac * 255);

642

# var blue = Math.floor(blueFrac * 255);

643

#

644

# if (!('alpha' in rgb_color)) {

645

# return rgbToCssColor_(red, green, blue);

646

# }

647

#

648

# var alphaFrac = rgb_color.alpha.value || 0.0;

649

# var rgbParams = [red, green, blue].join(',');

650

# return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');

651

# };

652

#

653

# var rgbToCssColor_ = function(red, green, blue) {

654

# var rgbNumber = new Number((red << 16) | (green << 8) | blue);

655

# var hexString = rgbNumber.toString(16);

656

# var missingZeros = 6 - hexString.length;

657

# var resultBuilder = ['#'];

658

# for (var i = 0; i < missingZeros; i++) {

659

# resultBuilder.push('0');

660

# }

661

# resultBuilder.push(hexString);

662

# return resultBuilder.join('');

663

# };

664

#

665

# // ...

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

666

"red": 3.14, # The amount of red in the color as a value in the interval [0, 1].

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

667

"alpha": 3.14, # The fraction of this color that should be applied to the pixel. That is,

668

# the final pixel color is defined by the equation:

669

#

670

# pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

671

#

672

# This means that a value of 1.0 corresponds to a solid color, whereas

673

# a value of 0.0 corresponds to a completely transparent color. This

674

# uses a wrapper message rather than a simple float scalar so that it is

675

# possible to distinguish between a default value and the value being unset.

676

# If omitted, this color object is to be rendered as a solid color

677

# (as if the alpha value had been explicitly given with a value of 1.0).

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

678

"blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1].

679

"green": 3.14, # The amount of green in the color as a value in the interval [0, 1].

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

680

},

681

"score": 3.14, # Image-specific score for this color. Value in range [0, 1].

},

],

},

},

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

686

"cropHintsAnnotation": { # Set of crop hints that are used to generate new crops when serving images. # If present, crop hints have completed successfully.

687

"cropHints": [ # Crop hint results.

688

{ # Single crop hint that is used to generate a new crop when serving an image.

689

"boundingPoly": { # A bounding polygon for the detected image annotation. # The bounding polygon for the crop region. The coordinates of the bounding

690

# box are in the original image's scale.

691

"vertices": [ # The bounding polygon vertices.

692

{ # A vertex represents a 2D point in the image.

693

# NOTE: the vertex coordinates are in the same scale as the original image.

694

"x": 42, # X coordinate.

695

"y": 42, # Y coordinate.

696

},

697

],

698

"normalizedVertices": [ # The bounding polygon normalized vertices.

699

{ # A vertex represents a 2D point in the image.

700

# NOTE: the normalized vertex coordinates are relative to the original image

701

# and range from 0 to 1.

702

"x": 3.14, # X coordinate.

703

"y": 3.14, # Y coordinate.

},

],

},

"importanceFraction": 3.14, # Fraction of importance of this salient region with respect to the original

708

# image.

709

"confidence": 3.14, # Confidence of this being a salient region. Range [0, 1].

},

],

},

"fullTextAnnotation": { # TextAnnotation contains a structured representation of OCR extracted text. # If present, text (OCR) detection or document (OCR) text detection has

714

# completed successfully.

715

# This annotation provides the structural hierarchy for the OCR detected

716

# text.

717

# The hierarchy of an OCR extracted text structure is like this:

718

# TextAnnotation -> Page -> Block -> Paragraph -> Word -> Symbol

719

# Each structural component, starting from Page, may further have their own

720

# properties. Properties describe detected languages, breaks etc.. Please refer

721

# to the TextAnnotation.TextProperty message definition below for more

722

# detail.

723

"text": "A String", # UTF-8 text detected on the pages.

724

"pages": [ # List of pages detected by OCR.

725

{ # Detected page from OCR.

726

"blocks": [ # List of blocks of text, images etc on this page.

727

{ # Logical element on the page.

728

"blockType": "A String", # Detected block type (text, image etc) for this block.

729

"paragraphs": [ # List of paragraphs in this block (if this blocks is of type text).

730

{ # Structural unit of text representing a number of words in certain order.

731

"confidence": 3.14, # Confidence of the OCR results for the paragraph. Range [0, 1].

732

"property": { # Additional information detected on the structural component. # Additional information detected for the paragraph.

733

"detectedBreak": { # Detected start or end of a structural component. # Detected start or end of a text segment.

734

"type": "A String", # Detected break type.

735

"isPrefix": True or False, # True if break prepends the element.

736

},

737

"detectedLanguages": [ # A list of detected languages together with confidence.

738

{ # Detected language for a structural component.

739

"confidence": 3.14, # Confidence of detected language. Range [0, 1].

740

"languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more

741

# information, see

742

# http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

},

],

},

"boundingBox": { # A bounding polygon for the detected image annotation. # The bounding box for the paragraph.

747

# The vertices are in the order of top-left, top-right, bottom-right,

748

# bottom-left. When a rotation of the bounding box is detected the rotation

749

# is represented as around the top-left corner as defined when the text is

750

# read in the 'natural' orientation.

751

# For example:

752

# * when the text is horizontal it might look like:

# 0----1

# | |

# 3----2

# * when it's rotated 180 degrees around the top-left corner it becomes:

# 2----3

# | |

# 1----0

# and the vertex order will still be (0, 1, 2, 3).

761

"vertices": [ # The bounding polygon vertices.

762

{ # A vertex represents a 2D point in the image.

763

# NOTE: the vertex coordinates are in the same scale as the original image.

764

"x": 42, # X coordinate.

765

"y": 42, # Y coordinate.

766

},

767

],

768

"normalizedVertices": [ # The bounding polygon normalized vertices.

769

{ # A vertex represents a 2D point in the image.

770

# NOTE: the normalized vertex coordinates are relative to the original image

771

# and range from 0 to 1.

772

"x": 3.14, # X coordinate.

773

"y": 3.14, # Y coordinate.

},

],

},

"words": [ # List of all words in this paragraph.

778

{ # A word representation.

779

"confidence": 3.14, # Confidence of the OCR results for the word. Range [0, 1].

780

"boundingBox": { # A bounding polygon for the detected image annotation. # The bounding box for the word.

781

# The vertices are in the order of top-left, top-right, bottom-right,

782

# bottom-left. When a rotation of the bounding box is detected the rotation

783

# is represented as around the top-left corner as defined when the text is

784

# read in the 'natural' orientation.

785

# For example:

786

# * when the text is horizontal it might look like:

# 0----1

# | |

# 3----2

# * when it's rotated 180 degrees around the top-left corner it becomes:

# 2----3

# | |

# 1----0

# and the vertex order will still be (0, 1, 2, 3).

795

"vertices": [ # The bounding polygon vertices.

796

{ # A vertex represents a 2D point in the image.

797

# NOTE: the vertex coordinates are in the same scale as the original image.

798

"x": 42, # X coordinate.

799

"y": 42, # Y coordinate.

800

},

801

],

802

"normalizedVertices": [ # The bounding polygon normalized vertices.

803

{ # A vertex represents a 2D point in the image.

804

# NOTE: the normalized vertex coordinates are relative to the original image

805

# and range from 0 to 1.

806

"x": 3.14, # X coordinate.

807

"y": 3.14, # Y coordinate.

},

],

},

"property": { # Additional information detected on the structural component. # Additional information detected for the word.

812

"detectedBreak": { # Detected start or end of a structural component. # Detected start or end of a text segment.

813

"type": "A String", # Detected break type.

814

"isPrefix": True or False, # True if break prepends the element.

815

},

816

"detectedLanguages": [ # A list of detected languages together with confidence.

817

{ # Detected language for a structural component.

818

"confidence": 3.14, # Confidence of detected language. Range [0, 1].

819

"languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more

820

# information, see

821

# http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

},

],

},

"symbols": [ # List of symbols in the word.

826

# The order of the symbols follows the natural reading order.

827

{ # A single symbol representation.

828

"confidence": 3.14, # Confidence of the OCR results for the symbol. Range [0, 1].

829

"property": { # Additional information detected on the structural component. # Additional information detected for the symbol.

830

"detectedBreak": { # Detected start or end of a structural component. # Detected start or end of a text segment.

831

"type": "A String", # Detected break type.

832

"isPrefix": True or False, # True if break prepends the element.

833

},

834

"detectedLanguages": [ # A list of detected languages together with confidence.

835

{ # Detected language for a structural component.

836

"confidence": 3.14, # Confidence of detected language. Range [0, 1].

837

"languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more

838

# information, see

839

# http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

},

],

},

"text": "A String", # The actual UTF-8 representation of the symbol.

844

"boundingBox": { # A bounding polygon for the detected image annotation. # The bounding box for the symbol.

845

# The vertices are in the order of top-left, top-right, bottom-right,

846

# bottom-left. When a rotation of the bounding box is detected the rotation

847

# is represented as around the top-left corner as defined when the text is

848

# read in the 'natural' orientation.

849

# For example:

850

# * when the text is horizontal it might look like:

# 0----1

# | |

# 3----2

# * when it's rotated 180 degrees around the top-left corner it becomes:

# 2----3

# | |

# 1----0

# and the vertex order will still be (0, 1, 2, 3).

859

"vertices": [ # The bounding polygon vertices.

860

{ # A vertex represents a 2D point in the image.

861

# NOTE: the vertex coordinates are in the same scale as the original image.

862

"x": 42, # X coordinate.

863

"y": 42, # Y coordinate.

864

},

865

],

866

"normalizedVertices": [ # The bounding polygon normalized vertices.

867

{ # A vertex represents a 2D point in the image.

868

# NOTE: the normalized vertex coordinates are relative to the original image

869

# and range from 0 to 1.

870

"x": 3.14, # X coordinate.

871

"y": 3.14, # Y coordinate.

},

],

},

},

],

},

],

},

],

"boundingBox": { # A bounding polygon for the detected image annotation. # The bounding box for the block.

882

# The vertices are in the order of top-left, top-right, bottom-right,

883

# bottom-left. When a rotation of the bounding box is detected the rotation

884

# is represented as around the top-left corner as defined when the text is

885

# read in the 'natural' orientation.

886

# For example:

887

#

888

# * when the text is horizontal it might look like:

#

# 0----1

# | |

# 3----2

#

# * when it's rotated 180 degrees around the top-left corner it becomes:

#

# 2----3

# | |

# 1----0

#

# and the vertex order will still be (0, 1, 2, 3).

901

"vertices": [ # The bounding polygon vertices.

902

{ # A vertex represents a 2D point in the image.

903

# NOTE: the vertex coordinates are in the same scale as the original image.

904

"x": 42, # X coordinate.

905

"y": 42, # Y coordinate.

906

},

907

],

908

"normalizedVertices": [ # The bounding polygon normalized vertices.

909

{ # A vertex represents a 2D point in the image.

910

# NOTE: the normalized vertex coordinates are relative to the original image

911

# and range from 0 to 1.

912

"x": 3.14, # X coordinate.

913

"y": 3.14, # Y coordinate.

},

],

},

"confidence": 3.14, # Confidence of the OCR results on the block. Range [0, 1].

918

"property": { # Additional information detected on the structural component. # Additional information detected for the block.

919

"detectedBreak": { # Detected start or end of a structural component. # Detected start or end of a text segment.

920

"type": "A String", # Detected break type.

921

"isPrefix": True or False, # True if break prepends the element.

922

},

923

"detectedLanguages": [ # A list of detected languages together with confidence.

924

{ # Detected language for a structural component.

925

"confidence": 3.14, # Confidence of detected language. Range [0, 1].

926

"languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more

927

# information, see

928

# http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

},

],

},

},

],

"property": { # Additional information detected on the structural component. # Additional information detected on the page.

935

"detectedBreak": { # Detected start or end of a structural component. # Detected start or end of a text segment.

936

"type": "A String", # Detected break type.

937

"isPrefix": True or False, # True if break prepends the element.

938

},

939

"detectedLanguages": [ # A list of detected languages together with confidence.

940

{ # Detected language for a structural component.

941

"confidence": 3.14, # Confidence of detected language. Range [0, 1].

942

"languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more

943

# information, see

944

# http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

},

],

},

"width": 42, # Page width. For PDFs the unit is points. For images (including

949

# TIFFs) the unit is pixels.

950

"confidence": 3.14, # Confidence of the OCR results on the page. Range [0, 1].

951

"height": 42, # Page height. For PDFs the unit is points. For images (including

952

# TIFFs) the unit is pixels.

},

],

},

"error": { # The `Status` type defines a logical error model that is suitable for # If set, represents the error message for the operation.

957

# Note that filled-in image annotations are guaranteed to be

958

# correct, even when `error` is set.

959

# different programming environments, including REST APIs and RPC APIs. It is

960

# used by [gRPC](https://github.com/grpc). Each `Status` message contains

961

# three pieces of data: error code, error message, and error details.

962

#

963

# You can find out more about this error model and how to work with it in the

964

# [API Design Guide](https://cloud.google.com/apis/design/errors).

965

"code": 42, # The status code, which should be an enum value of google.rpc.Code.

966

"details": [ # A list of messages that carry the error details. There is a common set of

967

# message types for APIs to use.

968

{

969

"a_key": "", # Properties of the object. Contains field @type with type URL.

970

},

971

],

972

"message": "A String", # A developer-facing error message, which should be in English. Any

973

# user-facing error message should be localized and sent in the

974

# google.rpc.Status.details field, or localized by the client.

975

},

976

"localizedObjectAnnotations": [ # If present, localized object detection has completed successfully.

977

# This will be sorted descending by confidence score.

978

{ # Set of detected objects with bounding boxes.

979

"boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this object belongs. This must be populated.

980

"vertices": [ # The bounding polygon vertices.

981

{ # A vertex represents a 2D point in the image.

982

# NOTE: the vertex coordinates are in the same scale as the original image.

983

"x": 42, # X coordinate.

984

"y": 42, # Y coordinate.

985

},

986

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

987

"normalizedVertices": [ # The bounding polygon normalized vertices.

988

{ # A vertex represents a 2D point in the image.

989

# NOTE: the normalized vertex coordinates are relative to the original image

990

# and range from 0 to 1.

991

"x": 3.14, # X coordinate.

992

"y": 3.14, # Y coordinate.

993

},

994

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

995

},

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

996

"name": "A String", # Object name, expressed in its `language_code` language.

997

"mid": "A String", # Object ID that should align with EntityAnnotation mid.

998

"languageCode": "A String", # The BCP-47 language code, such as "en-US" or "sr-Latn". For more

999

# information, see

1000

# http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

1001

"score": 3.14, # Score of the result. Range [0, 1].

1002

},

1003

],

1004

"labelAnnotations": [ # If present, label detection has completed successfully.

1005

{ # Set of detected entity features.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1006

"topicality": 3.14, # The relevancy of the ICA (Image Content Annotation) label to the

1007

# image. For example, the relevancy of "tower" is likely higher to an image

1008

# containing the detected "Eiffel Tower" than to an image containing a

1009

# detected distant towering building, even though the confidence that

1010

# there is a tower in each image may be the same. Range [0, 1].

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1011

"locale": "A String", # The language code for the locale in which the entity textual

1012

# `description` is expressed.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1013

"locations": [ # The location information for the detected entity. Multiple

1014

# `LocationInfo` elements can be present because one location may

1015

# indicate the location of the scene in the image, and another location

1016

# may indicate the location of the place where the image was taken.

1017

# Location information is usually present for landmarks.

1018

{ # Detected entity location information.

1019

"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # lat/long location coordinates.

1020

# of doubles representing degrees latitude and degrees longitude. Unless

1021

# specified otherwise, this must conform to the

1022

# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84

1023

# standard</a>. Values must be within normalized ranges.

1024

"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].

1025

"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].

},

},

],

"mid": "A String", # Opaque entity ID. Some IDs may be available in

1030

# [Google Knowledge Graph Search

1031

# API](https://developers.google.com/knowledge-graph/).

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1032

"description": "A String", # Entity textual description, expressed in its `locale` language.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1033

"confidence": 3.14, # **Deprecated. Use `score` instead.**

1034

# The accuracy of the entity detection in an image.

1035

# For example, for an image in which the "Eiffel Tower" entity is detected,

1036

# this field represents the confidence that there is a tower in the query

1037

# image. Range [0, 1].

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1038

"boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Not produced

1039

# for `LABEL_DETECTION` features.

1040

"vertices": [ # The bounding polygon vertices.

1041

{ # A vertex represents a 2D point in the image.

1042

# NOTE: the vertex coordinates are in the same scale as the original image.

1043

"x": 42, # X coordinate.

1044

"y": 42, # Y coordinate.

1045

},

1046

],

1047

"normalizedVertices": [ # The bounding polygon normalized vertices.

1048

{ # A vertex represents a 2D point in the image.

1049

# NOTE: the normalized vertex coordinates are relative to the original image

1050

# and range from 0 to 1.

1051

"x": 3.14, # X coordinate.

1052

"y": 3.14, # Y coordinate.

},

],

},

"properties": [ # Some entities may have optional user-supplied `Property` (name/value)

1057

# fields, such a score or string that qualifies the entity.

1058

{ # A `Property` consists of a user-supplied name/value pair.

1059

"uint64Value": "A String", # Value of numeric properties.

1060

"value": "A String", # Value of the property.

1061

"name": "A String", # Name of the property.

1062

},

1063

],

1064

"score": 3.14, # Overall score of the result. Range [0, 1].

1065

},

1066

],

1067

"logoAnnotations": [ # If present, logo detection has completed successfully.

1068

{ # Set of detected entity features.

1069

"topicality": 3.14, # The relevancy of the ICA (Image Content Annotation) label to the

1070

# image. For example, the relevancy of "tower" is likely higher to an image

1071

# containing the detected "Eiffel Tower" than to an image containing a

1072

# detected distant towering building, even though the confidence that

1073

# there is a tower in each image may be the same. Range [0, 1].

1074

"locale": "A String", # The language code for the locale in which the entity textual

1075

# `description` is expressed.

1076

"locations": [ # The location information for the detected entity. Multiple

1077

# `LocationInfo` elements can be present because one location may

1078

# indicate the location of the scene in the image, and another location

1079

# may indicate the location of the place where the image was taken.

1080

# Location information is usually present for landmarks.

1081

{ # Detected entity location information.

1082

"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # lat/long location coordinates.

1083

# of doubles representing degrees latitude and degrees longitude. Unless

1084

# specified otherwise, this must conform to the

1085

# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84

1086

# standard</a>. Values must be within normalized ranges.

1087

"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].

1088

"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].

},

},

],

"mid": "A String", # Opaque entity ID. Some IDs may be available in

1093

# [Google Knowledge Graph Search

1094

# API](https://developers.google.com/knowledge-graph/).

1095

"description": "A String", # Entity textual description, expressed in its `locale` language.

1096

"confidence": 3.14, # **Deprecated. Use `score` instead.**

1097

# The accuracy of the entity detection in an image.

1098

# For example, for an image in which the "Eiffel Tower" entity is detected,

1099

# this field represents the confidence that there is a tower in the query

1100

# image. Range [0, 1].

1101

"boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Not produced

1102

# for `LABEL_DETECTION` features.

1103

"vertices": [ # The bounding polygon vertices.

1104

{ # A vertex represents a 2D point in the image.

1105

# NOTE: the vertex coordinates are in the same scale as the original image.

1106

"x": 42, # X coordinate.

1107

"y": 42, # Y coordinate.

1108

},

1109

],

1110

"normalizedVertices": [ # The bounding polygon normalized vertices.

1111

{ # A vertex represents a 2D point in the image.

1112

# NOTE: the normalized vertex coordinates are relative to the original image

1113

# and range from 0 to 1.

1114

"x": 3.14, # X coordinate.

1115

"y": 3.14, # Y coordinate.

},

],

},

"properties": [ # Some entities may have optional user-supplied `Property` (name/value)

1120

# fields, such a score or string that qualifies the entity.

1121

{ # A `Property` consists of a user-supplied name/value pair.

1122

"uint64Value": "A String", # Value of numeric properties.

1123

"value": "A String", # Value of the property.

1124

"name": "A String", # Name of the property.

1125

},

1126

],

1127

"score": 3.14, # Overall score of the result. Range [0, 1].

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1128

},

1129

],

1130

"context": { # If an image was produced from a file (e.g. a PDF), this message gives # If present, contextual information is needed to understand where this image

1131

# comes from.

1132

# information about the source of that image.

1133

"uri": "A String", # The URI of the file used to produce the image.

1134

"pageNumber": 42, # If the file was a PDF or TIFF, this field gives the page number within

1135

# the file used to produce the image.

1136

},

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1137

"faceAnnotations": [ # If present, face detection has completed successfully.

1138

{ # A face annotation object contains the results of face detection.

1139

"surpriseLikelihood": "A String", # Surprise likelihood.

1140

"headwearLikelihood": "A String", # Headwear likelihood.

1141

"angerLikelihood": "A String", # Anger likelihood.

1142

"detectionConfidence": 3.14, # Detection confidence. Range [0, 1].

1143

"landmarkingConfidence": 3.14, # Face landmarking confidence. Range [0, 1].

1144

"blurredLikelihood": "A String", # Blurred likelihood.

1145

"tiltAngle": 3.14, # Pitch angle, which indicates the upwards/downwards angle that the face is

1146

# pointing relative to the image's horizontal plane. Range [-180,180].

1147

"sorrowLikelihood": "A String", # Sorrow likelihood.

1148

"panAngle": 3.14, # Yaw angle, which indicates the leftward/rightward angle that the face is

1149

# pointing relative to the vertical plane perpendicular to the image. Range

1150

# [-180,180].

1151

"landmarks": [ # Detected face landmarks.

1152

{ # A face-specific landmark (for example, a face feature).

1153

"position": { # A 3D position in the image, used primarily for Face detection landmarks. # Face landmark position.

1154

# A valid Position must have both x and y coordinates.

1155

# The position coordinates are in the same scale as the original image.

1156

"z": 3.14, # Z coordinate (or depth).

1157

"y": 3.14, # Y coordinate.

1158

"x": 3.14, # X coordinate.

1159

},

1160

"type": "A String", # Face landmark type.

1161

},

1162

],

1163

"rollAngle": 3.14, # Roll angle, which indicates the amount of clockwise/anti-clockwise rotation

1164

# of the face relative to the image vertical about the axis perpendicular to

1165

# the face. Range [-180,180].

1166

"underExposedLikelihood": "A String", # Under-exposed likelihood.

1167

"joyLikelihood": "A String", # Joy likelihood.

1168

"fdBoundingPoly": { # A bounding polygon for the detected image annotation. # The `fd_bounding_poly` bounding polygon is tighter than the

1169

# `boundingPoly`, and encloses only the skin part of the face. Typically, it

1170

# is used to eliminate the face from any image analysis that detects the

1171

# "amount of skin" visible in an image. It is not based on the

1172

# landmarker results, only on the initial face detection, hence

1173

# the <code>fd</code> (face detection) prefix.

1174

"vertices": [ # The bounding polygon vertices.

1175

{ # A vertex represents a 2D point in the image.

1176

# NOTE: the vertex coordinates are in the same scale as the original image.

1177

"x": 42, # X coordinate.

1178

"y": 42, # Y coordinate.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1179

},

1180

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1181

"normalizedVertices": [ # The bounding polygon normalized vertices.

1182

{ # A vertex represents a 2D point in the image.

1183

# NOTE: the normalized vertex coordinates are relative to the original image

1184

# and range from 0 to 1.

1185

"x": 3.14, # X coordinate.

1186

"y": 3.14, # Y coordinate.

1187

},

1188

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1189

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1190

"boundingPoly": { # A bounding polygon for the detected image annotation. # The bounding polygon around the face. The coordinates of the bounding box

1191

# are in the original image's scale.

1192

# The bounding box is computed to "frame" the face in accordance with human

1193

# expectations. It is based on the landmarker results.

1194

# Note that one or more x and/or y coordinates may not be generated in the

1195

# `BoundingPoly` (the polygon will be unbounded) if only a partial face

1196

# appears in the image to be annotated.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1197

"vertices": [ # The bounding polygon vertices.

1198

{ # A vertex represents a 2D point in the image.

1199

# NOTE: the vertex coordinates are in the same scale as the original image.

1200

"x": 42, # X coordinate.

1201

"y": 42, # Y coordinate.

1202

},

1203

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1204

"normalizedVertices": [ # The bounding polygon normalized vertices.

1205

{ # A vertex represents a 2D point in the image.

1206

# NOTE: the normalized vertex coordinates are relative to the original image

1207

# and range from 0 to 1.

1208

"x": 3.14, # X coordinate.

1209

"y": 3.14, # Y coordinate.

1210

},

1211

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1212

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1213

},

1214

],

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1215

"landmarkAnnotations": [ # If present, landmark detection has completed successfully.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1216

{ # Set of detected entity features.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1217

"topicality": 3.14, # The relevancy of the ICA (Image Content Annotation) label to the

1218

# image. For example, the relevancy of "tower" is likely higher to an image

1219

# containing the detected "Eiffel Tower" than to an image containing a

1220

# detected distant towering building, even though the confidence that

1221

# there is a tower in each image may be the same. Range [0, 1].

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1222

"locale": "A String", # The language code for the locale in which the entity textual

1223

# `description` is expressed.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1224

"locations": [ # The location information for the detected entity. Multiple

1225

# `LocationInfo` elements can be present because one location may

1226

# indicate the location of the scene in the image, and another location

1227

# may indicate the location of the place where the image was taken.

1228

# Location information is usually present for landmarks.

1229

{ # Detected entity location information.

1230

"latLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # lat/long location coordinates.

1231

# of doubles representing degrees latitude and degrees longitude. Unless

1232

# specified otherwise, this must conform to the

1233

# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84

1234

# standard</a>. Values must be within normalized ranges.

1235

"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].

1236

"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].

},

},

],

"mid": "A String", # Opaque entity ID. Some IDs may be available in

1241

# [Google Knowledge Graph Search

1242

# API](https://developers.google.com/knowledge-graph/).

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1243

"description": "A String", # Entity textual description, expressed in its `locale` language.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1244

"confidence": 3.14, # **Deprecated. Use `score` instead.**

1245

# The accuracy of the entity detection in an image.

1246

# For example, for an image in which the "Eiffel Tower" entity is detected,

1247

# this field represents the confidence that there is a tower in the query

1248

# image. Range [0, 1].

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1249

"boundingPoly": { # A bounding polygon for the detected image annotation. # Image region to which this entity belongs. Not produced

1250

# for `LABEL_DETECTION` features.

1251

"vertices": [ # The bounding polygon vertices.

1252

{ # A vertex represents a 2D point in the image.

1253

# NOTE: the vertex coordinates are in the same scale as the original image.

1254

"x": 42, # X coordinate.

1255

"y": 42, # Y coordinate.

1256

},

1257

],

1258

"normalizedVertices": [ # The bounding polygon normalized vertices.

1259

{ # A vertex represents a 2D point in the image.

1260

# NOTE: the normalized vertex coordinates are relative to the original image

1261

# and range from 0 to 1.

1262

"x": 3.14, # X coordinate.

1263

"y": 3.14, # Y coordinate.

},

],

},

"properties": [ # Some entities may have optional user-supplied `Property` (name/value)

1268

# fields, such a score or string that qualifies the entity.

1269

{ # A `Property` consists of a user-supplied name/value pair.

1270

"uint64Value": "A String", # Value of numeric properties.

1271

"value": "A String", # Value of the property.

1272

"name": "A String", # Name of the property.

1273

},

1274

],

1275

"score": 3.14, # Overall score of the result. Range [0, 1].

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1276

},

1277

],

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

},

],

}</pre>

</div>

<code class="details" id="asyncBatchAnnotate">asyncBatchAnnotate(parent, body=None, x__xgafv=None)</code>

1285

<pre>Run asynchronous image detection and annotation for a list of images.

1286

1287

Progress and results can be retrieved through the

1288

`google.longrunning.Operations` interface.

1289

`Operation.metadata` contains `OperationMetadata` (metadata).

1290

`Operation.response` contains `AsyncBatchAnnotateImagesResponse` (results).

1291

1292

This service will write image annotation outputs to json files in customer

1293

GCS bucket, each json file containing BatchAnnotateImagesResponse proto.

1294

1295

Args:

1296

parent: string, Optional. Target project and location to make a call.

1297

1298

Format: `projects/{project-id}/locations/{location-id}`.

1299

1300

If no parent is specified, a region will be chosen automatically.

1301

1302

Supported location-ids:

1303

`us`: USA country only,

1304

`asia`: East asia areas, like Japan, Taiwan,

1305

`eu`: The European Union.

1306

1307

Example: `projects/project-A/locations/eu`. (required)

1308

body: object, The request body.

1309

The object takes the form of:

1310

1311

{ # Request for async image annotation for a list of images.

1312

"parent": "A String", # Optional. Target project and location to make a call.

1313

#

1314

# Format: `projects/{project-id}/locations/{location-id}`.

1315

#

1316

# If no parent is specified, a region will be chosen automatically.

1317

#

1318

# Supported location-ids:

1319

# `us`: USA country only,

1320

# `asia`: East asia areas, like Japan, Taiwan,

1321

# `eu`: The European Union.

1322

#

1323

# Example: `projects/project-A/locations/eu`.

1324

"outputConfig": { # The desired output location and metadata. # Required. The desired output location and metadata (e.g. format).

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1325

"batchSize": 42, # The max number of response protos to put into each output JSON file on

1326

# Google Cloud Storage.

1327

# The valid range is [1, 100]. If not specified, the default value is 20.

1328

#

1329

# For example, for one pdf file with 100 pages, 100 response protos will

1330

# be generated. If `batch_size` = 20, then 5 json files each

1331

# containing 20 response protos will be written under the prefix

1332

# `gcs_destination`.`uri`.

1333

#

1334

# Currently, batch_size only applies to GcsDestination, with potential future

1335

# support for other output configurations.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1336

"gcsDestination": { # The Google Cloud Storage location where the output will be written to. # The Google Cloud Storage location to write the output(s) to.

1337

"uri": "A String", # Google Cloud Storage URI prefix where the results will be stored. Results

1338

# will be in JSON format and preceded by its corresponding input URI prefix.

1339

# This field can either represent a gcs file prefix or gcs directory. In

1340

# either case, the uri should be unique because in order to get all of the

1341

# output files, you will need to do a wildcard gcs search on the uri prefix

# you provide.

#

# Examples:

#

# * File Prefix: gs://bucket-name/here/filenameprefix The output files

1347

# will be created in gs://bucket-name/here/ and the names of the

1348

# output files will begin with "filenameprefix".

1349

#

1350

# * Directory Prefix: gs://bucket-name/some/location/ The output files

1351

# will be created in gs://bucket-name/some/location/ and the names of the

1352

# output files could be anything because there was no filename prefix

1353

# specified.

1354

#

1355

# If multiple outputs, each response is still AnnotateFileResponse, each of

1356

# which contains some subset of the full list of AnnotateImageResponse.

1357

# Multiple outputs can happen if, for example, the output JSON is too large

1358

# and overflows into multiple sharded files.

1359

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1360

},

1361

"requests": [ # Required. Individual image annotation requests for this batch.

1362

{ # Request for performing Google Cloud Vision API tasks over a user-provided

1363

# image, with user-requested features, and with context information.

1364

"image": { # Client image to perform Google Cloud Vision API tasks over. # The image to be processed.

1365

"content": "A String", # Image content, represented as a stream of bytes.

1366

# Note: As with all `bytes` fields, protobuffers use a pure binary

1367

# representation, whereas JSON representations use base64.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1368

#

1369

# Currently, this field only works for BatchAnnotateImages requests. It does

1370

# not work for AsyncBatchAnnotateImages requests.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1371

"source": { # External image source (Google Cloud Storage or web URL image location). # Google Cloud Storage image location, or publicly-accessible image

1372

# URL. If both `content` and `source` are provided for an image, `content`

1373

# takes precedence and is used to perform the image annotation request.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1374

"gcsImageUri": "A String", # **Use `image_uri` instead.**

1375

#

1376

# The Google Cloud Storage URI of the form

1377

# `gs://bucket_name/object_name`. Object versioning is not supported. See

1378

# [Google Cloud Storage Request

1379

# URIs](https://cloud.google.com/storage/docs/reference-uris) for more info.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1380

"imageUri": "A String", # The URI of the source image. Can be either:

1381

#

1382

# 1. A Google Cloud Storage URI of the form

1383

# `gs://bucket_name/object_name`. Object versioning is not supported. See

1384

# [Google Cloud Storage Request

1385

# URIs](https://cloud.google.com/storage/docs/reference-uris) for more

1386

# info.

1387

#

1388

# 2. A publicly-accessible image HTTP/HTTPS URL. When fetching images from

1389

# HTTP/HTTPS URLs, Google cannot guarantee that the request will be

1390

# completed. Your request may fail if the specified host denies the

1391

# request (e.g. due to request throttling or DOS prevention), or if Google

1392

# throttles requests to the site for abuse prevention. You should not

1393

# depend on externally-hosted images for production applications.

1394

#

1395

# When both `gcs_image_uri` and `image_uri` are specified, `image_uri` takes

1396

# precedence.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1397

},

1398

},

1399

"features": [ # Requested features.

1400

{ # The type of Google Cloud Vision API detection to perform, and the maximum

1401

# number of results to return for that type. Multiple `Feature` objects can

1402

# be specified in the `features` list.

1403

"type": "A String", # The feature type.

1404

"maxResults": 42, # Maximum number of results of this type. Does not apply to

1405

# `TEXT_DETECTION`, `DOCUMENT_TEXT_DETECTION`, or `CROP_HINTS`.

1406

"model": "A String", # Model to use for the feature.

1407

# Supported values: "builtin/stable" (the default if unset) and

# "builtin/latest".

},

],

"imageContext": { # Image context and/or feature-specific parameters. # Additional context that may accompany the image.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1412

"cropHintsParams": { # Parameters for crop hints annotation request. # Parameters for crop hints annotation request.

1413

"aspectRatios": [ # Aspect ratios in floats, representing the ratio of the width to the height

1414

# of the image. For example, if the desired aspect ratio is 4/3, the

1415

# corresponding float value should be 1.33333. If not specified, the

1416

# best possible crop is returned. The number of provided aspect ratios is

1417

# limited to a maximum of 16; any aspect ratios provided after the 16th are

# ignored.

3.14,

],

},

"productSearchParams": { # Parameters for a product search request. # Parameters for product search.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1423

"productCategories": [ # The list of product categories to search in. Currently, we only consider

1424

# the first category, and either "homegoods-v2", "apparel-v2", "toys-v2",

1425

# "packagedgoods-v1", or "general-v1" should be specified. The legacy

1426

# categories "homegoods", "apparel", and "toys" are still supported but will

1427

# be deprecated. For new products, please use "homegoods-v2", "apparel-v2",

1428

# or "toys-v2" for better product search accuracy. It is recommended to

1429

# migrate existing products to these categories as well.

1430

"A String",

1431

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1432

"boundingPoly": { # A bounding polygon for the detected image annotation. # The bounding polygon around the area of interest in the image.

1433

# If it is not specified, system discretion will be applied.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1434

"vertices": [ # The bounding polygon vertices.

1435

{ # A vertex represents a 2D point in the image.

1436

# NOTE: the vertex coordinates are in the same scale as the original image.

1437

"x": 42, # X coordinate.

1438

"y": 42, # Y coordinate.

1439

},

1440

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1441

"normalizedVertices": [ # The bounding polygon normalized vertices.

1442

{ # A vertex represents a 2D point in the image.

1443

# NOTE: the normalized vertex coordinates are relative to the original image

1444

# and range from 0 to 1.

1445

"x": 3.14, # X coordinate.

1446

"y": 3.14, # Y coordinate.

1447

},

1448

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1449

},

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1450

"productSet": "A String", # The resource name of a ProductSet to be searched for similar images.

1451

#

1452

# Format is:

1453

# `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.

1454

"filter": "A String", # The filtering expression. This can be used to restrict search results based

1455

# on Product labels. We currently support an AND of OR of key-value

1456

# expressions, where each expression within an OR must have the same key. An

1457

# '=' should be used to connect the key and value.

1458

#

1459

# For example, "(color = red OR color = blue) AND brand = Google" is

1460

# acceptable, but "(color = red OR brand = Google)" is not acceptable.

1461

# "color: red" is not acceptable because it uses a ':' instead of an '='.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1462

},

1463

"languageHints": [ # List of languages to use for TEXT_DETECTION. In most cases, an empty value

1464

# yields the best results since it enables automatic language detection. For

1465

# languages based on the Latin alphabet, setting `language_hints` is not

1466

# needed. In rare cases, when the language of the text in the image is known,

1467

# setting a hint will help get better results (although it will be a

1468

# significant hindrance if the hint is wrong). Text detection returns an

1469

# error if one or more of the specified languages is not one of the

1470

# [supported languages](https://cloud.google.com/vision/docs/languages).

1471

"A String",

1472

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame]

1473

"latLongRect": { # Rectangle determined by min and max `LatLng` pairs. # Not used.

1474

"maxLatLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Max lat/long pair.

1475

# of doubles representing degrees latitude and degrees longitude. Unless

1476

# specified otherwise, this must conform to the

1477

# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84

1478

# standard</a>. Values must be within normalized ranges.

1479

"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].

1480

"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].

1481

},

1482

"minLatLng": { # An object representing a latitude/longitude pair. This is expressed as a pair # Min lat/long pair.

1483

# of doubles representing degrees latitude and degrees longitude. Unless

1484

# specified otherwise, this must conform to the

1485

# <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84

1486

# standard</a>. Values must be within normalized ranges.

1487

"latitude": 3.14, # The latitude in degrees. It must be in the range [-90.0, +90.0].

1488

"longitude": 3.14, # The longitude in degrees. It must be in the range [-180.0, +180.0].

1489

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1490

},

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1491

"webDetectionParams": { # Parameters for web detection request. # Parameters for web detection.

1492

"includeGeoResults": True or False, # Whether to include results derived from the geo information in the image.

1493

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

},

},

],

}

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

1506

1507

{ # This resource represents a long-running operation that is the result of a

1508

# network API call.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1509

"response": { # The normal response of the operation in case of success. If the original

1510

# method returns no data on success, such as `Delete`, the response is

1511

# `google.protobuf.Empty`. If the original method is standard

1512

# `Get`/`Create`/`Update`, the response should be the resource. For other

1513

# methods, the response should have the type `XxxResponse`, where `Xxx`

1514

# is the original method name. For example, if the original method name

1515

# is `TakeSnapshot()`, the inferred response type is

1516

# `TakeSnapshotResponse`.

1517

"a_key": "", # Properties of the object. Contains field @type with type URL.

1518

},

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame^]

1519

"metadata": { # Service-specific metadata associated with the operation. It typically

1520

# contains progress information and common metadata such as create time.

1521

# Some services might not provide such metadata. Any method that returns a

1522

# long-running operation should document the metadata type, if any.

1523

"a_key": "", # Properties of the object. Contains field @type with type URL.

1524

},

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1525

"name": "A String", # The server-assigned name, which is only unique within the same service that

1526

# originally returns it. If you use the default HTTP mapping, the

1527

# `name` should be a resource name ending with `operations/{unique_id}`.

Bu Sun Kim