Method: photoSequence.create

Setelah klien selesai mengupload PhotoSequence dengan UploadRef yang ditampilkan, photoSequence.create akan mengekstrak urutan foto 360 dari video atau Metadata Perangkat Extensible (XDM, http://www.xdm.org/) untuk dipublikasikan ke Street View di Google Maps.

photoSequence.create menampilkan Operation, dengan ID PhotoSequence yang ditetapkan di kolom Operation.name.

Metode ini menampilkan kode error berikut:

Permintaan HTTP

POST https://streetviewpublish.googleapis.com/v1/photoSequence

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
inputType

enum (InputType)

Wajib diisi. Formulir input PhotoSequence.

Isi permintaan

Isi permintaan memuat instance PhotoSequence.

Isi respons

Jika berhasil, isi respons memuat instance Operation yang baru dibuat.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

UrutanFoto

Urutan foto 360 beserta metadata.

Representasi 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
}
Kolom
id

string

Hanya output. ID unik untuk urutan foto. Hal ini juga berfungsi sebagai ID operasi yang berjalan lama jika upload dilakukan secara asinkron.
photos[]

object (Photo)

Hanya output. Foto dengan peningkatan stempel waktu.
uploadReference

object (UploadRef)

Hanya input. Wajib saat membuat urutan foto. Nama resource tempat byte urutan foto (dalam bentuk video) diupload.
captureTimeOverride

string (Timestamp format)

Opsional. Waktu absolut saat urutan foto mulai diambil. Jika urutan foto adalah video, ini adalah waktu mulai video tersebut. Jika kolom ini diisi dalam input, kolom ini akan mengganti waktu pengambilan dalam file video atau XDM.

Stempel waktu dalam format RFC3339 UTC "Zulu" dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
uploadTime

string (Timestamp format)

Hanya output. Waktu urutan foto ini dibuat di layanan uSV Store.

Stempel waktu dalam format RFC3339 UTC "Zulu" dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
rawGpsTimeline[]

object (Pose)

Hanya input. Pengukuran GPS mentah dengan stempel waktu yang meningkat dari perangkat yang tidak disinkronkan dengan setiap foto. Pengukuran mentah ini akan digunakan untuk menyimpulkan pose dari setiap frame. Input diperlukan jika InputType adalah VIDEO dan pengukuran GPS mentah tidak berada di Trek Metadata Gerak Kamera (CAMM). Pengguna dapat menunjukkan setelan mana yang lebih diutamakan menggunakan gpsSource jika pengukuran GPS mentah disediakan di Jalur mentah GPS dan Trek Metadata Kamera (CAMM).
gpsSource

enum (GpsSource)

Hanya input. Jika rawGpsLinimasa dan Camera Motion Metadata Track (CAMM) berisi pengukuran GPS, tunjukkan parameter mana yang lebih diutamakan.
imu

object (Imu)

Hanya input. Data IMU tiga sumbu untuk koleksi. Jika data ini terlalu besar untuk diajukan dalam permintaan, maka data tersebut harus dimasukkan ke jalur CAMM untuk video. Data ini selalu lebih diutamakan daripada data CAMM yang setara, jika ada.
processingState

enum (ProcessingState)

Hanya output. Status pemrosesan urutan ini.
failureReason

enum (ProcessingFailureReason)

Hanya output. Jika urutan ini memiliki processingState = FAILED, ini akan berisi alasan kegagalannya. Jika processingState adalah nilai lain, kolom ini tidak akan ditetapkan.
distanceMeters

number

Hanya output. Jarak yang dihitung dari urutan foto dalam meter.
sequenceBounds

object (LatLngBounds)

Hanya output. Kotak persegi panjang yang mengenkapsulasi setiap gambar dalam urutan foto ini.
viewCount

string (int64 format)

Hanya output. Total jumlah tampilan yang telah diterima oleh semua gambar yang dipublikasikan di PhotoSequence ini.
filename

string

Hanya output. Nama file yang diupload. Tidak menyertakan jalur direktori. Hanya tersedia jika urutan diupload di platform yang menyediakan nama file.

GpsSumber

Sumber utama pengukuran GPS.

