Blame - docs/dyn/streetviewpublish_v1.photos.html - platform/external/python/google-api-python-client

2019-06-14 16:50:42 -0700

[diff] [blame]

208

# request.

209

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

210

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

211

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

212

#

213

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

214

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

Bu Sun Kim

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

[diff] [blame]

215

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

216

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

217

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

218

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

Bu Sun Kim

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

[diff] [blame]

219

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

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

220

# message types for APIs to use.

221

{

Bu Sun Kim

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

[diff] [blame]

222

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

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

223

},

224

],

225

},

Bu Sun Kim

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

[diff] [blame]

226

"photo": { # Photo is used to store 360 photos along with photo metadata. # The Photo resource, if the request

227

# was successful.

228

"captureTime": "A String", # Absolute time when the photo was captured.

229

# When the photo has no exif timestamp, this is used to set a timestamp in

230

# the photo metadata.

231

"connections": [ # Connections to other photos. A connection represents the link from this

232

# photo to another photo.

233

{ # A connection is the link from a source photo to a destination photo.

234

"target": { # Identifier for a Photo. # Required. The destination of the connection from the containing photo to

235

# another photo.

236

"id": "A String", # Required. A unique identifier for a photo.

},

},

],

"thumbnailUrl": "A String", # Output only. The thumbnail URL for showing a preview of the given photo.

241

"uploadReference": { # Upload reference for media files. # Required when creating a photo. Input only. The resource URL where the

242

# photo bytes are uploaded to.

243

"uploadUrl": "A String", # Required. An upload reference should be unique for each user. It follows

244

# the form:

245

# "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"

246

},

247

"shareLink": "A String", # Output only. The share link for the photo.

248

"pose": { # Raw pose measurement for an entity. # Pose of the photo.

249

"accuracyMeters": 3.14, # The estimated horizontal accuracy of this pose in meters with 68%

250

# confidence (one standard deviation). For example, on Android, this value is

251

# available from this method:

252

# https://developer.android.com/reference/android/location/Location#getAccuracy().

253

# Other platforms have different methods of obtaining similar accuracy

254

# estimations.

255

"altitude": 3.14, # Altitude of the pose in meters above WGS84 ellipsoid.

256

# NaN indicates an unmeasured quantity.

257

"heading": 3.14, # Compass heading, measured at the center of the photo in degrees clockwise

258

# from North. Value must be >=0 and <360.

259

# NaN indicates an unmeasured quantity.

260

"level": { # Level information containing level number and its corresponding name. # Level (the floor in a building) used to configure vertical navigation.

261

"name": "A String", # Required. A name assigned to this Level, restricted to 3 characters.

262

# Consider how the elevator buttons would be labeled for this level if there

263

# was an elevator.

264

"number": 3.14, # Floor number, used for ordering. 0 indicates the ground level, 1 indicates

265

# the first level above ground level, -1 indicates the first level under

266

# ground level. Non-integer values are OK.

267

},

268

"latLngPair": { # An object representing a latitude/longitude pair. This is expressed as a pair # Latitude and longitude pair of the pose, as explained here:

269

# https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng

270

# When creating a Photo, if the

271

# latitude and longitude pair are not provided, the geolocation from the

272

# exif header is used. A latitude and longitude pair not provided in the

273

# photo or exif header causes the photo process to fail.

274

# of doubles representing degrees latitude and degrees longitude. Unless

275

# specified otherwise, this must conform to the

276

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

277

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

278

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

279

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

280

},

281

"pitch": 3.14, # Pitch, measured at the center of the photo in degrees. Value must be >=-90

282

# and <= 90. A value of -90 means looking directly down, and a value of 90

283

# means looking directly up.

284

# NaN indicates an unmeasured quantity.

285

"roll": 3.14, # Roll, measured in degrees. Value must be >= 0 and <360. A value of 0

286

# means level with the horizon.

287

# NaN indicates an unmeasured quantity.

288

},

289

"places": [ # Places where this photo belongs.

290

{ # Place metadata for an entity.

291

"name": "A String", # Output-only. The name of the place, localized to the language_code.

292

"languageCode": "A String", # Output-only. The language_code that the name is localized with. This should

293

# be the language_code specified in the request, but may be a fallback.

294

"placeId": "A String", # Place identifier, as described in

295

# https://developers.google.com/places/place-id.

296

},

297

],

298

"downloadUrl": "A String", # Output only. The download URL for the photo bytes. This field is set only

299

# when

300

# GetPhotoRequest.view

301

# is set to

302

# PhotoView.INCLUDE_DOWNLOAD_URL.

303

"transferStatus": "A String", # Output only. Status of rights transfer on this photo.

304

"photoId": { # Identifier for a Photo. # Required when updating a photo. Output only when creating a photo.

305

# Identifier for the photo, which is unique among all photos in

306

# Google.

307

"id": "A String", # Required. A unique identifier for a photo.

308

},

309

"mapsPublishStatus": "A String", # Output only. Status in Google Maps, whether this photo was published or

310

# rejected. Not currently populated.

311

"viewCount": "A String", # Output only. View count of the photo.

312

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

},

],

}</pre>

