Method: photo.startUpload

AI-generated Key Takeaways

• Initiates an upload session to facilitate uploading photo bytes using the returned UploadRef.

• Uploaded photos must meet specific requirements, including Photo Sphere XMP metadata and size specifications.

• Upon completion, the UploadRef is utilized with photo.create to generate the Photo object entry.

• The request body should be empty for the POST request to https://streetviewpublish.googleapis.com/v1/photo:startUpload.

• Authorization requires the https://www.googleapis.com/auth/streetviewpublish scope.

• HTTP request
• Request body
• Response body
• Authorization scopes
• Try it!

Creates an upload session to start uploading photo bytes. The method uses the upload URL of the returned UploadRef to upload the bytes for the Photo.

In addition to the photo requirements shown in https://support.google.com/maps/answer/7012050?ref_topic=6275604, the photo must meet the following requirements:

• Photo Sphere XMP metadata must be included in the photo metadata. See https://developers.google.com/streetview/spherical-metadata for the required fields.
• The pixel size of the photo must meet the size requirements listed in https://support.google.com/maps/answer/7012050?ref_topic=6275604, and the photo must be a full 360 horizontally.

After the upload completes, the method uses UploadRef with photo.create to create the Photo object entry.

HTTP request

POST https://streetviewpublish.googleapis.com/v1/photo:startUpload

The URL uses gRPC Transcoding syntax.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of UploadRef.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/streetviewpublish

For more information, see the OAuth 2.0 Overview.