Package google.streetview.publish.v1

Índice

StreetViewPublishService

Publica y conecta fotos que aportan los usuarios en Street View.

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Borra una lista de Photos y sus metadatos.

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

Permisos 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 falla BatchGetPhotos, significa que faltan campos críticos o que hay un error de autenticación. Incluso si BatchGetPhotos funciona correctamente, las fotos individuales del lote pueden tener errores. Estas fallas se especifican en cada PhotoResponse.status de BatchGetPhotosResponse.results. Consulta GetPhoto para conocer las fallas específicas que pueden ocurrir por foto.

Permisos 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 del lugar, las conexiones, etc. No se pueden cambiar los píxeles de las fotos.

Ten en cuenta que, si falla BatchUpdatePhotos, significa que faltan campos críticos o que hay un error de autenticación. Incluso si BatchUpdatePhotos funciona correctamente, las fotos individuales del lote pueden tener errores. Estas fallas se especifican en cada PhotoResponse.status de BatchUpdatePhotosResponse.results. Consulta UpdatePhoto para conocer las 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á.

Permisos 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 forma de establecer el encabezado, el tono y el rollo en CreatePhoto es a través de los metadatos de 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:

Permisos 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 del dispositivo extensible (XDM, http://www.xdm.org/) para publicar 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:

Permisos 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:

Permisos 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:

Permisos 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:

Permisos 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 = false, si aún no finalizó el procesamiento de PhotoSequence.
  • Operation.done = verdadero y se propaga Operation.error si hubo un error en el procesamiento.
  • Operation.done = verdadero y se propaga Operation.response, que contiene un mensaje PhotoSequence.

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

Permisos 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 de CreatePhotoSequence.

Permisos 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.

Permisos 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. Se usa la URL de carga del elemento UploadRef que se muestra para subir los datos de la photoSequence.

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

Permisos 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 objeto UploadRef que se muestra para subir los bytes de la 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.

Permisos 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 del lugar, las conexiones, etc. No se pueden cambiar los píxeles de las fotos.

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:

Permisos 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

Solicita borrar varios Photos.

Campos
photo_ids[]

string

Obligatorio. ID de Photos. Las solicitudes HTTP GET 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

Es 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 muestra 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 la foto.
Campos
photo_ids[]

string

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

PhotoView

Obligatorio. Especifica si se debe mostrar una URL de descarga para los bytes de la foto 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 usa la preferencia de idioma del usuario para los servicios de Google.

BatchGetPhotosResponse

Respuesta a la operación get por lotes de Photos.

Campos
results[]

PhotoResponse

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

BatchUpdatePhotosRequest

Solicitar que se actualicen 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 de 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 la contiene y otra foto.

CreatePhotoRequest

Solicita crear un Photo.

Campos
photo

Photo

Obligatorio. Foto que se creará.

CreatePhotoSequenceRequest

Solicita crear un PhotoSequence a partir de un video.

Campos
photo_sequence

PhotoSequence

Obligatorio. PhotoSequence para crear.
input_type

InputType

Obligatorio. La forma de entrada de PhotoSequence.

InputType

Formas de entrada de PhotoSequence

Enumeradores
INPUT_TYPE_UNSPECIFIED No se especifica. El servidor mostrará google.rpc.Code.INVALID_ARGUMENT.
VIDEO Video en 360°.
XDM Extensible Device Metadata (Metadatos del dispositivo extensible): http://www.xdm.org

DeletePhotoRequest

Solicita borrar un Photo.

Campos
photo_id

string

Obligatorio. Es el ID de Photo.

DeletePhotoSequenceRequest

Solicita borrar un PhotoSequence.

Campos
sequence_id

string

Obligatorio. Es el ID de PhotoSequence.

GetPhotoRequest

Solicita obtener un Photo.

De forma predeterminada

  • no muestra 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 la foto.
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 la foto en la respuesta 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 usa la preferencia de idioma del usuario para los servicios de Google.

GetPhotoSequenceRequest

Solicita obtener un PhotoSequence.

De forma predeterminada

Parámetros:

  • view controla si se muestra la URL de descarga para el 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 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 el que tenga la mayor duración.

Campos
gap_duration

Duration

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

Duration

Tiempo relativo (desde el inicio de la transmisión de video por Internet) cuando comenzó la brecha.

Imu

Datos de IMU provenientes de los sensores del dispositivo.

Campos
accel_mpsps[]

Measurement3d

Las mediciones del acelerómetro en metros/s^2 con marcas de tiempo en aumento de los dispositivos.
gyro_rps[]

Measurement3d

El giroscopio mide en radianes por segundo con marcas de tiempo en aumento provenientes de los dispositivos.
mag_ut[]

Measurement3d

Las mediciones del magnetómetro del campo magnético en microteslas (uT) con marcas de tiempo crecientes de los dispositivos.

Medición 3d

Una muestra genérica de medición 3D.

Campos
capture_time

Timestamp

Es la marca de tiempo de la medición de IMU.
x

float

Es la medición del sensor en el eje x.
y

float

Es la medición del sensor en el eje y.
z

float

Es la medición del sensor en el eje z.

ImuDataGapFailureDetails

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

Campos
gap_duration

Duration

La duración del déficit que se encontró en los datos de IMU
gap_start_time

Duration

Tiempo relativo (desde el inicio de la transmisión de video por Internet) cuando comenzó la brecha.

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

Un rectángulo en coordenadas geográficas.

Campos
southwest

LatLng

El extremo suroeste de estos límites.
northeast

LatLng

La esquina noreste de estos límites.

Nivel

Información sobre el nivel que contenga el número de nivel y su nombre correspondiente

Campos
number

double

Opcional. Número de piso, que se usa para 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 aceptan valores que no sean números enteros.
name

string

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

ListPhotoSequencesRequest

Solicita que se incluyan 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 de token de la página siguiente que se muestra en una solicitud ListPhotoSequences anterior, si corresponde.
Campos
page_size

int32

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

string

Opcional. El valor nextPageToken que se muestra en una solicitud ListPhotoSequences anterior, si corresponde.
filter

string

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

Los filtros admitidos son los siguientes: 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 deben enviarse como una frase para admitir varias palabras y caracteres especiales agregando comillas de escape. P. ej.: filename_query="ejemplo de una frase.mp4"

ListPhotoSequencesResponse

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 de 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 = false, si aún no finalizó el procesamiento de PhotoSequence.
  • Operation.done = verdadero y se propaga Operation.error si hubo un error en el procesamiento.
  • Operation.done = 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

Solicita que se incluyan todas las fotos que pertenezcan al usuario que envía la solicitud.

De forma predeterminada

  • no muestra 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 la foto.
  • pageSize: Determina la cantidad máxima de fotos que se mostrarán.
  • pageToken es el valor de token de la página siguiente que se muestra en una solicitud ListPhotos anterior, si corresponde.
  • filter permite filtrar por 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 el valor de pageSize es cero o no se proporciona, se utiliza 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 nextPageToken que se muestra en una solicitud ListPhotos anterior, si corresponde.
filter

string

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

Los filtros compatibles 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 usa la preferencia de idioma del usuario para los servicios de Google.

ListPhotosResponse

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

Hora de finalización del video.

NotOutdoorsFailureDetails

Detalles relacionados con ProcessingFailureReason#NOT_OUTDOORS. Si se encuentran varios fotogramas de 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 los metadatos.

Campos
photo_id

PhotoId

Obligatorio. Solo salida. Obligatorio cuando se actualiza una foto. Resultado solo al crear una foto. Es el identificador de la foto, que es único entre todas las fotos de Google.
upload_reference

UploadRef

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

string

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

string

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

Pose

Opcional. Postura de la foto.
connections[]

Connection

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

Timestamp

Opcional. Tiempo absoluto en que se tomó 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.
upload_time

Timestamp

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

Place

Opcional. Lugares a los que pertenece esta foto
view_count

int64

Solo salida. 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.

Enumeradores
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 una razón desconocida.

TransferStatus

Estado de la transferencia de derechos

Enumeradores
TRANSFER_STATUS_UNKNOWN No se especifica el estado de esta transferencia.
NEVER_TRANSFERRED Esta foto nunca estuvo en una transferencia.
PENDING Se inició la transferencia de esta foto, pero el destinatario aún no responde.
COMPLETED Se completó la transferencia de la foto y esta foto se transfirió al destinatario.
REJECTED El destinatario rechazó esta transferencia de foto.
EXPIRED La transferencia de fotos venció antes de que el destinatario realizara alguna acción.
CANCELLED El remitente canceló la transferencia de esta foto.
RECEIVED_VIA_TRANSFER El destinatario es el propietario de esta foto debido a una transferencia de derechos.

PhotoId

Es el identificador de un objeto Photo.

Campos
id

string

Es un identificador único para una foto.

PhotoResponse

Carga útil de respuesta para un solo 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. Obligatorio al crear una secuencia de fotos. El nombre del recurso al que se suben los bytes de la secuencia de fotos (en forma de video).
capture_time_override

Timestamp

Opcional. Tiempo absoluto cuando comienza a capturarse la secuencia de fotos. Si la secuencia de fotos es un video, este es el momento de inicio del video. Si este campo se completa en la entrada, anula la hora de captura en el archivo XDM o de video.
upload_time

Timestamp

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

Pose

Solo entrada. Mediciones GPS sin procesar con marcas de tiempo en aumento del dispositivo que no se sincronizan con cada foto. Estas mediciones sin procesar se usarán para inferir la pose de cada fotograma. 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 a través de gps_source si se proporcionan mediciones de GPS sin procesar tanto en el seguimiento de metadatos de movimiento de la cámara (CAMM) como en el estado de RAW_gps_timeline y de la pista de metadatos de movimiento de la cámara (CAMM).
gps_source

GpsSource

Solo entrada. Si tanto el rastreador_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 del IMU de tres ejes para la colección. Si estos datos son demasiado grandes para incluirlos en la solicitud, deben colocarse en la pista de cámara del video. Estos datos siempre tienen prioridad sobre los datos de CAMM equivalentes (si existen).
processing_state

ProcessingState

Solo salida. El estado de procesamiento de esta secuencia.
failure_reason

ProcessingFailureReason

Solo salida. Si esta secuencia tiene process_state = FAILED, esto contendrá el motivo del error. Si compute_state tiene algún otro valor, no se establecerá este campo.
failure_details

ProcessingFailureDetails

Solo salida. Si esta secuencia tiene configurado el valor failure_reason, es posible que contenga detalles adicionales sobre el error.
distance_meters

double

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

LatLngBounds

Solo salida. Es un cuadro rectangular que encapsula todas las imágenes de la secuencia de fotos.
view_count

int64

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

string

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

GpsSource

Fuente principal de las mediciones del GPS.

Enumeradores
PHOTO_SEQUENCE El GPS en bruto_gps_timeline tiene prioridad si existe.
CAMERA_MOTION_METADATA_TRACK Si existe, el GPS en la pista de metadatos de movimiento de la cámara (CAMM) tiene prioridad.

PhotoView

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

Enumeradores
BASIC Las respuestas del servidor no incluyen la URL de descarga de los bytes de las fotos. Es el valor predeterminado.
INCLUDE_DOWNLOAD_URL Las respuestas del servidor incluyen la URL de descarga de los bytes de las fotos.

Lugar

Coloca metadatos para 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. Es el nombre del lugar, localizado en el idioma_code.
language_code

string

Solo salida. Es el language_code con el que se localizó el nombre. Debe ser el language_code especificado en la solicitud, pero puede ser un resguardo.

Postura

Medición de poses sin procesar para una entidad.

Campos
lat_lng_pair

LatLng

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 proporciona el par de latitud y longitud, se usa la ubicación geográfica del encabezado EXIF. Si no se proporciona un par de latitud y longitud en el encabezado de la foto o el exif, el proceso de la foto falla.
altitude

double

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

double

Los siguientes parámetros de postura se relacionan con el centro de la foto. Coincide con https://developers.google.com/streetview/spherical-metadata. Orientación de la brújula, medida 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

double

La inclinación se mide 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

Rollo, medido en grados. El valor debe ser mayor que 0 y menor que 360. Un valor de 0 significa nivel 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 usa para configurar la navegación vertical.
accuracy_meters

float

La precisión horizontal estimada de esta postura en metros con un 68% de confianza (una desviación estándar). Por ejemplo, en Android, este valor está disponible con el siguiente 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. Este mensaje siempre se espera que se use junto con ProcessingFailureReason, y el valor establecido en este mensaje debe coincidir con FailureReason.

Campos
Campo de unión details. Solo se establecerá un conjunto de detalles, que debe coincidir con la enumeración 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

Estos son los motivos posibles por los que no se pudo procesar esta PhotoSequence.

Enumeradores
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 se subió anteriormente.
INSUFFICIENT_GPS Muy pocos puntos de GPS.
NO_OVERLAP_GPS No hay superposición entre el período de seguimiento GPS y el período 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 quitó la secuencia por motivos relacionados con las políticas.
CORRUPT_VIDEO El archivo de video se dañó 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 procesarlos.
INVALID_IMU Los datos del IMU (acelerómetro, giroscopio, etc.) no son válidos. Es posible que les falten campos obligatorios (x, y, z o tiempo), que no tengan el formato correcto o que existan otros problemas que impidan que nuestros sistemas analicen el elemento.
INSUFFICIENT_IMU Muy pocos puntos de IMU
INSUFFICIENT_OVERLAP_TIME_SERIES Superposición insuficiente en el período entre el GPS, la 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 eran interiores, lo cual no es compatible.
INSUFFICIENT_VIDEO_FRAMES No hay suficientes fotogramas de video.
INSUFFICIENT_MOVEMENT No hay suficientes datos móviles.

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.

Enumeradores
PROCESSING_STATE_UNSPECIFIED El estado no está especificado; este es el valor predeterminado.
PENDING Aún no comenzó el procesamiento de la secuencia.
PROCESSING La secuencia se está procesando en este momento.
PROCESSED Se terminó de procesar la secuencia, incluida la posición de perfeccionamiento.
FAILED No se pudo procesar la secuencia. Consulta FailureReason para obtener más detalles.

UpdatePhotoRequest

Solicita actualizar los metadatos de un Photo. No se pueden actualizar los píxeles de las fotos.

Campos
photo

Photo

Obligatorio. Un objeto Photo que contiene los metadatos nuevos
update_mask

FieldMask

Obligatorio. Máscara que identifica los campos de los metadatos de la foto que se actualizarán. Si no están presentes, los metadatos Photo anteriores se reemplazan por completo con los metadatos nuevos de 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 con 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, todo el conjunto de valores repetidos se reemplaza por el contenido nuevo. Por ejemplo, si updateMask contiene connections y UpdatePhotoRequest.photo.connections está vacío, se quitarán todas las conexiones.

UploadRef

Sube la referencia para los 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. Debe tener el siguiente formato: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"