GoogleApi.StreetViewPublish.V1.Api.Photo (google_api_street_view_publish v0.19.0) View Source

API calls for all endpoints tagged Photo.

Link to this section Summary

Functions

After the client finishes uploading the photo with the returned UploadRef, CreatePhoto publishes the uploaded Photo to Street View on Google Maps. Currently, the only way to set heading, pitch, and roll in CreatePhoto is through the Photo Sphere XMP metadata in the photo bytes. CreatePhoto ignores the pose.heading, pose.pitch, pose.roll, pose.altitude, and pose.level fields in Pose. This method returns the following error codes: google.rpc.Code.INVALID_ARGUMENT if the request is malformed or if the uploaded photo is not a 360 photo. google.rpc.Code.NOT_FOUND if the upload reference does not exist. * google.rpc.Code.RESOURCE_EXHAUSTED if the account has reached the storage limit.

Deletes a Photo and its metadata. This method returns the following error codes: google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the requested photo. google.rpc.Code.NOT_FOUND if the photo ID does not exist.

Gets the metadata of the specified Photo. This method returns the following error codes: google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the requested Photo. google.rpc.Code.NOT_FOUND if the requested Photo does not exist. * google.rpc.Code.UNAVAILABLE if the requested Photo is still being indexed.

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 CreatePhoto to create the Photo object entry.

Updates the metadata of a Photo, such as pose, place association, connections, etc. Changing the pixels of a photo is not supported. Only the fields specified in the updateMask field are used. If updateMask is not present, the update applies to all fields. This method returns the following error codes: google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the requested photo. google.rpc.Code.INVALID_ARGUMENT if the request is malformed. google.rpc.Code.NOT_FOUND if the requested photo does not exist. google.rpc.Code.UNAVAILABLE if the requested Photo is still being indexed.

Link to this section Functions

Link to this function

streetviewpublish_photo_create(connection, optional_params \\ [], opts \\ [])

View Source

Specs

streetviewpublish_photo_create(Tesla.Env.client(), keyword(), keyword()) ::
  {:ok, GoogleApi.StreetViewPublish.V1.Model.Photo.t()}
  | {:ok, Tesla.Env.t()}
  | {:ok, list()}
  | {:error, any()}

After the client finishes uploading the photo with the returned UploadRef, CreatePhoto publishes the uploaded Photo to Street View on Google Maps. Currently, the only way to set heading, pitch, and roll in CreatePhoto is through the Photo Sphere XMP metadata in the photo bytes. CreatePhoto ignores the pose.heading, pose.pitch, pose.roll, pose.altitude, and pose.level fields in Pose. This method returns the following error codes: google.rpc.Code.INVALID_ARGUMENT if the request is malformed or if the uploaded photo is not a 360 photo. google.rpc.Code.NOT_FOUND if the upload reference does not exist. * google.rpc.Code.RESOURCE_EXHAUSTED if the account has reached the storage limit.

Parameters

  • connection (type: GoogleApi.StreetViewPublish.V1.Connection.t) - Connection to server
  • optional_params (type: keyword()) - Optional parameters
    • :"$.xgafv" (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.StreetViewPublish.V1.Model.Photo.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.StreetViewPublish.V1.Model.Photo{}} on success
  • {:error, info} on failure
Link to this function

streetviewpublish_photo_delete(connection, photo_id, optional_params \\ [], opts \\ [])

View Source

Specs

streetviewpublish_photo_delete(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.StreetViewPublish.V1.Model.Empty.t()}
  | {:ok, Tesla.Env.t()}
  | {:ok, list()}
  | {:error, any()}

Deletes a Photo and its metadata. This method returns the following error codes: google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the requested photo. google.rpc.Code.NOT_FOUND if the photo ID does not exist.

Parameters

  • connection (type: GoogleApi.StreetViewPublish.V1.Connection.t) - Connection to server
  • photo_id (type: String.t) - Required. ID of the Photo.
  • optional_params (type: keyword()) - Optional parameters
    • :"$.xgafv" (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.StreetViewPublish.V1.Model.Empty{}} on success
  • {:error, info} on failure
Link to this function

streetviewpublish_photo_get(connection, photo_id, optional_params \\ [], opts \\ [])

View Source

Specs

streetviewpublish_photo_get(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.StreetViewPublish.V1.Model.Photo.t()}
  | {:ok, Tesla.Env.t()}
  | {:ok, list()}
  | {:error, any()}