Enumerasi
PHOTO_SEQUENCE GPS di rawGpsLinimasa lebih diutamakan jika ada.
CAMERA_MOTION_METADATA_TRACK GPS di Trek Gerak Kamera (CAMM) lebih diutamakan jika ada.

Imu

Data IMU dari sensor perangkat.

Representasi JSON 
{
  "accelMpsps": [
    {
      object (Measurement3d)
    }
  ],
  "gyroRps": [
    {
      object (Measurement3d)
    }
  ],
  "magUt": [
    {
      object (Measurement3d)
    }
  ]
}
Kolom
accelMpsps[]

object (Measurement3d)

Pengukuran akselerometer dalam meter/dtk^2 dengan peningkatan stempel waktu dari perangkat.
gyroRps[]

object (Measurement3d)

Pengukuran giroskop dalam radian/dtk dengan stempel waktu yang meningkat dari perangkat.
magUt[]

object (Measurement3d)

Pengukuran magnetometer medan magnet dalam mikrotesla (uT) dengan peningkatan stempel waktu dari perangkat.

Pengukuran3d

Sampel pengukuran 3D generik.

Representasi JSON 
{
  "captureTime": string,
  "x": number,
  "y": number,
  "z": number
}
Kolom
captureTime

string (Timestamp format)

Stempel waktu pengukuran IMU.

Stempel waktu dalam format RFC3339 UTC "Zulu" dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
x

number

Pengukuran sensor pada sumbu x.
y

number

Pengukuran sensor pada sumbu y.
z

number

Pengukuran sensor pada sumbu z.

Status Pemrosesan

Status pemrosesan urutan. Status bergerak sebagai berikut:

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

Urutan dapat dipindahkan ke FAILED dari status mana pun. Selain itu, urutan yang telah diproses dapat diproses ulang kapan saja.

Enumerasi
PROCESSING_STATE_UNSPECIFIED Status tidak ditetapkan, ini adalah nilai default.
PENDING Urutan belum mulai diproses.
PROCESSING Urutan sedang diproses.
PROCESSED Urutan telah selesai diproses termasuk posisi penyaringan.
FAILED Urutan gagal diproses. Lihat FailureReason untuk detail selengkapnya.

ProcessingFailureReason

Kemungkinan alasan PhotoSequence gagal diproses.

Enumerasi
PROCESSING_FAILURE_REASON_UNSPECIFIED Alasan kegagalan tidak disebutkan, ini adalah nilai default.
LOW_RESOLUTION Resolusi frame video terlalu kecil.
DUPLICATE Video ini telah diupload sebelumnya.
INSUFFICIENT_GPS Titik GPS terlalu sedikit.
NO_OVERLAP_GPS Tidak ada tumpang tindih antara jangka waktu pelacakan GPS dan jangka waktu video.
INVALID_GPS GPS tidak valid (misalnya semua titik GPS berada di (0,0))
FAILED_TO_REFINE_POSITIONS Urutan foto tidak dapat ditemukan secara akurat di dunia.
TAKEDOWN Urutan tersebut dihapus karena alasan kebijakan.
CORRUPT_VIDEO File video rusak.
INTERNAL Terjadi kegagalan permanen dalam sistem yang mendasarinya.
INVALID_VIDEO_FORMAT Format video tidak valid atau tidak didukung.
INVALID_VIDEO_DIMENSIONS Ditemukan rasio lebar tinggi gambar yang tidak valid.
INVALID_CAPTURE_TIME Waktu pengambilan tidak valid. Stempel waktu tidak boleh berupa waktu yang akan datang.

LatLngBounds

Persegi panjang dalam koordinat geografis.

Representasi JSON 
{
  "southwest": {
    object (LatLng)
  },
  "northeast": {
    object (LatLng)
  }
}
Kolom
southwest

object (LatLng)

Sudut barat daya batas ini.
northeast

object (LatLng)

Sudut timur laut dari batas ini.

JenisInput

Formulir input PhotoSequence.

Enumerasi
INPUT_TYPE_UNSPECIFIED Tidak ditentukan. Server akan menampilkan google.rpc.Code.INVALID_ARGUMENT.
VIDEO Video 360.
XDM Metadata Perangkat yang Dapat Diperpanjang, http://www.xdm.org