</div>

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

319

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

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

320

<pre>Updates the metadata of Photos, such

321

as pose, place association, connections, etc. Changing the pixels of photos

is not supported.

Note that if

BatchUpdatePhotos

fails, either critical fields are missing or there is an authentication

327

error. Even if

328

BatchUpdatePhotos

329

succeeds, individual photos in the batch may have failures.

330

These failures are specified in each

331

PhotoResponse.status

332

in

333

BatchUpdatePhotosResponse.results.

334

See

335

UpdatePhoto

336

for specific failures that can occur per photo.

337

338

Only the fields specified in

339

updateMask

340

field are used. If `updateMask` is not present, the update applies to all

fields.

The number of

UpdatePhotoRequest

messages in a

BatchUpdatePhotosRequest

347

must not exceed 20.

348

Bu Sun Kim

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

[diff] [blame]

349

<aside class="note"><b>Note:</b> To update

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

350

Pose.altitude,

351

Pose.latLngPair has to be

Dan O'Meara

dd49464

2020-05-01 07:42:23 -0700

[diff] [blame]

352

filled as well. Otherwise, the request will fail.</aside>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

353

354

Args:

Dan O'Meara

dd49464

2020-05-01 07:42:23 -0700

[diff] [blame]

355

body: object, The request body.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

356

The object takes the form of:

357

358

