Package google.streetview.publish.v1

Índice

StreetViewPublishService

Publica y conecta fotos aportadas por los usuarios en Street View.

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Borra una lista de Photos y sus metadatos.

Ten en cuenta que si BatchDeletePhotos falla, significa que faltan campos críticos o hay un error de autenticación. Incluso si BatchDeletePhotos se realiza correctamente, es posible que las fotos individuales del lote tengan errores. Estas fallas se especifican en cada PhotoResponse.status de BatchDeletePhotosResponse.results. Consulta DeletePhoto para ver fallas específicas que pueden ocurrir por foto.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

Obtiene los metadatos del lote Photo especificado.

Ten en cuenta que si BatchGetPhotos falla, significa que faltan campos críticos o hay un error de autenticación. Incluso si BatchGetPhotos se realiza correctamente, es posible que las fotos individuales del lote tengan errores. Estas fallas se especifican en cada PhotoResponse.status de BatchGetPhotosResponse.results. Consulta GetPhoto para ver fallas específicas que pueden ocurrir por foto.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

Actualiza los metadatos de Photos, como la pose, la asociación de lugares, las conexiones, etc. No se puede cambiar los píxeles de las fotos.

Ten en cuenta que si BatchUpdatePhotos falla, significa que faltan campos críticos o hay un error de autenticación. Incluso si BatchUpdatePhotos se realiza correctamente, es posible que las fotos individuales del lote tengan errores. Estas fallas se especifican en cada PhotoResponse.status de BatchUpdatePhotosResponse.results. Consulta UpdatePhoto para ver fallas específicas que pueden ocurrir por foto.

Solo se usan los campos especificados en el campo updateMask. Si updateMask no está presente, la actualización se aplica a todos los campos.

La cantidad de mensajes UpdatePhotoRequest en una BatchUpdatePhotosRequest no debe ser superior a 20.

Nota: Para actualizar Pose.altitude, también se debe completar Pose.latLngPair. De lo contrario, la solicitud fallará.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

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.

Actualmente, la única manera de establecer la dirección, el inclinación y el giro en CreatePhoto es a través de los metadatos XMP de Photo Sphere en los bytes de la foto. CreatePhoto ignora los campos pose.heading, pose.pitch, pose.roll, pose.altitude y pose.level en Pose.

Este método muestra los siguientes códigos de error:

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

