- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- PhotoSequence
- GpsSource
- Imu
- Measurement3d
- ProcessingState
- ProcessingFailureReason
- ProcessingFailureDetails
- InsufficientGpsFailureDetails
- GpsDataGapFailureDetails
- ImuDataGapFailureDetails
- NotOutdoorsFailureDetails
- NoOverlapGpsFailureDetails
- LatLngBounds
- InputType
- Pruébala
Una vez que el cliente termina de subir el objeto PhotoSequence
con el objeto UploadRef
que se muestra, photoSequence.create
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.
photoSequence.create
muestra un Operation
, con el ID de PhotoSequence
establecido en el campo Operation.name
.
Este método muestra los siguientes códigos de error:
- Es
google.rpc.Code.INVALID_ARGUMENT
si la solicitud tiene un formato incorrecto. - Es
google.rpc.Code.NOT_FOUND
si la referencia de carga no existe.
Solicitud HTTP
POST https://streetviewpublish.googleapis.com/v1/photoSequence
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
Parámetros | |
---|---|
inputType |
Obligatorio. La forma de entrada de |
Cuerpo de la solicitud
El cuerpo de la solicitud incluye una instancia de PhotoSequence
.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Operation
.
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.
PhotoSequence
Una secuencia de fotos de 360° junto con metadatos
Representación JSON |
---|
{ "id": string, "photos": [ { object ( |
Campos | |
---|---|
id |
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[] |
Solo salida. Fotos con marcas de tiempo en aumento. |
uploadReference |
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). |
captureTimeOverride |
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. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
uploadTime |
Solo salida. La hora en la que se creó esta secuencia de fotos en el servicio de uSV Store. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
rawGpsTimeline[] |
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 con gpsSource si las mediciones de GPS sin procesar se proporcionan tanto en el objeto RawGpsTimeline como en el seguimiento de metadatos de movimiento de la cámara (CAMM). |
gpsSource |
Solo entrada. Si el objeto RAWGpsTimeline y el seguimiento de metadatos de movimiento de la cámara (CAMM) contienen mediciones de GPS, indica cuál tiene prioridad. |
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). |
processingState |
Solo salida. El estado de procesamiento de esta secuencia. |
failureReason |
Solo salida. Si esta secuencia tiene processingState = FAILED, este incluirá el motivo del error. Si ProcessingState tiene cualquier otro valor, no se establecerá este campo. |
failureDetails |
Solo salida. Si esta secuencia tiene configurado el valor |
distanceMeters |
Solo salida. La distancia calculada de la secuencia de fotos en metros. |
sequenceBounds |
Solo salida. Es un cuadro rectangular que encapsula todas las imágenes de la secuencia de fotos. |
viewCount |
Solo salida. La cantidad total de vistas que recibieron todas las imágenes publicadas en esta PhotoSequence. |
filename |
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 brutoGpsTimeline 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. |
Imu
Datos de IMU provenientes de los sensores del dispositivo.
Representación JSON |
---|
{ "accelMpsps": [ { object ( |
Campos | |
---|---|
accelMpsps[] |
Las mediciones del acelerómetro en metros/s^2 con marcas de tiempo en aumento de los dispositivos. |
gyroRps[] |
El giroscopio mide en radianes por segundo con marcas de tiempo en aumento provenientes de los dispositivos. |
magUt[] |
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.
Representación JSON |
---|
{ "captureTime": string, "x": number, "y": number, "z": number } |
Campos | |
---|---|
captureTime |
Es la marca de tiempo de la medición de IMU. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
x |
Es la medición del sensor en el eje x. |
y |
Es la medición del sensor en el eje y. |
z |
Es la medición del sensor en el eje z. |
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. |
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. |
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.
Representación JSON |
---|
{ // Union field |
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: |
|
insufficientGpsDetails |
Consulta InsufficientGpsFailureDetails. |
gpsDataGapDetails |
Consulta GpsDataGapFailureDetails. |
imuDataGapDetails |
Consulta ImuDataGapFailureDetails. |
notOutdoorsDetails |
Consulta NotOutdoorsFailureDetails. |
noOverlapGpsDetails |
Consulta NoOverlapGpsFailureDetails. |
InsufficientGpsFailureDetails
Detalles relacionados con ProcessingFailureReason#INSUFFICIENT_GPS.
Representación JSON |
---|
{ "gpsPointsFound": integer } |
Campos | |
---|---|
gpsPointsFound |
La cantidad de puntos de GPS que se encontraron en el video. |
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.
Representación JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
Campos | |
---|---|
gapDuration |
La duración del intervalo que se encontró en los datos de GPS. Es una duración en segundos con hasta nueve dígitos decimales que termina en " |
gapStartTime |
Tiempo relativo (desde el inicio de la transmisión de video por Internet) cuando comenzó la brecha. Es una duración en segundos con hasta nueve dígitos decimales que termina en " |
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.
Representación JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
Campos | |
---|---|
gapDuration |
La duración del déficit que se encontró en los datos de IMU Es una duración en segundos con hasta nueve dígitos decimales que termina en " |
gapStartTime |
Tiempo relativo (desde el inicio de la transmisión de video por Internet) cuando comenzó la brecha. Es una duración en segundos con hasta nueve dígitos decimales que termina en " |
NotOutdoorsFailureDetails
Detalles relacionados con ProcessingFailureReason#NOT_OUTDOORS. Si se encuentran varios fotogramas de interiores, el primero se registra aquí.
Representación JSON |
---|
{ "startTime": string } |
Campos | |
---|---|
startTime |
Tiempo relativo (desde el inicio de la transmisión de video por Internet) en el que se encontró un fotograma interior Es una duración en segundos con hasta nueve dígitos decimales que termina en " |
NoOverlapGpsFailureDetails
Detalles relacionados con PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.
Representación JSON |
---|
{ "gpsStartTime": string, "gpsEndTime": string, "videoStartTime": string, "videoEndTime": string } |
Campos | |
---|---|
gpsStartTime |
Hora del primer punto de GPS registrado. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
gpsEndTime |
Hora del último punto de GPS registrado. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
videoStartTime |
Hora de inicio del video. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
videoEndTime |
Hora de finalización del video. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
LatLngBounds
Un rectángulo en coordenadas geográficas.
Representación JSON |
---|
{ "southwest": { object ( |
Campos | |
---|---|
southwest |
El extremo suroeste de estos límites. |
northeast |
La esquina noreste de estos límites. |
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 |