- Permintaan HTTP
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- PhotoSequence
- GpsSource
- Imu
- Measurement3d
- ProcessingState
- ProcessingFailureReason
- ProcessingFailureDetails
- InsufficientGpsFailureDetails
- GpsDataGapFailureDetails
- ImuDataGapFailureDetails
- NotOutdoorsFailureDetails
- NoOverlapGpsFailureDetails
- LatLngBounds
- InputType
- Cobalah!
Setelah klien selesai mengupload PhotoSequence
dengan UploadRef
yang ditampilkan, photoSequence.create
mengekstrak urutan foto 360 dari video atau Extensible Device Metadata (XDM, http://www.xdm.org/) untuk dipublikasikan ke Street View di Google Maps.
photoSequence.create
menampilkan Operation
, dengan ID PhotoSequence
ditetapkan di kolom Operation.name
.
Metode ini menampilkan kode error berikut:
google.rpc.Code.INVALID_ARGUMENT
jika permintaan salah format.google.rpc.Code.NOT_FOUND
jika referensi upload tidak ada.
Permintaan HTTP
POST https://streetviewpublish.googleapis.com/v1/photoSequence
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
Parameter | |
---|---|
inputType |
Wajib. Bentuk input |
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.
PhotoSequence
Urutan foto 360 beserta metadata.
Representasi JSON |
---|
{ "id": string, "photos": [ { object ( |
Kolom | |
---|---|
id |
Hanya output. ID unik untuk urutan foto. ID ini juga berfungsi sebagai ID operasi yang berjalan lama jika upload dilakukan secara asinkron. |
photos[] |
Hanya output. Foto dengan stempel waktu yang meningkat. |
uploadReference |
Hanya input. Wajib saat membuat urutan foto. Nama resource tempat byte urutan foto (dalam bentuk video) diupload. |
captureTimeOverride |
Opsional. Waktu absolut saat urutan foto mulai diambil. Jika urutan foto adalah video, ini adalah waktu mulai video. Jika kolom ini diisi di input, kolom ini akan menggantikan waktu pengambilan dalam file video atau XDM. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
uploadTime |
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: |
rawGpsTimeline[] |
Hanya input. Pengukuran GPS mentah dengan meningkatnya stempel waktu dari perangkat yang tidak disinkronkan dengan setiap foto. Pengukuran mentah ini akan digunakan untuk menyimpulkan pose setiap frame. Diperlukan saat InputType adalah VIDEO dan pengukuran GPS mentah tidak ada dalam Camera Motion Metadata Track (CAMM). Pengguna dapat menunjukkan mana yang lebih diprioritaskan menggunakan gpsSource jika pengukuran GPS mentah disediakan di rawGpsTimeline dan Camera Motion Metadata Track (CAMM). |
gpsSource |
Hanya input. Jika rawGpsTimeline dan Camera Motion Metadata Track (CAMM) berisi pengukuran GPS, tunjukkan pengukuran mana yang lebih diutamakan. |
imu |
Hanya input. Data IMU tiga sumbu untuk koleksi. Jika data ini terlalu besar untuk diajukan, data harus dimasukkan ke dalam jalur CAMM untuk video tersebut. Data ini selalu lebih diprioritaskan daripada data CAMM yang setara, jika ada. |
processingState |
Hanya output. Status pemrosesan urutan ini. |
failureReason |
Hanya output. Jika urutan ini memiliki processingState = FAILED, urutan ini akan berisi alasan kegagalannya. Jika processingState adalah nilai lain, kolom ini tidak akan disetel. |
failureDetails |
Hanya output. Jika urutan ini telah menetapkan |
distanceMeters |
Hanya output. Jarak yang dihitung dari urutan foto dalam meter. |
sequenceBounds |
Hanya output. Kotak persegi panjang yang merangkum setiap gambar dalam urutan foto ini. |
viewCount |
Hanya output. Total jumlah tampilan yang telah diterima oleh semua gambar yang dipublikasikan di PhotoSequence ini. |
filename |
Hanya output. Nama file upload. Tidak termasuk jalur direktori. Hanya tersedia jika urutan diupload di platform yang menyediakan nama file. |
GpsSource
Sumber utama pengukuran GPS.
Enum | |
---|---|
PHOTO_SEQUENCE |
GPS di rawGpsLinimasa akan diprioritaskan jika ada. |
CAMERA_MOTION_METADATA_TRACK |
GPS di Trek Metadata Gerakan Kamera (CAMM) akan diprioritaskan jika ada. |
Imu
Data IMU dari sensor perangkat.
Representasi JSON |
---|
{ "accelMpsps": [ { object ( |
Kolom | |
---|---|
accelMpsps[] |
Pengukuran akselerometer dalam meter/dtk^2 dengan peningkatan stempel waktu dari perangkat. |
gyroRps[] |
Pengukuran giroskop dalam radian/dtk dengan peningkatan stempel waktu dari perangkat. |
magUt[] |
Pengukuran magnetometer medan magnet dalam mikrotesla (uT) dengan meningkatnya stempel waktu dari perangkat. |
Pengukuran3d
Contoh pengukuran 3D umum.
Representasi JSON |
---|
{ "captureTime": string, "x": number, "y": number, "z": number } |
Kolom | |
---|---|
captureTime |
Stempel waktu pengukuran IMU. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
x |
Pengukuran sensor pada sumbu x. |
y |
Pengukuran sensor pada sumbu y. |
z |
Pengukuran sensor pada sumbu z. |
ProcessingState
Status pemrosesan urutan. Status tersebut bergerak sebagai berikut:
+-------------------------+
| |
+---v---+ +----------+ +----+----+
|PENDING+-->PROCESSING+-->PROCESSED|
+---+---+ +----+-----+ +----+----+
| | |
| +--v---+ |
+-------->FAILED<---------+
+------+
Urutan mungkin berpindah ke FAILED dari status mana pun. Selain itu, urutan yang diproses dapat diproses ulang kapan saja.
Enum | |
---|---|
PROCESSING_STATE_UNSPECIFIED |
Status tidak ditentukan, ini adalah nilai default. |
PENDING |
Urutan belum mulai diproses. |
PROCESSING |
Urutan sedang diproses. |
PROCESSED |
Urutan telah selesai diproses termasuk posisi pengoptimalan. |
FAILED |
Urutan gagal diproses. Lihat FailureReason untuk detail selengkapnya. |
ProcessingFailureReason
Kemungkinan alasan PhotoSequence
ini gagal diproses.
Enum | |
---|---|
PROCESSING_FAILURE_REASON_UNSPECIFIED |
Alasan kegagalan tidak ditentukan, 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 kerangka 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 atau tidak dapat didekode. |
INTERNAL |
Terjadi kegagalan permanen pada sistem yang mendasarinya. |
INVALID_VIDEO_FORMAT |
Format video tidak valid atau tidak didukung. |
INVALID_VIDEO_DIMENSIONS |
Rasio tinggi lebar gambar yang tidak valid ditemukan. |
INVALID_CAPTURE_TIME |
Waktu pengambilan tidak valid. Stempel waktu berasal dari masa mendatang. |
GPS_DATA_GAP |
Data GPS berisi jeda yang durasinya lebih dari 5 detik. |
JUMPY_GPS |
Data GPS terlalu tidak menentu untuk diproses. |
INVALID_IMU |
Data IMU (Akselerometer, Giroskop, dll.) tidak valid. Kolom yang wajib diisi mungkin tidak ada (x, y, z, atau waktu), mungkin tidak diformat dengan benar, atau masalah lain yang mencegah sistem kami menguraikannya. |
INSUFFICIENT_IMU |
Poin IMU terlalu sedikit. |
INSUFFICIENT_OVERLAP_TIME_SERIES |
Tumpang tindih yang tidak memadai dalam jangka waktu antara GPS, IMU, dan data deret waktu lainnya. |
IMU_DATA_GAP |
Data IMU (Akselerometer, Giroskop, dll.) berisi bagian kosong yang durasinya lebih dari 0,1 detik. |
UNSUPPORTED_CAMERA |
Kamera tidak didukung. |
NOT_OUTDOORS |
Beberapa bingkai berada di dalam ruangan, dan itu tidak didukung. |
INSUFFICIENT_VIDEO_FRAMES |
Frame video tidak cukup. |
INSUFFICIENT_MOVEMENT |
Data bergerak tidak cukup. |
ProcessingFailureDetails
Detail tambahan untuk menyertai enum ProcessingFailureReason. Pesan ini diharapkan akan digunakan bersama dengan ProcessingFailure, dan salah satu nilai yang ditetapkan dalam pesan ini harus cocok dengan FailureReason.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union details . Hanya satu kumpulan detail yang akan ditetapkan, dan harus cocok dengan enum yang sesuai di ProcessingFailureReason. details hanya ada berupa salah satu diantara berikut: |
|
insufficientGpsDetails |
Lihat BasicGpsFailureDetails. |
gpsDataGapDetails |
Lihat GpsDataGapFailureDetails. |
imuDataGapDetails |
Lihat ImuDataGapFailureDetails. |
notOutdoorsDetails |
Lihat NotOutdoorsFailureDetails. |
noOverlapGpsDetails |
Lihat NoTumpang-tindihGpsFailureDetails. |
InsufficientGpsFailureDetails
Detail terkait ProcessingFailureReason#INSUFFICIENT_GPS.
Representasi JSON |
---|
{ "gpsPointsFound": integer } |
Kolom | |
---|---|
gpsPointsFound |
Jumlah titik GPS yang ditemukan dalam video. |
GpsDataGapFailureDetails
Detail yang terkait dengan ProcessingFailureReason#GPS_DATA_GAP. Jika ada beberapa celah data GPS, hanya data dengan durasi terbesar yang dilaporkan di sini.
Representasi JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
Kolom | |
---|---|
gapDuration |
Durasi celah dalam data GPS yang ditemukan. Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan ' |
gapStartTime |
Waktu relatif (dari awal streaming video) saat jeda dimulai. Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan ' |
ImuDataGapFailureDetails
Detail yang terkait dengan ProcessingFailureReason#IMU_DATA_GAP. Jika ada beberapa kesenjangan data IMU, hanya data dengan durasi terbesar yang dilaporkan di sini.
Representasi JSON |
---|
{ "gapDuration": string, "gapStartTime": string } |
Kolom | |
---|---|
gapDuration |
Durasi kesenjangan dalam data IMU yang ditemukan. Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan ' |
gapStartTime |
Waktu relatif (dari awal streaming video) saat jeda dimulai. Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan ' |
NotOutdoorsFailureDetails
Detail terkait ProcessingFailureReason#NOT_OUTDOORS. Jika ada beberapa frame dalam ruangan yang ditemukan, frame pertama direkam di sini.
Representasi JSON |
---|
{ "startTime": string } |
Kolom | |
---|---|
startTime |
Waktu relatif (dari awal streaming video) saat frame dalam ruangan ditemukan. Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan ' |
NoOverlapGpsFailureDetails
Detail yang terkait dengan PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.
Representasi JSON |
---|
{ "gpsStartTime": string, "gpsEndTime": string, "videoStartTime": string, "videoEndTime": string } |
Kolom | |
---|---|
gpsStartTime |
Waktu titik GPS yang pertama kali direkam. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
gpsEndTime |
Waktu titik GPS yang terakhir direkam. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
videoStartTime |
Waktu mulai video. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
videoEndTime |
Waktu berakhir video. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
LatLngBounds
Persegi panjang dalam koordinat geografis.
Representasi JSON |
---|
{ "southwest": { object ( |
Kolom | |
---|---|
southwest |
Sudut barat daya batas ini. |
northeast |
Sudut timur laut batas ini. |
InputType
Formulir input PhotoSequence
.
Enum | |
---|---|
INPUT_TYPE_UNSPECIFIED |
Tidak ditentukan. Server akan menampilkan google.rpc.Code.INVALID_ARGUMENT . |
VIDEO |
Video 360. |
XDM |
Metadata Perangkat yang Dapat Diperluas, http://www.xdm.org |