photoSequence

POST /v1/photoSequence

Changed on

After the client finishes uploading the PhotoSequence with the returned UploadRef, CreatePhotoSequence extracts a sequence of 360 photos from a video or Extensible Device Metadata (XDM, http://www.xdm.org/) to be published to Street View on Google Maps. CreatePhotoSequence returns an Operation, with the PhotoSequence Id set in the Operation.name field. This method returns the following error codes: * google.rpc.Code.INVALID_ARGUMENT if the request is malformed. * google.rpc.Code.NOT_FOUND if the upload reference does not exist.

Request

  • Base URL
    https://streetviewpublish.googleapis.com
  • Auth
    OAuth 2 and OAuth 2
    Implicithttps://accounts.google.com/o/oauth2/auth
    Scopeshttps://www.googleapis.com/auth/streetviewpublish
    Authorization codehttps://accounts.google.com/o/oauth2/auth
    Token URLhttps://accounts.google.com/o/oauth2/token
    Scopeshttps://www.googleapis.com/auth/streetviewpublish

Query parameters

inputType'INPUT_TYPE_UNSPECIFIED' | 'VIDEO' | 'XDM'

Required. The input form of PhotoSequence.

Request body

captureTimeOverridestring google-datetime

Optional. Absolute time when the photo sequence starts to be captured. If the photo sequence is a video, this is the start time of the video. If this field is populated in input, it overrides the capture time in the video or XDM file.

distanceMetersnumber double

Output only. The computed distance of the photo sequence in meters.

failureReason'PROCESSING_FAILURE_REASON_UNSPECIFIED' | 'LOW_RESOLUTION' | 'DUPLICATE' | 'INSUFFICIENT_GPS' | 'NO_OVERLAP_GPS' | 'INVALID_GPS' | 'FAILED_TO_REFINE_POSITIONS' | 'TAKEDOWN' | 'CORRUPT_VIDEO' | 'INTERNAL' | 'INVALID_VIDEO_FORMAT' | 'INVALID_VIDEO_DIMENSIONS' | 'INVALID_CAPTURE_TIME' | 'GPS_DATA_GAP' | 'JUMPY_GPS' | 'INVALID_IMU' | 'INSUFFICIENT_IMU' | 'INSUFFICIENT_OVERLAP_TIME_SERIES' | 'IMU_DATA_GAP' | 'UNSUPPORTED_CAMERA' | 'NOT_OUTDOORS' | 'INSUFFICIENT_VIDEO_FRAMES' | 'INSUFFICIENT_MOVEMENT' | 'MAST_DOWN' | 'CAMERA_COVERED'

Output only. If this sequence has processing_state = FAILED, this will contain the reason why it failed. If the processing_state is any other value, this field will be unset.

filenamestring

Output only. The filename of the upload. Does not include the directory path. Only available if the sequence was uploaded on a platform that provides the filename.

gpsSource'PHOTO_SEQUENCE' | 'CAMERA_MOTION_METADATA_TRACK'

Input only. If both raw_gps_timeline and the Camera Motion Metadata Track (CAMM) contain GPS measurements, indicate which takes precedence.

idstring

Output only. Unique identifier for the photo sequence. This also acts as a long running operation ID if uploading is performed asynchronously.

processingState'PROCESSING_STATE_UNSPECIFIED' | 'PENDING' | 'PROCESSING' | 'PROCESSED' | 'FAILED'

Output only. The processing state of this sequence.

uploadTimestring google-datetime

Output only. The time this photo sequence was created in uSV Store service.

viewCountstring int64

Output only. The total number of views that all the published images in this PhotoSequence have received.

Response

Successful response

doneboolean

If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.

metadataobject

Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.

namestring

The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should be a resource name ending with operations/{unique_id}.

responseobject

The normal, successful response of the operation. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example, if the original method name is TakeSnapshot(), the inferred response type is TakeSnapshotResponse.

Changes

    • breaking

      removed the request body

    • breaking

      removed the media type */* for the response with the status