REST Resource: photo

Recurso: Photo

Se usa para almacenar fotos de 360° junto con los metadatos de las fotos.

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. Se requiere cuando se actualiza una foto. Solo se genera 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. Se requiere cuando se crea una foto. Solo entrada. Es la URL del recurso en la que se suben los bytes de la foto.
downloadUrl

string

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

string

Solo salida. Es la URL de la miniatura para mostrar una vista previa de la foto proporcionada.
pose

object (Pose)

Opcional. Es la pose de la foto.
connections[]

object (Connection)

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

string (Timestamp format)

Opcional. Es la fecha y hora absolutas en que se capturó la foto. Cuando la foto no tiene una marca de tiempo de EXIF, se usa para establecer una marca de tiempo en los metadatos de la foto.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
uploadTime

string (Timestamp format)

Solo salida. Fecha y hora en que se subió la imagen.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
places[]

object (Place)

Opcional. Lugares a los que pertenece esta foto.
viewCount

string (int64 format)

Solo salida. Es la cantidad de vistas de la foto.
transferStatus

enum (TransferStatus)

Solo salida. Es el estado de la transferencia de derechos de esta foto.
mapsPublishStatus

enum (MapsPublishStatus)

Solo salida. Estado en Google Maps, ya sea que se haya publicado o rechazado la foto.

PhotoId

Es el identificador de un Photo.

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

string

Es un identificador único de una foto.

UploadRef

Es la referencia de carga para los 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 el formato "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}".

Pose

Es la medición de la postura sin procesar de 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)

Par de latitud y longitud de la posición, como se explica aquí: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Cuando se crea un Photo, si no se proporciona el par de latitud y longitud, se usa la ubicación geográfica del encabezado EXIF. Si no se proporciona un par de latitud y longitud en la foto o en el encabezado EXIF, se producirá un error en el proceso de la foto.
altitude

number

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

number

Los siguientes parámetros de posición se relacionan con el centro de la foto. Coinciden con https://developers.google.com/streetview/spherical-metadata. Orientación de la brújula, medida en el centro de la foto en grados en sentido horario desde el norte. El valor debe ser mayor o igual que 0 y menor que 360. NaN indica una cantidad no medida.
pitch

number

Inclinación, medida en el centro de la foto en grados. El valor debe ser mayor o igual que -90 y menor o igual que 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

Es el ángulo de alabeo, medido en grados. El valor debe ser >= 0 y <360. Un valor de 0 significa que está nivelado con el horizonte. NaN indica una cantidad no medida.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

Es la hora del registro del GPS desde la época UTC.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
level

object (Level)

Es el nivel (el piso de un edificio) que se usa para configurar la navegación vertical.
accuracyMeters

number

Es la precisión horizontal estimada de esta posición en metros con un 68% de confianza (una desviación estándar). Por ejemplo, en Android, este valor está disponible en este método: https://developer.android.com/reference/android/location/Location#getAccuracy(). Otras plataformas tienen diferentes métodos 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 números de punto flotante de doble precisión que representan los grados de latitud y longitud. 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

Es 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, que se usa para ordenar. El 0 indica el nivel del suelo, el 1 indica el primer nivel sobre el nivel del suelo y el -1 indica el primer nivel por debajo del nivel del suelo. Se aceptan valores no enteros.
name

string

Obligatorio. Es el nombre asignado a este nivel, que se limita a 3 caracteres. Considera cómo se etiquetarían los botones del ascensor para este nivel si hubiera uno.

Conexión

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

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

object (PhotoId)

Obligatorio. Es el destino de la conexión desde la foto contenedora a otra foto.

Lugar

Son los metadatos de ubicación 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. Es el nombre del lugar, localizado según el idioma especificado en languageCode.
languageCode

string

Solo salida. Es el código de idioma con el que se localiza el nombre. Debe ser el languageCode especificado en la solicitud, pero puede ser una alternativa.

TransferStatus

Es el estado de la transferencia de derechos.

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

MapsPublishStatus

Es el estado de publicación de la foto en Google Maps.

Enums
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 Se rechazó la foto por un motivo desconocido.

Métodos

create

 Después de que el cliente termina de subir la foto con el UploadRef devuelto, 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 un Photo, como la posición, la asociación de lugares, las conexiones, etcétera.