REST Resource: photo

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 al actualizar una foto. Salida 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 al crear 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 para los bytes de la foto. Este campo se establece solo cuando GetPhotoRequest.view se establece en PhotoView.INCLUDE_DOWNLOAD_URL.

thumbnailUrl

string

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

pose

object (Pose)

Opcional. Posición 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. Hora absoluta en que se capturó la foto. Cuando la foto no tiene marca de tiempo Exif, se usa para establecer una marca de tiempo en los metadatos de la foto.

Una marca de tiempo en formato RFC3339 UTC (Zulú) con resolución en nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

uploadTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC (Zulú) con resolución en nanosegundos y hasta nueve dígitos decimales. 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. El recuento 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, indica si esta foto se publicó o se rechazó.

ID de foto

Es el identificador de un Photo.

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

string

Es un identificador único para una foto.

Carga de referencia

Subir referencia para archivos multimedia

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

string

Una referencia de carga debe ser única para cada usuario. Sigue esta 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)

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 un Photo, si no se proporcionan el par de latitud y longitud, se usa la ubicación geográfica del encabezado exif. Un par de latitud y longitud no proporcionado en el encabezado de la foto o exif hace que el proceso de la foto falle.

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 corresponden al centro de la foto. Coinciden con https://developers.google.com/streetview/spherical-metadata. Encabezado de la brújula, medido en el centro de la foto, en grados en sentido horario, partiendo del norte. El valor debe ser >=0 y <360. NaN indica una cantidad no medida.

pitch

number

Tono, medido en el centro de la foto en grados. El valor debe ser >=-90 y <= 90. Un valor de -90 significa que el usuario mira directamente hacia abajo y un valor de 90 significa que el usuario mira hacia arriba. NaN indica una cantidad no medida.

roll

number

Rotación, medida en grados. El valor debe ser >= 0 y <360. Un valor de 0 significa que el nivel está en el horizonte. NaN indica una cantidad no medida.

gpsRecordTimestampUnixEpoch

string (Timestamp format)

Hora del registro GPS desde el epoch UTC.

Una marca de tiempo en formato RFC3339 UTC (Zulú) con resolución en nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

level

object (Level)

Es el piso (el piso de un edificio) que se usa 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 a través de este método: https://developer.android.com/reference/android/location/Location#getExact(). Otras plataformas tienen métodos diferentes para obtener estimaciones de precisión similares.

LatLng

Un objeto que representa un par latitud-longitud. Esto se expresa como un par de dobles para representar 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

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, usado para realizar pedidos. 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. Los valores que no son números enteros son aceptables.

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

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

name

string

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

languageCode

string

Solo salida. El languageCode con el que está localizado el nombre. Este debería ser el languageCode especificado en la solicitud, 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 esta foto, pero el receptor aún no respondió.
COMPLETED Se completó la transferencia de la foto, y esta foto se transfirió 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.

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 al público a través de Google Maps.
REJECTED_UNKNOWN La foto se rechazó por un motivo desconocido.

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 un Photo, como la pose, la asociación de lugar, las conexiones, etcétera.