REST Resource: photo

Recurso: Foto

La foto se usa para almacenar fotos de 360° junto con sus metadatos.

Representación JSON 
{
  "photoId": {
    object (PhotoId)
  },
  "uploadReference": {
    object (UploadRef)
  },
  "downloadUrl": string,
  "thumbnailUrl": string,
  "shareLink": string,
  "pose": {
    object (Pose)
  },
  "connections": [
    {
      object (Connection)
    }
  ],
  "captureTime": string,
  "uploadTime": string,
  "places": [
    {
      object (Place)
    }
  ],
  "viewCount": string,
  "transferStatus": enum (TransferStatus),
  "mapsPublishStatus": enum (MapsPublishStatus)
}
Campos
photoId

object (PhotoId)

Obligatorio. Solo salida. Es obligatorio para actualizar una foto. Resultado solo cuando se crea una foto. Es el identificador de la foto, que es único entre todas las fotos de Google.
uploadReference

object (UploadRef)

Solo entrada. Es obligatorio para crear una foto. Solo entrada. La URL del recurso a la que se suben los bytes de las fotos.
downloadUrl

string

Solo salida. Es la URL de descarga de los bytes de la foto. Este campo solo se establece cuando GetPhotoRequest.view se establece como PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnailUrl

string

Solo salida. La URL de la miniatura para mostrar una vista previa de la foto determinada.
pose

object (Pose)

Opcional. Poses de la foto
connections[]

object (Connection)

Opcional. Conexiones con otras fotos. Una conexión representa el vínculo de esta foto a otra foto.
captureTime

string (Timestamp format)

Opcional. Tiempo absoluto en que se capturó la foto. Cuando la foto no tiene una marca de tiempo EXIF, se utiliza para establecer una marca de tiempo en los metadatos de la foto.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
uploadTime

string (Timestamp format)

Solo salida. Hora en la que se subió la imagen.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
places[]

object (Place)

Opcional. Lugares a los que pertenece esta foto.
viewCount

string (int64 format)

Solo salida. La cantidad de vistas de la foto
transferStatus

enum (TransferStatus)

Solo salida. Estado de la transferencia de derechos de esta foto.
mapsPublishStatus

enum (MapsPublishStatus)

Solo salida. Estado en Google Maps, si esta foto se publicó o se rechazó.

PhotoId

Es el identificador de un Photo.

Representación JSON 
{
  "id": string
}
Campos
id

string

Es un identificador único para una foto.

UploadRef

Subir referencia para archivos multimedia.

Representación JSON 
{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}
Campos
Campo de unión file_source. Obligatorio. Las direcciones (file_source) solo pueden ser una de las siguientes opciones:
uploadUrl

string

La referencia de carga debe ser única para cada usuario. Sigue la forma: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}".

Postura

Medición de poses sin procesar para una entidad.

Representación JSON 
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
Campos
latLngPair

object (LatLng)

Es el par de latitud y longitud de la pose, como se explica aquí: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Cuando se crea una Photo, si no se proporcionan los pares de latitud y longitud, se usa la ubicación geográfica del encabezado exif. Un par de latitud y longitud que no se proporciona en el encabezado de la foto o el archivo exif provoca que el proceso de la foto falle.
altitude

number

Altitud de la postura en metros sobre el elipsoide WGS84. NaN indica una cantidad no medida.
heading

number

Los siguientes parámetros de poses corresponden al centro de la foto. Coincide con https://developers.google.com/streetview/spherical-metadata. Orientación según la brújula, medida en el centro de la foto en grados en sentido horario desde el norte. El valor debe ser >=0 y <360. NaN indica una cantidad no medida.
pitch

number

Inclinación, medida en grados en el centro de la foto. El valor debe ser >=-90 y <= 90. Un valor de -90 significa mirar directamente hacia abajo, y un valor de 90 significa mirar directamente hacia arriba. NaN indica una cantidad no medida.
roll

