Method: photoSequence.create

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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

photoSequence.create muestra un Operation, con el ID PhotoSequence establecido en el campo Operation.name.

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

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

enum (InputType)

Obligatorio. La forma de entrada de PhotoSequence.

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.

Secuencia de fotos

Una secuencia de fotos de 360° junto con los metadatos.

Representación JSON 
{
  "id": string,
  "photos": [
    {
      object (Photo)
    }
  ],
  "uploadReference": {
    object (UploadRef)
  },
  "captureTimeOverride": string,
  "uploadTime": string,
  "rawGpsTimeline": [
    {
      object (Pose)
    }
  ],
  "gpsSource": enum (GpsSource),
  "imu": {
    object (Imu)
  },
  "processingState": enum (ProcessingState),
  "failureReason": enum (ProcessingFailureReason),
  "distanceMeters": number,
  "sequenceBounds": {
    object (LatLngBounds)
  },
  "viewCount": string,
  "filename": string
}
Campos
id

string

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

object (Photo)

Solo salida. Fotos con marcas de tiempo crecientes.
uploadReference

object (UploadRef)

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

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC (Zulú) con resolución en nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
uploadTime

string (Timestamp format)

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 en nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
rawGpsTimeline[]

object (Pose)

Solo entrada. Mediciones GPS sin procesar con marcas de tiempo crecientes desde el dispositivo que no se sincronizan con cada foto. Estas mediciones sin procesar se utilizarán para inferir la pose de cada fotograma. Obligatorio en la entrada cuando el Tipo de entrada es VIDEO y las mediciones GPS sin procesar no están en la Pista de metadatos de movimiento de la cámara (CAMM). El usuario puede indicar cuál tiene prioridad con gpsSource si se proporcionan mediciones sin procesar de GPS tanto en crudoGpsTimeline como en el seguimiento de metadatos de movimiento de la cámara (CAMM).
gpsSource

enum (GpsSource)

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

object (Imu)

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

enum (ProcessingState)

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

enum (ProcessingFailureReason)

Solo salida. Si esta secuencia tiene processingState = FAILED, esto contendrá la razón por la que falló. Si el objeto processingState tiene otro valor, este campo no se establecerá.
distanceMeters

number

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

object (LatLngBounds)

Solo salida. Un cuadro rectangular que encapsula todas las imágenes de esta secuencia de fotos.
viewCount

string (int64 format)

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

string

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

Fuente de Gps

Fuente principal de mediciones GPS.

Enumeradores
PHOTO_SEQUENCE El GPS en crudoGpsTimeline tiene prioridad si existe.
CAMERA_MOTION_METADATA_TRACK El GPS en la Pista de metadatos de movimiento de la cámara (CAMM) tiene prioridad si existe.

Distrito de Imu

Datos de IMU de los sensores del dispositivo.

Representación JSON 
{
  "accelMpsps": [
    {
      object (Measurement3d)
    }
  ],
  "gyroRps": [
    {
      object (Measurement3d)
    }
  ],
  "magUt": [
    {
      object (Measurement3d)
    }
  ]
}
Campos
accelMpsps[]

object (Measurement3d)

Las medidas del acelerómetro en metros/segundo^2 con el aumento de las marcas de tiempo desde los dispositivos.
gyroRps[]

object (Measurement3d)

Las medidas del giroscopio en radianes/segundo con marcas de tiempo crecientes desde los dispositivos.
magUt[]

object (Measurement3d)

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

Medición 3d

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

Representación JSON 
{
  "captureTime": string,
  "x": number,
  "y": number,
  "z": number
}
Campos
captureTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC (Zulú) con resolución en nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
x

number

Medición del sensor en el eje x.
y

number

La medición del sensor en el eje y.
z

number

Medición del sensor en el eje z.

Estado de procesamiento

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 La secuencia aún no comenzó a procesarse.
PROCESSING La secuencia se está procesando.
PROCESSED Se terminó de procesar la secuencia, incluida la posición de refinamiento.
FAILED No se pudo procesar la secuencia. Consulta el error en la explicación para obtener más detalles.

Motivo de la falla de procesamiento

Los posibles motivos por los que no se pudo procesar el PhotoSequence.

Enumeradores
PROCESSING_FAILURE_REASON_UNSPECIFIED No se especificó el motivo del error, que es el valor predeterminado.
LOW_RESOLUTION La resolución del marco de video es demasiado pequeña.
DUPLICATE Este video ya se subió.
INSUFFICIENT_GPS Muy pocos puntos de GPS.
NO_OVERLAP_GPS No existe superposición entre el período del seguimiento GPS y el período del video.
INVALID_GPS GPS no 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 encontrar con precisión en el mundo.
TAKEDOWN La secuencia se eliminó por motivos relacionados con las políticas.
CORRUPT_VIDEO El archivo de video estaba dañado.
INTERNAL Se produjo un error 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 Tiempo de captura no válido Las marcas de tiempo eran del futuro.

LatLngBounds

Rectángulo en coordenadas geográficas.

Representación JSON 
{
  "southwest": {
    object (LatLng)
  },
  "northeast": {
    object (LatLng)
  }
}
Campos
southwest

object (LatLng)

La esquina sudoeste de estos límites.
northeast

object (LatLng)

La esquina noreste de estos límites.

Tipo de entrada

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 Metadatos de dispositivos extensibles: http://www.xdm.org