REST Resource: photo

Recurso: Photo

La foto 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. Es obligatorio para actualizar una foto. Salida solo cuando se crea una foto. Es el identificador de la foto, que es único entre todas las fotos en Google.

uploadReference

object (UploadRef)

Solo entrada. Obligatorio cuando se crea una foto. Solo entrada. La URL del recurso al que se suben los bytes de la foto.

downloadUrl

string

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

thumbnailUrl

string

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

pose

object (Pose)

Opcional. Posa de la foto.

connections[]

object (Connection)

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

captureTime

string (Timestamp format)

Opcional. Hora absoluta en la que se capturó la foto. Cuando la foto no tiene una marca de tiempo EXIF, se usa para establecer una marca de tiempo en los metadatos de la foto.

Es una marca de tiempo en formato RFC3339 UTC “Zulú”, con 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

Es una marca de tiempo en formato RFC3339 UTC “Zulú”, con 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. Ver recuento 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ó.

ID con foto

Es el identificador de un Photo.

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

string

Es un identificador único para una foto.

SubirReferencia

Sube la referencia de 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

Una referencia de carga debe ser única para cada usuario. Sigue el formato: "https://StreetViewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

Postura

Medición de la pose 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)

El par de latitud y longitud de la pose, como se explica aquí: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng. Si no se proporciona el par de latitud y longitud, se usa la ubicación geográfica del encabezado EXIF cuando se crea un Photo. Si el par de latitud y longitud no se proporciona en el encabezado de foto o exif, puede fallar el proceso.

altitude

number

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

heading

number

Los siguientes parámetros de pose pertenecen al centro de la foto. Coincide con https://developers.google.com/StreetView/spherical-metadata. Brújula, medida en el centro de la foto, en grados en sentido horario desde el norte. El valor debe ser mayor que 0 y menor que 360. NaN indica una cantidad no medida.

pitch

number

Ángulo, medido en el centro de la foto en grados. 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

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

gpsRecordTimestampUnixEpoch

string (Timestamp format)

Hora del registro GPS desde la época UTC.

Es una marca de tiempo en formato RFC3339 UTC “Zulú”, con 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) utilizado 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 en este método: https://developer.android.com/reference/android/location/Location#getprecision(). Otras plataformas tienen métodos diferentes para obtener estimaciones de exactitud 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 de 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, se usa para hacer el pedido. 0 indica el nivel del suelo, 1 indica el primer nivel sobre el nivel del suelo, -1 indica el primer nivel bajo el nivel del suelo. Se pueden utilizar valores que no sean números enteros.

name

string

Obligatorio. Un nombre asignado a este nivel, restringido a 3 caracteres. Considera cómo se etiquetarían los botones del ascensor para este nivel si hubiera un ascensor.

Conexión

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

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

object (PhotoId)

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

Lugar

Coloca metadatos para 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. Corresponde al nombre del lugar, localizado en el lenguaje code.

languageCode

string

Solo salida. El lenguaje de programación con el que está localizado el nombre. Debe ser el idioma de la solicitud especificado, pero puede ser un resguardo.

Estado de la transferencia

Estado de la transferencia de derechos.

Enumeradores
TRANSFER_STATUS_UNKNOWN El estado de esta transferencia no está especificado.
NEVER_TRANSFERRED Esta foto nunca se transfirió.
PENDING Se inició la transferencia de fotos, pero el destinatario todavía no respondió.
COMPLETED Se completó la transferencia de la foto y se la transfirió al destinatario.
REJECTED El destinatario rechazó esta transferencia de fotos.
EXPIRED La transferencia de la foto venció antes de que el destinatario tomara medidas.
CANCELLED El remitente canceló esta transferencia de fotos.
RECEIVED_VIA_TRANSFER El destinatario es el propietario de esta foto debido a una transferencia de derechos.

Estado de publicación de Maps

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

Enumeradores
UNSPECIFIED_MAPS_PUBLISH_STATUS Se desconoce el estado de la foto.
PUBLISHED La foto se publica de forma pública a través de Google Maps.
REJECTED_UNKNOWN Se rechazó la foto por una razón desconocida.

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 lugar, las conexiones, etcétera.