number

Roll, medido en grados. El valor debe ser mayor o igual que 0 y menor que 360. Un valor igual a 0 significa nivelar con el horizonte. NaN indica una cantidad no medida.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

Hora del registro GPS desde la época UTC.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
level

object (Level)

Nivel (el piso de un edificio) que se utiliza para configurar la navegación vertical.
accuracyMeters

number

La precisión horizontal estimada de esta pose en metros con un 68% de confianza (una desviación estándar). Por ejemplo, en Android, este valor está disponible con este método: https://developer.android.com/reference/android/location/Location#getAccuracy(). Otras plataformas tienen métodos diferentes para obtener estimaciones de precisión similares.

LatLng

Es un objeto que representa un par de valores de latitud y longitud. Esto se expresa como un par de dobles para representar la latitud en grados y la longitud en grados. A menos que se especifique lo contrario, este objeto debe cumplir con el estándar WGS84. Los valores deben pertenecer a rangos normalizados.

Representación JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0].
longitude

number

La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0].

Nivel

Información del nivel que contiene el número de nivel y su nombre correspondiente.

Representación JSON 
{
  "number": number,
  "name": string
}
Campos
number

number

Opcional. Número de piso, utilizado para hacer pedidos. 0 indica el nivel del suelo, 1 indica el primer nivel sobre el nivel del suelo y -1 indica el primer nivel por debajo del nivel del suelo. Se admiten valores que no sean números enteros.
name

string

Obligatorio. Es un nombre asignado a este nivel, de 3 caracteres como máximo. Considera cómo se etiquetarían los botones de ascensor para este nivel si hubiera un ascensor.

Conexión

Una conexión es el vínculo entre una foto de origen y una foto de destino.

Representación JSON 
{
  "target": {
    object (PhotoId)
  }
}
Campos
target

object (PhotoId)

Obligatorio. El destino de la conexión entre la foto que lo contiene y otra foto.

Lugar

Metadatos de lugar de una entidad.

Representación JSON 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
Campos
placeId

string

Es el identificador de lugar, como se describe en https://developers.google.com/places/place-id.
name

string

Solo salida. El nombre del lugar, localizado en languageCode.
languageCode

string

Solo salida. El languageCode con el que se localiza el nombre. Este debería ser el languageCode especificado en la solicitud, pero puede ser un resguardo.

TransferStatus

Estado de la transferencia de derechos.

Enumeraciones
TRANSFER_STATUS_UNKNOWN No se especificó el estado de esta transferencia.
NEVER_TRANSFERRED Esta foto nunca estuvo en una transferencia.
PENDING Se inició la transferencia de fotos, pero el receptor aún no responde.
COMPLETED Se completó la transferencia de la foto y se transfirió esta foto al destinatario.
REJECTED El destinatario rechazó esta transferencia de fotos.
EXPIRED La transferencia de fotos venció antes de que el destinatario realizara alguna acción.
CANCELLED El remitente canceló esta transferencia de fotos.
RECEIVED_VIA_TRANSFER El destinatario es propietario de esta foto debido a una transferencia de derechos.

MapsPublishStatus

Estado de publicación de la foto en Google Maps.

Enumeraciones
UNSPECIFIED_MAPS_PUBLISH_STATUS Se desconoce el estado de la foto.
PUBLISHED La foto se publica para el público a través de Google Maps.
REJECTED_UNKNOWN La foto se rechazó por motivos desconocidos.

Métodos

create

 Una vez que el cliente termina de subir la foto con el UploadRef que se muestra, CreatePhoto publica el Photo subido en Street View en Google Maps.

delete

 Borra un Photo y sus metadatos.

get

 Obtiene los metadatos del Photo especificado.

startUpload

 Crea una sesión de carga para comenzar a subir bytes de fotos.

update

 Actualiza los metadatos de una Photo, como la pose, la asociación de lugares, las conexiones, etcétera.