Gets the metadata of the specified Photo. This method returns the following error codes: google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the requested Photo. google.rpc.Code.NOT_FOUND if the requested Photo does not exist. * google.rpc.Code.UNAVAILABLE if the requested Photo is still being indexed.

Parameters

  • connection (type: GoogleApi.StreetViewPublish.V1.Connection.t) - Connection to server
  • photo_id (type: String.t) - Required. ID of the Photo.
  • optional_params (type: keyword()) - Optional parameters
    • :"$.xgafv" (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :languageCode (type: String.t) - The BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. If language_code is unspecified, the user's language preference for Google services is used.
    • :view (type: String.t) - Required. Specifies if a download URL for the photo bytes should be returned in the Photo response.
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.StreetViewPublish.V1.Model.Photo{}} on success
  • {:error, info} on failure
Link to this function

streetviewpublish_photo_start_upload(connection, optional_params \\ [], opts \\ [])

View Source

Specs

streetviewpublish_photo_start_upload(Tesla.Env.client(), keyword(), keyword()) ::
  {:ok, GoogleApi.StreetViewPublish.V1.Model.UploadRef.t()}
  | {:ok, Tesla.Env.t()}
  | {:ok, list()}
  | {:error, any()}

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 CreatePhoto to create the Photo object entry.

Parameters

  • connection (type: GoogleApi.StreetViewPublish.V1.Connection.t) - Connection to server
  • optional_params (type: keyword()) - Optional parameters
    • :"$.xgafv" (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :body (type: GoogleApi.StreetViewPublish.V1.Model.Empty.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.StreetViewPublish.V1.Model.UploadRef{}} on success
  • {:error, info} on failure
Link to this function

streetviewpublish_photo_update(connection, id, optional_params \\ [], opts \\ [])

View Source

Specs

streetviewpublish_photo_update(
  Tesla.Env.client(),
  String.t(),
  keyword(),
  keyword()
) ::
  {:ok, GoogleApi.StreetViewPublish.V1.Model.Photo.t()}
  | {:ok, Tesla.Env.t()}
  | {:ok, list()}
  | {:error, any()}

Updates the metadata of a Photo, such as pose, place association, connections, etc. Changing the pixels of a photo is not supported. Only the fields specified in the updateMask field are used. If updateMask is not present, the update applies to all fields. This method returns the following error codes: google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the requested photo. google.rpc.Code.INVALID_ARGUMENT if the request is malformed. google.rpc.Code.NOT_FOUND if the requested photo does not exist. google.rpc.Code.UNAVAILABLE if the requested Photo is still being indexed.

Parameters

  • connection (type: GoogleApi.StreetViewPublish.V1.Connection.t) - Connection to server
  • id (type: String.t) - Required. A unique identifier for a photo.
  • optional_params (type: keyword()) - Optional parameters
    • :"$.xgafv" (type: String.t) - V1 error format.
    • :access_token (type: String.t) - OAuth access token.
    • :alt (type: String.t) - Data format for response.
    • :callback (type: String.t) - JSONP
    • :fields (type: String.t) - Selector specifying which fields to include in a partial response.
    • :key (type: String.t) - API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    • :oauth_token (type: String.t) - OAuth 2.0 token for the current user.
    • :prettyPrint (type: boolean()) - Returns response with indentations and line breaks.
    • :quotaUser (type: String.t) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
    • :uploadType (type: String.t) - Legacy upload protocol for media (e.g. "media", "multipart").
    • :upload_protocol (type: String.t) - Upload protocol for media (e.g. "raw", "multipart").
    • :updateMask (type: String.t) - Required. Mask that identifies fields on the photo metadata to update. If not present, the old Photo metadata is entirely replaced with the new Photo metadata in this request. The update fails if invalid fields are specified. Multiple fields can be specified in a comma-delimited list. The following fields are valid: pose.heading pose.latLngPair pose.pitch pose.roll pose.level pose.altitude connections places Note: When updateMask contains repeated fields, the entire set of repeated values get replaced with the new contents. For example, if updateMask contains connections and UpdatePhotoRequest.photo.connections is empty, all connections are removed.
    • :body (type: GoogleApi.StreetViewPublish.V1.Model.Photo.t) -
  • opts (type: keyword()) - Call options

Returns

  • {:ok, %GoogleApi.StreetViewPublish.V1.Model.Photo{}} on success
  • {:error, info} on failure