- Recurso: Foto
- PhotoId
- UploadRef
- pose
- LatLng
- Nivel
- Conexión
- Lugar
- Estado de la transferencia
- MapPublishStatus.
- Métodos
Recurso: Photo
La foto se usa para almacenar fotos de 360° junto con los metadatos de las fotos.
Representación JSON |
---|
{ "photoId": { object ( |
Campos | |
---|---|
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 |
Solo entrada. Obligatorio cuando se crea una foto. Solo entrada. La URL del recurso al que se suben los bytes de la foto. |
downloadUrl |
Solo salida. La URL de descarga de los bytes de la foto. Este campo se establece solo cuando |
thumbnailUrl |
Solo salida. URL de la miniatura para mostrar una vista previa de la foto determinada. |
shareLink |
Solo salida. El vínculo para compartir de la foto. |
pose |
Opcional. Posa de la foto. |
connections[] |
Opcional. Conexiones con otras fotos. Una conexión representa el vínculo de esta foto con otra. |
captureTime |
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: |
uploadTime |
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: |
places[] |
Opcional. Lugares a los que pertenece esta foto. |
viewCount |
Solo salida. Ver recuento de la foto. |
transferStatus |
Solo salida. Estado de la transferencia de derechos de esta foto. |
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 |
Es un identificador único para una foto. |
SubirReferencia
Sube la referencia de los archivos multimedia.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión file_source . Obligatorio. Las direcciones (file_source ) solo pueden ser una de las siguientes opciones: |
|
uploadUrl |
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 ( |
Campos | |
---|---|
latLngPair |
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 |
altitude |
Altitud de la pose en metros sobre el elipsoide WGS84. NaN indica una cantidad no medida. |
heading |
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 |
Á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 |
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 |
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: |
level |
Nivel (el piso de un edificio) utilizado para configurar la navegación vertical. |
accuracyMeters |
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 |
La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0]. |
longitude |
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 |
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 |
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 ( |
Campos | |
---|---|
target |
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 |
Es el identificador de lugar, como se describe en https://developers.google.com/places/place-id. |
name |
Solo salida. Corresponde al nombre del lugar, localizado en el lenguaje code. |
languageCode |
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 |
|
---|---|
|
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. |
|
Borra un Photo y sus metadatos. |
|
Obtiene los metadatos del Photo especificado. |
|
Crea una sesión de carga para comenzar a subir bytes de fotos. |
|
Actualiza los metadatos de una Photo , como la pose, la asociación de lugar, las conexiones, etcétera. |