Una vez que el cliente termina de subir el objeto PhotoSequence con el objeto UploadRef que se muestra, CreatePhotoSequence extrae una secuencia de fotos de 360° de un video o metadatos de dispositivos extensibles (XDM, http://www.xdm.org/) para publicarlos en Street View en Google Maps.

CreatePhotoSequence muestra un Operation, con el ID de PhotoSequence establecido en el campo Operation.name.

Este método muestra los siguientes códigos de error:

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

Borra un Photo y sus metadatos.

Este método muestra los siguientes códigos de error:

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

Borra un PhotoSequence y sus metadatos.

Este método muestra los siguientes códigos de error:

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

Obtiene los metadatos del Photo especificado.

Este método muestra los siguientes códigos de error:

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

Obtiene los metadatos del PhotoSequence especificado a través de la interfaz Operation.

Este método muestra los siguientes tres tipos de respuestas:

  • Operation.done es un valor falso si aún no finalizó el procesamiento de PhotoSequence.
  • Operation.done = true y Operation.error se propaga si se produjo un error durante el procesamiento.
  • Operation.done es verdadero y se propaga Operation.response, que contiene un mensaje PhotoSequence.

Este método muestra los siguientes códigos de error:

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

Enumera todos los PhotoSequences que pertenecen al usuario, en orden descendente de marca de tiempo CreatePhotoSequence.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

Enumera todos los Photos que pertenecen al usuario.

Nota: Las fotos creadas recientemente que aún se están indexando no se muestran en la respuesta.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

Crea una sesión de carga para comenzar a subir datos de secuencias de fotos. La URL de carga del UploadRef que se muestra se usa para subir los datos del photoSequence.

Una vez que se completa la carga, se usa UploadRef con CreatePhotoSequence para crear la entrada del objeto PhotoSequence.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
StartUpload

rpc StartUpload(Empty) returns (UploadRef)

Crea una sesión de carga para comenzar a subir bytes de fotos. El método usa la URL de carga del UploadRef que se muestra para subir los bytes del Photo.

Además de los requisitos para las fotos que se muestran en https://support.google.com/maps/answer/7012050?ref_topic=6275604, la foto debe cumplir con los siguientes requisitos:

Cuando se completa la carga, el método usa UploadRef con CreatePhoto para crear la entrada del objeto Photo.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.
UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

Actualiza los metadatos de una Photo, como la pose, la asociación de lugares, las conexiones, etc. No se puede cambiar los píxeles de una foto.

Solo se usan los campos especificados en el campo updateMask. Si updateMask no está presente, la actualización se aplica a todos los campos.

Este método muestra los siguientes códigos de error:

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/streetviewpublish

Para obtener más información, consulta la descripción general de OAuth 2.0.

BatchDeletePhotosRequest

Solicitud para borrar varias Photos.

Campos
photo_ids[]

string

Obligatorio. Son los IDs de Photos. Las solicitudes GET de HTTP requieren la siguiente sintaxis para el parámetro de consulta de URL: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

Respuesta a la eliminación por lotes de uno o más Photos.

Campos
status[]

Status

El estado de la operación para borrar una sola Photo en la solicitud por lotes.

BatchGetPhotosRequest

Solicita obtener uno o más Photos. De forma predeterminada

  • no devuelve la URL de descarga de los bytes de la foto.

Parámetros:

  • view controla si se muestra la URL de descarga de los bytes de fotos.
Campos
photo_ids[]

string

Obligatorio. Son los IDs de Photos. Para las solicitudes GET de HTTP, el parámetro de consulta de URL debe ser photoIds=<id1>&photoIds=<id2>&....
view

PhotoView

Obligatorio. Especifica si se debe mostrar una URL de descarga para los bytes de fotos en la respuesta de Photo.
language_code

string

Opcional. El código de idioma BCP-47, como "en-US" o "sr-Latn". Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Si no se especifica language_code, se utiliza la preferencia de idioma del usuario para los servicios de Google.

BatchGetPhotosResponse

Respuesta para obtener un lote de Photos.

Campos
results[]

PhotoResponse

Lista de resultados para cada solicitud Photo individual, en el mismo orden que las solicitudes de BatchGetPhotos.

BatchUpdatePhotosRequest

Solicitud para actualizar los metadatos de las fotos. No se pueden actualizar los píxeles de las fotos.

Campos
update_photo_requests[]

UpdatePhotoRequest

Obligatorio. Lista de UpdatePhotoRequests.

BatchUpdatePhotosResponse

Respuesta a la actualización por lotes de metadatos de uno o más Photos.

Campos
results[]

PhotoResponse

Se actualizó la lista de resultados para cada Photo individual, en el mismo orden que la solicitud.

Conexión

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

Campos
target

PhotoId

Obligatorio. El destino de la conexión entre la foto que lo contiene y otra foto.

CreatePhotoRequest

Solicitud para crear un Photo.

Campos
photo

Photo

Obligatorio. Foto para crear.

CreatePhotoSequenceRequest

Solicita crear un PhotoSequence a partir de un video.

Campos
photo_sequence

PhotoSequence

Obligatorio. PhotoSequence para crear.
input_type

InputType

Obligatorio. El formato de entrada de PhotoSequence.

InputType

Formatos de entrada de PhotoSequence.

Enumeraciones
INPUT_TYPE_UNSPECIFIED No se especifica. El servidor mostrará google.rpc.Code.INVALID_ARGUMENT.
VIDEO Video en 360°.
XDM Metadatos de dispositivos extensibles: http://www.xdm.org

DeletePhotoRequest

Solicitud para borrar un Photo.

Campos
photo_id

string

Obligatorio. Es el ID de Photo.

DeletePhotoSequenceRequest

Solicitud para borrar un PhotoSequence.

Campos
sequence_id

string

Obligatorio. Es el ID de PhotoSequence.

GetPhotoRequest

Solicitud para obtener un Photo.

De forma predeterminada

  • no devuelve la URL de descarga de los bytes de la foto.

Parámetros:

  • view controla si se muestra la URL de descarga de los bytes de fotos.
Campos
photo_id

string

Obligatorio. Es el ID de Photo.
view

PhotoView

Obligatorio. Especifica si se debe mostrar una URL de descarga para los bytes de fotos en la respuesta de Photo.
language_code

string

El código de idioma BCP-47, como "en-US" o "sr-Latn". Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Si no se especifica language_code, se usará la preferencia de idioma del usuario para los servicios de Google.

GetPhotoSequenceRequest

Solicitud para obtener un PhotoSequence.

De forma predeterminada

Parámetros:

  • view controla si se muestra la URL de descarga de PhotoSequence.
Campos
sequence_id

string

Obligatorio. ID de la secuencia de fotos.
view
(deprecated)

PhotoView

Especifica si se debe mostrar una URL de descarga para la secuencia de fotos en download_url de fotos individuales en la respuesta de PhotoSequence.

Nota: Actualmente no se ha implementado.
filter

string

Opcional. La expresión de filtro. Por ejemplo: published_status=PUBLISHED.

Los filtros admitidos son los siguientes: published_status. Consulta https://google.aip.dev/160 para obtener más información.

GpsDataGapFailureDetails

Detalles relacionados con ProcessingFailureReason#GPS_DATA_GAP. Si hay varias brechas en los datos de GPS, aquí solo se informa la que tiene la mayor duración.

Campos
gap_duration

Duration

Es la duración del intervalo en los datos de GPS que se encontró.
gap_start_time

Duration

Tiempo relativo (desde el inicio de la transmisión de video por Internet) en el que comenzó la interrupción.

Imu

Datos de IMU de los sensores del dispositivo

Campos
accel_mpsps[]

Measurement3d

Las medidas del acelerómetro en metros/s^2 con marcas de tiempo de dispositivos cada vez más.
gyro_rps[]

Measurement3d

Las mediciones del giroscopio en radianes/s con marcas de tiempo de dispositivos cada vez más.
mag_ut[]

Measurement3d

Las mediciones del magnetómetro del campo magnético en microteslas (uT) con marcas de tiempo cada vez más altas de los dispositivos.

Medición en 3 días

Una muestra genérica de mediciones en 3D.

Campos
capture_time

Timestamp

La marca de tiempo de la medición del IMU.
x

float

Es la medida del sensor en el eje x.
y

float

La medida del sensor en el eje y.
z

float

La medida del sensor en el eje z.

ImuDataGapFailureDetails

Detalles relacionados con ProcessingFailureReason#IMU_DATA_GAP. Si hay varias brechas en los datos de IMU, aquí solo se informa la que tiene la mayor duración.

Campos
gap_duration

Duration

Es la duración del intervalo en los datos de IMU que se encontró.
gap_start_time

Duration

Tiempo relativo (desde el inicio de la transmisión de video por Internet) en el que comenzó la interrupción.

InsufficientGpsFailureDetails

Detalles relacionados con ProcessingFailureReason#INSUFFICIENT_GPS.

Campos
gps_points_found

int32

La cantidad de puntos de GPS que se encontraron en el video.

LatLngBounds

Es un rectángulo en coordenadas geográficas.

Campos
southwest

LatLng

El ángulo suroeste de estos límites.
northeast

LatLng

La esquina noreste de estos límites.

Nivel

Información del nivel que contiene el número de nivel y su nombre correspondiente.

Campos
number

double

Opcional. Número de piso, utilizado para hacer pedidos. 0 indica el nivel del suelo, 1 indica el primer nivel sobre el nivel del suelo y -1 indica el primer nivel por debajo del nivel del suelo. Se admiten valores que no sean números enteros.
name

string

Obligatorio. Es un nombre asignado a este nivel, de 3 caracteres como máximo. Considera cómo se etiquetarían los botones de ascensor para este nivel si hubiera un ascensor.

ListPhotoSequencesRequest

Es una solicitud para enumerar todas las secuencias de fotos que pertenecen al usuario que envía la solicitud.

Parámetros:

  • pageSize determina la cantidad máxima de secuencias de fotos que se mostrarán.
  • pageToken es el valor del token de la página siguiente que se muestra en una solicitud ListPhotoSequences anterior, si la hay.
Campos
page_size

int32

Opcional. La cantidad máxima de secuencias de fotos que se mostrarán. pageSize no debe ser negativo. Si pageSize es cero o no se proporciona, se usa el tamaño de página predeterminado de 100. La cantidad de secuencias de fotos que se muestran en la respuesta puede ser inferior a pageSize si la cantidad de coincidencias es menor que pageSize. Por el momento, esta opción no está implementada, pero se está procesando.
page_token

string

Opcional. El valor de nextPageToken que se muestra de una solicitud ListPhotoSequences previa, si existe.
filter

string

Opcional. La expresión de filtro. Por ejemplo: imagery_type=SPHERICAL.

Los filtros admitidos son imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds y `max_capture_time_seconds. Consulta https://google.aip.dev/160 para obtener más información. Las consultas de nombre de archivo se deben enviar como frase para admitir varias palabras y caracteres especiales agregando comillas escapadas. P. ej.: filename_query="ejemplo de frase.mp4"

ListPhotoSequencesResponse

Es una respuesta para enumerar todas las secuencias de fotos que pertenecen a un usuario.

Campos
photo_sequences[]

Operation

Lista de secuencias de fotos a través de la interfaz Operation.

La cantidad máxima de elementos que se muestran se basa en el campo pageSize de la solicitud.

Cada elemento de la lista puede tener tres estados posibles:

  • Operation.done es un valor falso si aún no finalizó el procesamiento de PhotoSequence.
  • Operation.done = true y Operation.error se propaga si se produjo un error durante el procesamiento.
  • Operation.done es verdadero y Operation.response contiene un mensaje PhotoSequence. En cada secuencia, solo se propaga Id.
next_page_token

string

Token para recuperar la página siguiente de resultados o vaciar si no hay más resultados en la lista.

ListPhotosRequest

Solicitud para enumerar todas las fotos que pertenecen al usuario que envía la solicitud.

De forma predeterminada

  • no devuelve la URL de descarga de los bytes de la foto.

Parámetros:

  • view controla si se muestra la URL de descarga de los bytes de fotos.
  • pageSize determina la cantidad máxima de fotos que se mostrarán.
  • pageToken es el valor del token de la página siguiente que se muestra en una solicitud ListPhotos anterior, si la hay.
  • filter permite filtrar según un parámetro determinado. "placeId" es el único parámetro admitido por el momento.
Campos
view

PhotoView

Obligatorio. Especifica si se debe mostrar una URL de descarga para los bytes de fotos en la respuesta de Fotos.
page_size

int32

Opcional. La cantidad máxima de fotos que se mostrarán. pageSize no debe ser negativo. Si pageSize es cero o no se proporciona, se usa el tamaño de página predeterminado de 100. La cantidad de fotos mostradas en la respuesta puede ser inferior a pageSize si la cantidad de fotos que pertenecen al usuario es inferior a pageSize.
page_token

string

Opcional. El valor de nextPageToken que se muestra de una solicitud ListPhotos previa, si existe.
filter

string

Opcional. La expresión de filtro. Por ejemplo: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw.

Los filtros admitidos son placeId, min_latitude, max_latitude, min_longitude y max_longitude. Consulta https://google.aip.dev/160 para obtener más información.
language_code

string

Opcional. El código de idioma BCP-47, como "en-US" o "sr-Latn". Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Si no se especifica language_code, se utiliza la preferencia de idioma del usuario para los servicios de Google.

ListPhotosResponse

Es la respuesta para enumerar todas las fotos que pertenecen a un usuario.

Campos
photos[]

Photo

Lista de fotos. El campo pageSize de la solicitud determina la cantidad de elementos que se muestran.
next_page_token

string

Token para recuperar la página siguiente de resultados o vaciar si no hay más resultados en la lista.

NoOverlapGpsFailureDetails

Detalles relacionados con PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.

Campos
gps_start_time

Timestamp

Hora del primer punto de GPS registrado.
gps_end_time

Timestamp

Hora del último punto de GPS registrado.
video_start_time

Timestamp

Hora de inicio del video
video_end_time

Timestamp

Es la hora de finalización del video.

NotOutdoorsFailureDetails

Detalles relacionados con ProcessingFailureReason#NOT_OUTDOORS. Si se encuentran varios marcos interiores, el primero se registra aquí.

Campos
start_time

Duration

Tiempo relativo (desde el inicio de la transmisión de video por Internet) en el que se encontró un fotograma interior.

Foto

La foto se usa para almacenar fotos de 360° junto con sus metadatos.

Campos
photo_id

PhotoId

Obligatorio. Solo salida. Es obligatorio para actualizar una foto. Resultado solo cuando se crea una foto. Es el identificador de la foto, que es único entre todas las fotos de Google.
upload_reference

UploadRef

Solo entrada. Es obligatorio para crear una foto. Solo entrada. La URL del recurso a la que se suben los bytes de las fotos.
download_url

string

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

string

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

Pose

Opcional. Poses de la foto
connections[]

Connection

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

Timestamp

Opcional. Tiempo absoluto en que se capturó la foto. Cuando la foto no tiene una marca de tiempo EXIF, se utiliza para establecer una marca de tiempo en los metadatos de la foto.
upload_time

Timestamp

Solo salida. Hora en la que se subió la imagen.
places[]

Place

Opcional. Lugares a los que pertenece esta foto.
view_count

int64

Solo salida. La cantidad de vistas de la foto
transfer_status

TransferStatus

Solo salida. Estado de la transferencia de derechos de esta foto.
maps_publish_status

MapsPublishStatus

Solo salida. Estado en Google Maps, si esta foto se publicó o se rechazó.

MapsPublishStatus

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

Enumeraciones
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 La foto se rechazó por motivos desconocidos.

TransferStatus

Estado de la transferencia de derechos.

Enumeraciones
TRANSFER_STATUS_UNKNOWN No se especificó el estado de esta transferencia.
NEVER_TRANSFERRED Esta foto nunca estuvo en una transferencia.
PENDING Se inició la transferencia de fotos, pero el receptor aún no responde.
COMPLETED Se completó la transferencia de la foto y se transfirió esta foto 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.

PhotoId

Es el identificador de un Photo.

Campos
id

string

Es un identificador único para una foto.

PhotoResponse

Carga útil de respuesta para una sola Photo en operaciones por lotes, incluidas BatchGetPhotos y BatchUpdatePhotos.

Campos
status

Status

El estado de la operación para obtener o actualizar una sola foto en la solicitud por lotes.
photo

Photo

El recurso Photo, si la solicitud se realizó de forma correcta

PhotoSequence

Una secuencia de fotos de 360° junto con metadatos.

Campos
id

string

Solo salida. Es el identificador único de la secuencia de fotos. Esto también actúa como un ID de operación de larga duración si la carga se realiza de forma asíncrona.
photos[]

Photo

Solo salida. Fotos con marcas de tiempo en aumento
upload_reference

UploadRef

Solo entrada. Es obligatorio al crear una secuencia de fotos. El nombre del recurso en el que se suben los bytes de la secuencia de fotos (en forma de video).
capture_time_override

Timestamp

Opcional. Es el tiempo absoluto en el que se comienza a capturar la secuencia de fotos. Si la secuencia de fotos es un video, esta es la hora de inicio del video. Si este campo se propaga en la entrada, anula el tiempo de captura del video o el archivo XDM.
upload_time

Timestamp

Solo salida. Hora en la que se creó esta secuencia de fotos en el servicio de uSV Store.
raw_gps_timeline[]

Pose

Solo entrada. Mediciones de GPS sin procesar con marcas de tiempo crecientes del dispositivo que no están sincronizadas con el tiempo con cada foto. Estas mediciones sin procesar se usarán para inferir la posición de cada fotograma. Es obligatorio en la entrada cuando InputType es VIDEO y las mediciones de GPS sin procesar no están en el seguimiento de metadatos de movimiento de la cámara (CAMM). El usuario puede indicar cuál tiene prioridad con gps_source si se proporcionan mediciones de GPS sin procesar tanto en raw_gps_timeline como en el seguimiento de metadatos de movimiento de la cámara (CAMM).
gps_source

GpsSource

Solo entrada. Si tantoraw_gps_timeline como el seguimiento de metadatos de movimiento de la cámara (CAMM) contienen mediciones de GPS, indica cuál tiene prioridad.
imu

Imu

Solo entrada. Datos de IMU de tres ejes para la recopilación. Si estos datos son demasiado grandes para incluirlos en la solicitud, deben colocarse en la pista CAMM del video. Estos datos siempre tienen prioridad sobre los datos de CAMM equivalentes, si los hubiera.
processing_state

ProcessingState

Solo salida. Es el estado de procesamiento de esta secuencia.
failure_reason

ProcessingFailureReason

Solo salida. Si esta secuencia tiene processing_state = FAILED, este incluirá el motivo del error. Si processing_state es cualquier otro valor, este campo se desactivará.
failure_details

ProcessingFailureDetails

Solo salida. Si se configuró failure_reason en esta secuencia, es posible que contenga detalles adicionales sobre la falla.
distance_meters

double

Solo salida. La distancia calculada de la secuencia de fotos en metros.
sequence_bounds

LatLngBounds

Solo salida. Una caja rectangular que encapsula todas las imágenes de esta secuencia de fotos.
view_count

int64

Solo salida. Es la cantidad total de vistas que recibieron todas las imágenes publicadas en esta PhotoSequence.
filename

string

Solo salida. Es el nombre de archivo de la carga. No incluye la ruta del directorio. Solo está disponible si la secuencia se subió en una plataforma que proporciona el nombre del archivo.

GpsSource

Fuente principal de mediciones del GPS.

Enumeraciones
PHOTO_SEQUENCE Si existe, el GPS en el campo TrueView_gps_timeline tiene prioridad.
CAMERA_MOTION_METADATA_TRACK El GPS en el seguimiento de metadatos de movimiento de la cámara (CAMM) tiene prioridad si existe.

PhotoView

Especifica qué vista de Photo se debe incluir en la respuesta.

Enumeraciones
BASIC Las respuestas del servidor no incluyen la URL de descarga de los bytes de la foto. Es el valor predeterminado.
INCLUDE_DOWNLOAD_URL Las respuestas del servidor incluyen la URL de descarga de los bytes de la foto.

Lugar

Metadatos de lugar de una entidad.

Campos
place_id

string

Es el identificador de lugar, como se describe en https://developers.google.com/places/place-id.
name

string

Solo salida. El nombre del lugar, localizado en language_code.
language_code

string

Solo salida. El language_code con el que se localiza el nombre. Debería ser el language_code especificado en la solicitud, aunque puede ser un resguardo.

Postura

Medición de poses sin procesar para una entidad.

Campos
lat_lng_pair

LatLng

Es 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 una Photo, si no se proporcionan los pares de latitud y longitud, se usa la ubicación geográfica del encabezado exif. Un par de latitud y longitud que no se proporciona en el encabezado de la foto o el archivo exif provoca que el proceso de la foto falle.
altitude

double

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

double

Los siguientes parámetros de poses corresponden al centro de la foto. Coincide con https://developers.google.com/streetview/spherical-metadata. Orientación según la brújula, medida en el centro de la foto en grados en sentido horario desde el norte. El valor debe ser >=0 y <360. NaN indica una cantidad no medida.
pitch

double

Inclinación, medida en grados en el centro de la foto. 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

double

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

Timestamp

Hora del registro GPS desde la época UTC.
level

Level

Nivel (el piso de un edificio) que se utiliza para configurar la navegación vertical.
accuracy_meters

float

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 con este método: https://developer.android.com/reference/android/location/Location#getAccuracy(). Otras plataformas tienen métodos diferentes para obtener estimaciones de precisión similares.

ProcessingFailureDetails

Detalles adicionales para acompañar la enumeración ProcessingFailureReason. Se espera que este mensaje siempre se use junto con ProcessingFailureReason, y el valor oneof establecido en este mensaje debe coincidir con FailureReason.

Campos
Campo de unión details. Solo se establecerá un conjunto de detalles y debe coincidir con el enum correspondiente en ProcessingFailureReason. Las direcciones (details) solo pueden ser una de las siguientes opciones:
insufficient_gps_details

InsufficientGpsFailureDetails

Consulta InsufficientGpsFailureDetails.
gps_data_gap_details

GpsDataGapFailureDetails

Consulta GpsDataGapFailureDetails.
imu_data_gap_details

ImuDataGapFailureDetails

Consulta ImuDataGapFailureDetails.
not_outdoors_details

NotOutdoorsFailureDetails

Consulta NotOutdoorsFailureDetails.
no_overlap_gps_details

NoOverlapGpsFailureDetails

Consulta NoOverlapGpsFailureDetails.

ProcessingFailureReason

Posibles motivos por los que no se pudo procesar este PhotoSequence.

Enumeraciones
PROCESSING_FAILURE_REASON_UNSPECIFIED No se especifica el motivo de la falla; este es el valor predeterminado.
LOW_RESOLUTION La resolución del fotograma del video es demasiado pequeña.
DUPLICATE Este video ya se subió antes.
INSUFFICIENT_GPS Muy pocos puntos de GPS.
NO_OVERLAP_GPS No hay superposición entre el intervalo de tiempo del seguimiento GPS y el intervalo de tiempo del video.
INVALID_GPS El GPS no es válido (p.ej., todos los puntos de GPS están en (0,0))
FAILED_TO_REFINE_POSITIONS La secuencia de fotos no se pudo ubicar con precisión en el mundo.
TAKEDOWN Se eliminó la secuencia por motivos relacionados con las políticas.
CORRUPT_VIDEO El archivo de video estaba dañado o no se pudo decodificar.
INTERNAL Se produjo una falla permanente en el sistema subyacente.
INVALID_VIDEO_FORMAT El formato del video no es válido o no es compatible.
INVALID_VIDEO_DIMENSIONS Se encontró una relación de aspecto de imagen no válida.
INVALID_CAPTURE_TIME La hora de captura no es válida. Las marcas de tiempo eran del futuro.
GPS_DATA_GAP Los datos de GPS contienen un intervalo de más de 5 segundos de duración.
JUMPY_GPS Los datos de GPS son demasiado erráticos para ser procesados.
INVALID_IMU Los datos de IMU (acelerómetro, giroscopio, etc.) no son válidos. Es posible que falten campos obligatorios (x, y, z o tiempo), que no tengan el formato correcto o que haya algún otro problema que impida que nuestros sistemas los analicen.
INSUFFICIENT_IMU Muy pocos puntos de IMU.
INSUFFICIENT_OVERLAP_TIME_SERIES Superposición insuficiente en el período de tiempo entre los datos del GPS, el IMU y otros datos de series temporales.
IMU_DATA_GAP Los datos de IMU (acelerómetro, giroscopio, etc.) contienen brechas de más de 0.1 segundos de duración.
UNSUPPORTED_CAMERA La cámara no es compatible.
NOT_OUTDOORS Algunos marcos estaban en interiores, lo que no es compatible.
INSUFFICIENT_VIDEO_FRAMES No hay suficientes fotogramas.
INSUFFICIENT_MOVEMENT No hay suficientes datos para migrar.

ProcessingState

Es el estado de procesamiento de la secuencia. Los estados se mueven de la siguiente manera:

     +-------------------------+
     |                         |
 +---v---+  +----------+  +----+----+
 |PENDING+-->PROCESSING+-->PROCESSED|
 +---+---+  +----+-----+  +----+----+
     |           |             |
     |        +--v---+         |
     +-------->FAILED<---------+
              +------+

La secuencia puede pasar a FAILED desde cualquier estado. Además, una secuencia procesada se puede volver a procesar en cualquier momento.

Enumeraciones
PROCESSING_STATE_UNSPECIFIED El estado no se especifica; este es el valor predeterminado.
PENDING La secuencia aún no comenzó a procesarse.
PROCESSING En este momento, se está procesando la secuencia.
PROCESSED La secuencia terminó de procesarse, incluido el perfeccionamiento de la posición.
FAILED No se pudo procesar la secuencia. Consulta FailureReason para obtener más detalles.

UpdatePhotoRequest

Solicitud para actualizar los metadatos de un Photo. No se pueden actualizar los píxeles de una foto.

Campos
photo

Photo

Obligatorio. Un objeto Photo que contiene los metadatos nuevos.
update_mask

FieldMask

Obligatorio. Máscara que identifica campos en los metadatos de la foto que se actualizarán. Si no están presentes, los metadatos Photo antiguos se reemplazan por completo por los nuevos metadatos Photo en esta solicitud. La actualización falla si se especifican campos no válidos. Se pueden especificar varios campos en una lista de valores delimitados por comas.

Los siguientes campos son válidos:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

Nota: Cuando updateMask contiene campos repetidos, se reemplaza todo el conjunto de valores repetidos por el contenido nuevo. Por ejemplo, si updateMask contiene connections y UpdatePhotoRequest.photo.connections está vacío, se quitarán todas las conexiones.

UploadRef

Subir referencia para archivos multimedia.

Campos
Campo de unión file_source. Obligatorio. Las direcciones (file_source) solo pueden ser una de las siguientes opciones:
upload_url

string

La referencia de carga debe ser única para cada usuario. Sigue la forma: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}".