{ # Request to update the metadata of photos.

359

# Updating the pixels of photos is not supported.

Bu Sun Kim

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

[diff] [blame]

360

"updatePhotoRequests": [ # Required. List of

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

361

# UpdatePhotoRequests.

362

{ # Request to update the metadata of a

363

# Photo. Updating the pixels of a photo

364

# is not supported.

Bu Sun Kim

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

[diff] [blame]

365

"updateMask": "A String", # Required. Mask that identifies fields on the photo metadata to update.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

366

# If not present, the old Photo

367

# metadata is entirely replaced with the

368

# new Photo metadata in this request.

369

# The update fails if invalid fields are specified. Multiple fields can be

370

# specified in a comma-delimited list.

371

#

372

# The following fields are valid:

373

#

374

# * `pose.heading`

375

# * `pose.latLngPair`

# * `pose.pitch`

# * `pose.roll`

# * `pose.level`

# * `pose.altitude`

# * `connections`

# * `places`

#

#

Bu Sun Kim

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

[diff] [blame]

384

# <aside class="note"><b>Note:</b> When

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

385

# updateMask

386

# contains repeated fields, the entire set of repeated values get replaced

387

# with the new contents. For example, if

388

# updateMask

389

# contains `connections` and `UpdatePhotoRequest.photo.connections` is empty,

Dan O'Meara

dd49464

2020-05-01 07:42:23 -0700

[diff] [blame]

390

# all connections are removed.</aside>

Bu Sun Kim

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

[diff] [blame]

391

"photo": { # Photo is used to store 360 photos along with photo metadata. # Required. Photo object containing the

392

# new metadata.

393

"captureTime": "A String", # Absolute time when the photo was captured.

394

# When the photo has no exif timestamp, this is used to set a timestamp in

395

# the photo metadata.

396

"connections": [ # Connections to other photos. A connection represents the link from this

397

# photo to another photo.

398

{ # A connection is the link from a source photo to a destination photo.

399

"target": { # Identifier for a Photo. # Required. The destination of the connection from the containing photo to

400

# another photo.

401

"id": "A String", # Required. A unique identifier for a photo.

},

},

],

"thumbnailUrl": "A String", # Output only. The thumbnail URL for showing a preview of the given photo.

406

"uploadReference": { # Upload reference for media files. # Required when creating a photo. Input only. The resource URL where the

407

# photo bytes are uploaded to.

408

"uploadUrl": "A String", # Required. An upload reference should be unique for each user. It follows

409

# the form:

410

# "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"

411

},

412

"shareLink": "A String", # Output only. The share link for the photo.

413

"pose": { # Raw pose measurement for an entity. # Pose of the photo.

414

"accuracyMeters": 3.14, # The estimated horizontal accuracy of this pose in meters with 68%

415

# confidence (one standard deviation). For example, on Android, this value is

416

# available from this method:

417

# https://developer.android.com/reference/android/location/Location#getAccuracy().

418

# Other platforms have different methods of obtaining similar accuracy

419

# estimations.

420

"altitude": 3.14, # Altitude of the pose in meters above WGS84 ellipsoid.

421

# NaN indicates an unmeasured quantity.

422

"heading": 3.14, # Compass heading, measured at the center of the photo in degrees clockwise

423

# from North. Value must be >=0 and <360.

424

# NaN indicates an unmeasured quantity.

425

"level": { # Level information containing level number and its corresponding name. # Level (the floor in a building) used to configure vertical navigation.

426

"name": "A String", # Required. A name assigned to this Level, restricted to 3 characters.

427

# Consider how the elevator buttons would be labeled for this level if there

428

# was an elevator.

429

"number": 3.14, # Floor number, used for ordering. 0 indicates the ground level, 1 indicates

430

# the first level above ground level, -1 indicates the first level under

431

# ground level. Non-integer values are OK.

432

},

433

"latLngPair": { # An object representing a latitude/longitude pair. This is expressed as a pair # Latitude and longitude pair of the pose, as explained here:

434

# https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng

435

# When creating a Photo, if the

436

# latitude and longitude pair are not provided, the geolocation from the

437

# exif header is used. A latitude and longitude pair not provided in the

438

# photo or exif header causes the photo process to fail.

439

# of doubles representing degrees latitude and degrees longitude. Unless

440

# specified otherwise, this must conform to the

441

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

442

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

443

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

444

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

445

},

446

"pitch": 3.14, # Pitch, measured at the center of the photo in degrees. Value must be >=-90

447

# and <= 90. A value of -90 means looking directly down, and a value of 90

448

# means looking directly up.

449

# NaN indicates an unmeasured quantity.

450

"roll": 3.14, # Roll, measured in degrees. Value must be >= 0 and <360. A value of 0

451

# means level with the horizon.

452

# NaN indicates an unmeasured quantity.

453

},

454

"places": [ # Places where this photo belongs.

455

{ # Place metadata for an entity.

456

"name": "A String", # Output-only. The name of the place, localized to the language_code.

457

"languageCode": "A String", # Output-only. The language_code that the name is localized with. This should

458

# be the language_code specified in the request, but may be a fallback.

459

"placeId": "A String", # Place identifier, as described in

460

# https://developers.google.com/places/place-id.

461

},

462

],

463

"downloadUrl": "A String", # Output only. The download URL for the photo bytes. This field is set only

464

# when

465

# GetPhotoRequest.view

466

# is set to

467

# PhotoView.INCLUDE_DOWNLOAD_URL.

468

"transferStatus": "A String", # Output only. Status of rights transfer on this photo.

469

"photoId": { # Identifier for a Photo. # Required when updating a photo. Output only when creating a photo.

470

# Identifier for the photo, which is unique among all photos in

471

# Google.

472

"id": "A String", # Required. A unique identifier for a photo.

473

},

474

"mapsPublishStatus": "A String", # Output only. Status in Google Maps, whether this photo was published or

475

# rejected. Not currently populated.

476

"viewCount": "A String", # Output only. View count of the photo.

477

},

Bu Sun Kim

2019-06-14 16:50:42 -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:

489

490

{ # Response to batch update of metadata of one or more

491

# Photos.

Bu Sun Kim

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

[diff] [blame]

492

"results": [ # List of results for each individual

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

493

# Photo updated, in the same order as

494

# the request.

495

{ # Response payload for a single

496

# Photo

497

# in batch operations including

498

# BatchGetPhotos

499

# and

500

# BatchUpdatePhotos.

Bu Sun Kim

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

[diff] [blame]

501

"status": { # The `Status` type defines a logical error model that is suitable for # The status for the operation to get or update a single photo in the batch

502

# request.

503

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

504

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

505

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

506

#

507

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

508

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

Bu Sun Kim

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

[diff] [blame]

509

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

510

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

511

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

512

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

Bu Sun Kim

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

[diff] [blame]

513

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

514

# message types for APIs to use.

515

{

516

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

517

},

518

],

Bu Sun Kim

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

[diff] [blame]

519

},

Bu Sun Kim

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

[diff] [blame]

520

"photo": { # Photo is used to store 360 photos along with photo metadata. # The Photo resource, if the request

521

# was successful.

522

"captureTime": "A String", # Absolute time when the photo was captured.

523

# When the photo has no exif timestamp, this is used to set a timestamp in

524

# the photo metadata.

525

"connections": [ # Connections to other photos. A connection represents the link from this

526

# photo to another photo.

527

{ # A connection is the link from a source photo to a destination photo.

528

"target": { # Identifier for a Photo. # Required. The destination of the connection from the containing photo to

529

# another photo.

530

"id": "A String", # Required. A unique identifier for a photo.

},

},

],

"thumbnailUrl": "A String", # Output only. The thumbnail URL for showing a preview of the given photo.

535

"uploadReference": { # Upload reference for media files. # Required when creating a photo. Input only. The resource URL where the

536

# photo bytes are uploaded to.

537

"uploadUrl": "A String", # Required. An upload reference should be unique for each user. It follows

538

# the form:

539

# "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"

540

},

541

"shareLink": "A String", # Output only. The share link for the photo.

542

"pose": { # Raw pose measurement for an entity. # Pose of the photo.

543

"accuracyMeters": 3.14, # The estimated horizontal accuracy of this pose in meters with 68%

544

# confidence (one standard deviation). For example, on Android, this value is

545

# available from this method:

546

# https://developer.android.com/reference/android/location/Location#getAccuracy().

547

# Other platforms have different methods of obtaining similar accuracy

548

# estimations.

549

"altitude": 3.14, # Altitude of the pose in meters above WGS84 ellipsoid.

550

# NaN indicates an unmeasured quantity.

551

"heading": 3.14, # Compass heading, measured at the center of the photo in degrees clockwise

552

# from North. Value must be >=0 and <360.

553

# NaN indicates an unmeasured quantity.

554

"level": { # Level information containing level number and its corresponding name. # Level (the floor in a building) used to configure vertical navigation.

555

"name": "A String", # Required. A name assigned to this Level, restricted to 3 characters.

556

# Consider how the elevator buttons would be labeled for this level if there

557

# was an elevator.

558

"number": 3.14, # Floor number, used for ordering. 0 indicates the ground level, 1 indicates

559

# the first level above ground level, -1 indicates the first level under

560

# ground level. Non-integer values are OK.

561

},

562

"latLngPair": { # An object representing a latitude/longitude pair. This is expressed as a pair # Latitude and longitude pair of the pose, as explained here:

563

# https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng

564

# When creating a Photo, if the

565

# latitude and longitude pair are not provided, the geolocation from the

566

# exif header is used. A latitude and longitude pair not provided in the

567

# photo or exif header causes the photo process to fail.

568

# of doubles representing degrees latitude and degrees longitude. Unless

569

# specified otherwise, this must conform to the

570

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

571

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

572

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

573

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

574

},

575

"pitch": 3.14, # Pitch, measured at the center of the photo in degrees. Value must be >=-90

576

# and <= 90. A value of -90 means looking directly down, and a value of 90

577

# means looking directly up.

578

# NaN indicates an unmeasured quantity.

579

"roll": 3.14, # Roll, measured in degrees. Value must be >= 0 and <360. A value of 0

580

# means level with the horizon.

581

# NaN indicates an unmeasured quantity.

582

},

583

"places": [ # Places where this photo belongs.

584

{ # Place metadata for an entity.

585

"name": "A String", # Output-only. The name of the place, localized to the language_code.

586

"languageCode": "A String", # Output-only. The language_code that the name is localized with. This should

587

# be the language_code specified in the request, but may be a fallback.

588

"placeId": "A String", # Place identifier, as described in

589

# https://developers.google.com/places/place-id.

590

},

591

],

592

"downloadUrl": "A String", # Output only. The download URL for the photo bytes. This field is set only

593

# when

594

# GetPhotoRequest.view

595

# is set to

596

# PhotoView.INCLUDE_DOWNLOAD_URL.

597

"transferStatus": "A String", # Output only. Status of rights transfer on this photo.

598

"photoId": { # Identifier for a Photo. # Required when updating a photo. Output only when creating a photo.

599

# Identifier for the photo, which is unique among all photos in

600

# Google.

601

"id": "A String", # Required. A unique identifier for a photo.

602

},

603

"mapsPublishStatus": "A String", # Output only. Status in Google Maps, whether this photo was published or

604

# rejected. Not currently populated.

605

"viewCount": "A String", # Output only. View count of the photo.

606

},

Bu Sun Kim

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

[diff] [blame]

},

],

}</pre>

</div>

Bu Sun Kim

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

[diff] [blame]

613

<code class="details" id="list">list(view=None, pageSize=None, pageToken=None, filter=None, languageCode=None, x__xgafv=None)</code>

Bu Sun Kim

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

[diff] [blame]

614

<pre>Lists all the Photos that belong to

615

the user.

616

617

<aside class="note"><b>Note:</b> Recently created photos that are still

618

being indexed are not returned in the response.</aside>

619

620

Args:

Bu Sun Kim

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

[diff] [blame]

621

view: string, Required. Specifies if a download URL for the photos bytes should be returned in the

622

Photos response.

623

pageSize: integer, The maximum number of photos to return.

624

`pageSize` must be non-negative. If `pageSize` is zero or is not provided,

625

the default page size of 100 is used.

626

The number of photos returned in the response may be less than `pageSize`

627

if the number of photos that belong to the user is less than `pageSize`.

Bu Sun Kim

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

[diff] [blame]

628

pageToken: string, The

629

nextPageToken

630

value returned from a previous

631

ListPhotos

632

request, if any.

633

filter: string, Required. The filter expression. For example: `placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw`.

634

635

The only filter supported at the moment is `placeId`.

636

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

637

information, see

638

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

639

If language_code is unspecified, the user's language preference for Google

640

services is used.

Bu Sun Kim

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

[diff] [blame]

641

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

648

649

{ # Response to list all photos that belong to a user.

Bu Sun Kim

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

[diff] [blame]

650

"photos": [ # List of photos. The

651

# pageSize field

652

# in the request determines the number of items returned.

653

{ # Photo is used to store 360 photos along with photo metadata.

Bu Sun Kim

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

[diff] [blame]

654

"captureTime": "A String", # Absolute time when the photo was captured.

655

# When the photo has no exif timestamp, this is used to set a timestamp in

656

# the photo metadata.

657

"connections": [ # Connections to other photos. A connection represents the link from this

658

# photo to another photo.

659

{ # A connection is the link from a source photo to a destination photo.

660

"target": { # Identifier for a Photo. # Required. The destination of the connection from the containing photo to

661

# another photo.

662

"id": "A String", # Required. A unique identifier for a photo.

663

},

Bu Sun Kim

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

[diff] [blame]

664

},

Bu Sun Kim

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

[diff] [blame]

665

],

666

"thumbnailUrl": "A String", # Output only. The thumbnail URL for showing a preview of the given photo.

667

"uploadReference": { # Upload reference for media files. # Required when creating a photo. Input only. The resource URL where the

668

# photo bytes are uploaded to.

669

"uploadUrl": "A String", # Required. An upload reference should be unique for each user. It follows

670

# the form:

671

# "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"

Bu Sun Kim

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

[diff] [blame]

672

},

Bu Sun Kim

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

[diff] [blame]

673

"shareLink": "A String", # Output only. The share link for the photo.

674

"pose": { # Raw pose measurement for an entity. # Pose of the photo.

675

"accuracyMeters": 3.14, # The estimated horizontal accuracy of this pose in meters with 68%

676

# confidence (one standard deviation). For example, on Android, this value is

677

# available from this method:

678

# https://developer.android.com/reference/android/location/Location#getAccuracy().

679

# Other platforms have different methods of obtaining similar accuracy

680

# estimations.

681

"altitude": 3.14, # Altitude of the pose in meters above WGS84 ellipsoid.

682

# NaN indicates an unmeasured quantity.

683

"heading": 3.14, # Compass heading, measured at the center of the photo in degrees clockwise

684

# from North. Value must be >=0 and <360.

685

# NaN indicates an unmeasured quantity.

686

"level": { # Level information containing level number and its corresponding name. # Level (the floor in a building) used to configure vertical navigation.

687

"name": "A String", # Required. A name assigned to this Level, restricted to 3 characters.

688

# Consider how the elevator buttons would be labeled for this level if there

689

# was an elevator.

690

"number": 3.14, # Floor number, used for ordering. 0 indicates the ground level, 1 indicates

691

# the first level above ground level, -1 indicates the first level under

692

# ground level. Non-integer values are OK.

693

},

694

"latLngPair": { # An object representing a latitude/longitude pair. This is expressed as a pair # Latitude and longitude pair of the pose, as explained here:

695

# https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng

696

# When creating a Photo, if the

697

# latitude and longitude pair are not provided, the geolocation from the

698

# exif header is used. A latitude and longitude pair not provided in the

699

# photo or exif header causes the photo process to fail.

700

# of doubles representing degrees latitude and degrees longitude. Unless

701

# specified otherwise, this must conform to the

702

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

703

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

704

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

705

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

706

},

707

"pitch": 3.14, # Pitch, measured at the center of the photo in degrees. Value must be >=-90

708

# and <= 90. A value of -90 means looking directly down, and a value of 90

709

# means looking directly up.

710

# NaN indicates an unmeasured quantity.

711

"roll": 3.14, # Roll, measured in degrees. Value must be >= 0 and <360. A value of 0

712

# means level with the horizon.

713

# NaN indicates an unmeasured quantity.

714

},

715

"places": [ # Places where this photo belongs.

716

{ # Place metadata for an entity.

717

"name": "A String", # Output-only. The name of the place, localized to the language_code.

718

"languageCode": "A String", # Output-only. The language_code that the name is localized with. This should

719

# be the language_code specified in the request, but may be a fallback.

720

"placeId": "A String", # Place identifier, as described in

721

# https://developers.google.com/places/place-id.

722

},

723

],

724

"downloadUrl": "A String", # Output only. The download URL for the photo bytes. This field is set only

725

# when

726

# GetPhotoRequest.view

727

# is set to

728

# PhotoView.INCLUDE_DOWNLOAD_URL.

729

"transferStatus": "A String", # Output only. Status of rights transfer on this photo.

730

"photoId": { # Identifier for a Photo. # Required when updating a photo. Output only when creating a photo.

731

# Identifier for the photo, which is unique among all photos in

732

# Google.

733

"id": "A String", # Required. A unique identifier for a photo.

734

},

735

"mapsPublishStatus": "A String", # Output only. Status in Google Maps, whether this photo was published or

736

# rejected. Not currently populated.

737

"viewCount": "A String", # Output only. View count of the photo.

Bu Sun Kim

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

[diff] [blame]

738

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

739

],

Bu Sun Kim

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

[diff] [blame]

740

"nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more

741

# results in the list.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

}</pre>

</div>

<code class="details" id="list_next">list_next(previous_request, previous_response)</code>

747

<pre>Retrieves the next page of results.

748

749

Args:

750

previous_request: The request for the previous page. (required)

751

previous_response: The response from the request for the previous page. (required)

752

753

Returns:

Bu Sun Kim

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

[diff] [blame]

754

A request object that you can call 'execute()' on to request the next

Bu Sun Kim