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/streetviewpublishscope.
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.