- Recurso: Photo
- PhotoId
- UploadRef
- Postes
- LatLng
- Nivel
- Conexión
- Lugar
- Estadodetransferencia
- MapsPublishStatus.
- 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 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 |
Solo entrada. Es obligatorio al crear una foto. Solo entrada. La URL del recurso al que se suben los bytes de la foto. |
downloadUrl |
Solo salida. La URL de descarga para los bytes de la foto. Este campo se establece solo cuando |
thumbnailUrl |
Solo salida. La URL en miniatura para mostrar una vista previa de la foto. |
shareLink |
Solo salida. El vínculo para compartir la foto |
pose |
Opcional. Posición de la foto. |
connections[] |
Opcional. Conexiones a otras fotos Una conexión representa el vínculo de esta foto con otra. |
captureTime |
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: |
uploadTime |
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: |
places[] |
Opcional. Lugares a los que pertenece esta foto. |
viewCount |
Solo salida. El recuento de vistas de la foto |
transferStatus |
Solo salida. Estado de la transferencia de derechos de esta foto |
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 |
Es un identificador único para una foto. |
Carga de referencia
Subir referencia para archivos multimedia
Representación JSON |
---|
{ "uploadUrl": string } |
Campos | |
---|---|
uploadUrl |
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 ( |
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 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 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 |
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 |
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 |
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: |
level |
Es el piso (el piso de un edificio) que se usa 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 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 |
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, 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 |
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 |
Identificador de lugar, como se describe en https://developers.google.com/places/place-id |
name |
Solo salida. El nombre del lugar, localizado al languageCode. |
languageCode |
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 |
|
---|---|
|
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 un Photo , como la pose, la asociación de lugar, las conexiones, etcétera. |