REST Resource: photo

{
  "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)
}

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.

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.

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.

string

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

string

Solo salida. El vínculo para compartir la foto.

object (Pose)

Opcional. Poses de la foto

object (Connection)

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

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".

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".

object (Place)

Opcional. Lugares a los que pertenece esta foto.

string (int64 format)

Solo salida. La cantidad de vistas de la foto

enum (TransferStatus)

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

enum (MapsPublishStatus)

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

{
  "id": string
}

string

Es un identificador único para una foto.

{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}

string

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

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

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.

number

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

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.

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.

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.

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".

object (Level)

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

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.

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "number": number,
  "name": string
}

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.

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.

{
  "target": {
    object (PhotoId)
  }
}

object (PhotoId)

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

{
  "placeId": string,
  "name": string,
  "languageCode": string
}

string

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

string

Solo salida. El nombre del lugar, localizado en 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.