Package google.streetview.publish.v1

Indeks

StreetViewPublishService

Memublikasikan dan menghubungkan foto kontribusi pengguna di Street View.

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

Menghapus daftar Photos dan metadatanya.

Perhatikan bahwa jika BatchDeletePhotos gagal, kolom penting tidak akan ada atau terjadi error autentikasi. Meskipun BatchDeletePhotos berhasil, setiap foto dalam batch mungkin gagal. Kegagalan ini ditentukan di setiap PhotoResponse.status dalam BatchDeletePhotosResponse.results. Lihat DeletePhoto untuk kegagalan tertentu yang dapat terjadi per foto.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

Mendapatkan metadata batch Photo yang ditentukan.

Perhatikan bahwa jika BatchGetPhotos gagal, kolom penting tidak akan ada atau terjadi error autentikasi. Meskipun BatchGetPhotos berhasil, setiap foto dalam batch mungkin gagal. Kegagalan ini ditentukan di setiap PhotoResponse.status dalam BatchGetPhotosResponse.results. Lihat GetPhoto untuk kegagalan tertentu yang dapat terjadi per foto.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

Memperbarui metadata Photos, seperti pose, pengaitan tempat, sambungan, dll. Mengubah piksel foto tidak didukung.

Perhatikan bahwa jika BatchUpdatePhotos gagal, kolom penting tidak akan ada atau terjadi error autentikasi. Meskipun BatchUpdatePhotos berhasil, setiap foto dalam batch mungkin gagal. Kegagalan ini ditentukan di setiap PhotoResponse.status dalam BatchUpdatePhotosResponse.results. Lihat UpdatePhoto untuk kegagalan tertentu yang dapat terjadi per foto.

Hanya kolom yang ditentukan dalam kolom updateMask yang digunakan. Jika updateMask tidak ada, pembaruan berlaku untuk semua kolom.

Jumlah pesan UpdatePhotoRequest di BatchUpdatePhotosRequest tidak boleh lebih dari 20.

Catatan: Untuk memperbarui Pose.altitude, Pose.latLngPair juga harus diisi. Jika tidak, permintaan akan gagal.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

Setelah klien selesai mengupload foto dengan UploadRef yang ditampilkan, CreatePhoto memublikasikan Photo yang diupload ke Street View di Google Maps.

Saat ini, satu-satunya cara untuk menyetel arah, pitch, dan roll di CreatePhoto adalah melalui metadata Photo Sphere XMP di byte foto. CreatePhoto mengabaikan kolom pose.heading, pose.pitch, pose.roll, pose.altitude, dan pose.level di Pose.

Metode ini menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

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

CreatePhotoSequence menampilkan Operation, dengan ID PhotoSequence ditetapkan di kolom Operation.name.

Metode ini menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

Menghapus Photo dan metadatanya.

Metode ini menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

Menghapus PhotoSequence dan metadatanya.

Metode ini menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

Mendapatkan metadata Photo yang ditentukan.

Metode ini menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

Mendapatkan metadata PhotoSequence yang ditentukan melalui antarmuka Operation.

Metode ini menampilkan tiga jenis respons berikut:

  • Operation.done = false, jika pemrosesan PhotoSequence belum selesai.
  • Operation.done = benar dan Operation.error diisi, jika terjadi error saat pemrosesan.
  • Operation.done = true dan Operation.response diterapkan, yang berisi pesan PhotoSequence.

Metode ini menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

Mencantumkan semua PhotoSequences milik pengguna, dalam urutan stempel waktu CreatePhotoSequence menurun.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

Mencantumkan semua Photos milik pengguna.

Catatan: Foto yang baru dibuat dan masih diindeks tidak ditampilkan dalam respons.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

Membuat sesi upload untuk mulai mengupload data urutan foto. URL upload UploadRef yang ditampilkan digunakan untuk mengupload data untuk photoSequence.

Setelah upload selesai, UploadRef digunakan dengan CreatePhotoSequence untuk membuat entri objek PhotoSequence.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

StartUpload

rpc StartUpload(Empty) returns (UploadRef)

Membuat sesi upload untuk mulai mengupload byte foto. Metode ini menggunakan URL upload dari UploadRef yang ditampilkan guna mengupload byte untuk Photo.

Selain persyaratan foto yang ditampilkan di https://support.google.com/maps/answer/7012050?ref_topic=6275604, foto tersebut harus memenuhi persyaratan berikut:

Setelah upload selesai, metode ini menggunakan UploadRef dengan CreatePhoto untuk membuat entri objek Photo.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

Memperbarui metadata Photo, seperti pose, pengaitan tempat, hubungan, dll. Mengubah piksel foto tidak didukung.

Hanya kolom yang ditentukan dalam kolom updateMask yang digunakan. Jika updateMask tidak ada, pembaruan berlaku untuk semua kolom.

Metode ini menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

BatchDeletePhotosRequest

Permintaan untuk menghapus beberapa Photos.

Kolom
photo_ids[]

string

Wajib. ID Photos. Permintaan GET HTTP memerlukan sintaksis berikut untuk parameter kueri URL: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

Respons untuk penghapusan batch satu atau beberapa Photos.

Kolom
status[]

Status

Status operasi untuk menghapus satu Photo dalam permintaan batch.

BatchGetPhotosRequest

Minta untuk mendapatkan satu atau beberapa Photos. Secara default

  • tidak menampilkan URL download untuk byte foto.

Parameter:

  • view mengontrol apakah URL download untuk byte foto ditampilkan.
Kolom
photo_ids[]

string

Wajib. ID Photos. Untuk permintaan HTTP GET, parameter kueri URL harus photoIds=<id1>&photoIds=<id2>&....

view

PhotoView

Wajib. Menentukan apakah URL download untuk byte foto harus ditampilkan dalam respons Photo.

language_code

string

Opsional. Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jika language_code tidak ditentukan, preferensi bahasa pengguna untuk layanan Google akan digunakan.

BatchGetPhotosResponse

Respons untuk mendapatkan Photos dalam batch.

Kolom
results[]

PhotoResponse

Daftar hasil untuk setiap Photo individu yang diminta, dalam urutan yang sama seperti permintaan di BatchGetPhotos.

BatchUpdatePhotosRequest

Meminta pembaruan metadata foto. Memperbarui piksel foto tidak didukung.

Kolom
update_photo_requests[]

UpdatePhotoRequest

Wajib. Daftar UpdatePhotoRequests.

BatchUpdatePhotosResponse

Respons terhadap update batch metadata satu atau beberapa Photos.

Kolom
results[]

PhotoResponse

Daftar hasil untuk setiap Photo individu diperbarui, dalam urutan yang sama dengan permintaan.

Koneksi

Koneksi adalah link dari foto sumber ke foto tujuan.

Kolom
target

PhotoId

Wajib. Tujuan koneksi dari foto penampung ke foto lain.

CreatePhotoRequest

Permintaan untuk membuat Photo.

Kolom
photo

Photo

Wajib. Foto yang akan dibuat.

CreatePhotoSequenceRequest

Permintaan untuk membuat PhotoSequence dari video.

Kolom
photo_sequence

PhotoSequence

Wajib. PhotoSequence untuk membuat.

input_type

InputType

Wajib. Bentuk input PhotoSequence.

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

DeletePhotoRequest

Permintaan untuk menghapus Photo.

Kolom
photo_id

string

Wajib. ID Photo.

DeletePhotoSequenceRequest

Permintaan untuk menghapus PhotoSequence.

Kolom
sequence_id

string

Wajib. ID PhotoSequence.

GetPhotoRequest

Permintaan untuk mendapatkan Photo.

Secara default

  • tidak menampilkan URL download untuk byte foto.

Parameter:

  • view mengontrol apakah URL download untuk byte foto ditampilkan.
Kolom
photo_id

string

Wajib. ID Photo.

view

PhotoView

Wajib. Menentukan apakah URL download untuk byte foto harus ditampilkan dalam respons Photo.

language_code

string

Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jika language_code tidak ditentukan, preferensi bahasa pengguna untuk layanan Google akan digunakan.

GetPhotoSequenceRequest

Permintaan untuk mendapatkan PhotoSequence.

Secara default

Parameter:

  • view mengontrol apakah URL download untuk PhotoSequence ditampilkan.
Kolom
sequence_id

string

Wajib. ID urutan foto.

view
(deprecated)

PhotoView

Menentukan apakah URL download untuk urutan foto harus ditampilkan dalam download_url setiap foto dalam respons PhotoSequence.

Catatan: Saat ini belum diterapkan.

filter

string

Opsional. Ekspresi filter. Misalnya: published_status=PUBLISHED.

Filter yang didukung adalah: published_status. Lihat https://google.aip.dev/160 untuk informasi selengkapnya.

GpsDataGapFailureDetails

Detail yang terkait dengan ProcessingFailureReason#GPS_DATA_GAP. Jika ada beberapa celah data GPS, hanya data dengan durasi terbesar yang dilaporkan di sini.

Kolom
gap_duration

Duration

Durasi celah dalam data GPS yang ditemukan.

gap_start_time

Duration

Waktu relatif (dari awal streaming video) saat jeda dimulai.

Imu

Data IMU dari sensor perangkat.

Kolom
accel_mpsps[]

Measurement3d

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

gyro_rps[]

Measurement3d

Pengukuran giroskop dalam radian/dtk dengan peningkatan stempel waktu dari perangkat.

mag_ut[]

Measurement3d

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

Pengukuran3d

Contoh pengukuran 3D umum.

Kolom
capture_time

Timestamp

Stempel waktu pengukuran IMU.

x

float

Pengukuran sensor pada sumbu x.

y

float

Pengukuran sensor pada sumbu y.

z

float

Pengukuran sensor pada sumbu z.

ImuDataGapFailureDetails

Detail yang terkait dengan ProcessingFailureReason#IMU_DATA_GAP. Jika ada beberapa kesenjangan data IMU, hanya data dengan durasi terbesar yang dilaporkan di sini.

Kolom
gap_duration

Duration

Durasi kesenjangan dalam data IMU yang ditemukan.

gap_start_time

Duration

Waktu relatif (dari awal streaming video) saat jeda dimulai.

InsufficientGpsFailureDetails

Detail terkait ProcessingFailureReason#INSUFFICIENT_GPS.

Kolom
gps_points_found

int32

Jumlah titik GPS yang ditemukan dalam video.

LatLngBounds

Persegi panjang dalam koordinat geografis.

Kolom
southwest

LatLng

Sudut barat daya batas ini.

northeast

LatLng

Sudut timur laut batas ini.

Tingkat

Informasi level yang berisi nomor level dan nama yang terkait.

Kolom
number

double

Opsional. Nomor lantai, digunakan untuk memesan. 0 menunjukkan tingkat tanah, 1 menunjukkan tingkat pertama di atas permukaan tanah, -1 menunjukkan tingkat pertama di bawah permukaan tanah. Nilai non-bilangan bulat boleh digunakan.

name

string

Wajib. Nama yang ditetapkan untuk Level ini, dibatasi hingga 3 karakter. Pertimbangkan bagaimana tombol lift akan diberi label untuk tingkat ini jika ada elevator.

ListPhotoSequencesRequest

Permintaan untuk mencantumkan semua urutan foto milik pengguna yang mengirim permintaan.

Parameter:

  • pageSize menentukan jumlah maksimum urutan foto yang akan ditampilkan.
  • pageToken adalah nilai token halaman berikutnya yang ditampilkan dari permintaan ListPhotoSequences sebelumnya, jika ada.
Kolom
page_size

int32

Opsional. Jumlah maksimum urutan foto yang akan ditampilkan. pageSize tidak boleh negatif. Jika pageSize nol atau tidak diberikan, ukuran halaman default 100 akan digunakan. Jumlah urutan foto yang ditampilkan dalam respons mungkin kurang dari pageSize jika jumlah kecocokan kurang dari pageSize. Hal ini saat ini belum diterapkan, tetapi sedang dalam proses.

page_token

string

Opsional. Nilai nextPageToken yang ditampilkan dari permintaan ListPhotoSequences sebelumnya, jika ada.

filter

string

Opsional. Ekspresi filter. Misalnya: imagery_type=SPHERICAL.

Filter yang didukung adalah: imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, `max_capture_time_seconds. Lihat https://google.aip.dev/160 untuk informasi selengkapnya. Kueri nama file harus dikirim sebagai Frasa untuk mendukung beberapa kata dan karakter khusus dengan menambahkan tanda petik escape. Contoh: namafile_query="contoh frasa.mp4"

ListPhotoSequencesResponse

Respons untuk mencantumkan semua urutan foto milik pengguna.

Kolom
photo_sequences[]

Operation

Daftar urutan foto melalui antarmuka Operation.

Jumlah maksimum item yang ditampilkan didasarkan pada kolom pageSize dalam permintaan.

Setiap item dalam daftar dapat memiliki tiga kemungkinan status,

  • Operation.done = false, jika pemrosesan PhotoSequence belum selesai.
  • Operation.done = benar dan Operation.error diisi, jika terjadi error saat pemrosesan.
  • Operation.done = true dan Operation.response berisi pesan PhotoSequence. Di setiap urutan, hanya Id yang diisi.
next_page_token

string

Token untuk mengambil halaman hasil berikutnya, atau kosong jika tidak ada lagi hasil dalam daftar.

ListPhotosRequest

Permintaan untuk mencantumkan semua foto milik pengguna yang mengirim permintaan.

Secara default

  • tidak menampilkan URL download untuk byte foto.

Parameter:

  • view mengontrol apakah URL download untuk byte foto ditampilkan.
  • pageSize menentukan jumlah foto maksimum yang akan ditampilkan.
  • pageToken adalah nilai token halaman berikutnya yang ditampilkan dari permintaan ListPhotos sebelumnya, jika ada.
  • filter memungkinkan pemfilteran menurut parameter tertentu. 'placeId' adalah satu-satunya parameter yang didukung saat ini.
Kolom
view

PhotoView

Wajib. Menentukan apakah URL download untuk byte foto harus ditampilkan dalam respons Foto.

page_size

int32

Opsional. Jumlah foto maksimum yang akan dikembalikan. pageSize tidak boleh negatif. Jika pageSize nol atau tidak diberikan, ukuran halaman default 100 akan digunakan. Jumlah foto yang ditampilkan dalam respons mungkin kurang dari pageSize jika jumlah foto milik pengguna kurang dari pageSize.

page_token

string

Opsional. Nilai nextPageToken yang ditampilkan dari permintaan ListPhotos sebelumnya, jika ada.

filter

string

Opsional. Ekspresi filter. Misalnya: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw.

Filter yang didukung adalah: placeId, min_latitude, max_latitude, min_longitude, max_longitude. Lihat https://google.aip.dev/160 untuk informasi selengkapnya.

language_code

string

Opsional. Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Jika language_code tidak ditentukan, preferensi bahasa pengguna untuk layanan Google akan digunakan.

ListPhotosResponse

Respons untuk menampilkan daftar semua foto milik pengguna.

Kolom
photos[]

Photo

Daftar foto. Kolom pageSize dalam permintaan menentukan jumlah item yang ditampilkan.

next_page_token

string

Token untuk mengambil halaman hasil berikutnya, atau kosong jika tidak ada lagi hasil dalam daftar.

NoOverlapGpsFailureDetails

Detail yang terkait dengan PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.

Kolom
gps_start_time

Timestamp

Waktu titik GPS yang pertama kali direkam.

gps_end_time

Timestamp

Waktu titik GPS yang terakhir direkam.

video_start_time

Timestamp

Waktu mulai video.

video_end_time

Timestamp

Waktu berakhir video.

NotOutdoorsFailureDetails

Detail terkait ProcessingFailureReason#NOT_OUTDOORS. Jika ada beberapa frame dalam ruangan yang ditemukan, frame pertama direkam di sini.

Kolom
start_time

Duration

Waktu relatif (dari awal streaming video) saat frame dalam ruangan ditemukan.

Foto

Foto digunakan untuk menyimpan foto 360 beserta metadata foto.

Kolom
photo_id

PhotoId

Wajib. Hanya output. Diperlukan saat memperbarui foto. Hanya menghasilkan output saat membuat foto. ID untuk foto, yang unik di antara semua foto di Google.

upload_reference

UploadRef

Hanya input. Diperlukan saat membuat foto. Hanya input. URL resource tempat byte foto diupload.

download_url

string

Hanya output. URL download untuk byte foto. Kolom ini hanya ditetapkan jika GetPhotoRequest.view ditetapkan ke PhotoView.INCLUDE_DOWNLOAD_URL.

thumbnail_url

string

Hanya output. URL thumbnail untuk menampilkan pratinjau foto tertentu.

pose

Pose

Opsional. Pose foto.

connections[]

Connection

Opsional. Koneksi ke foto lain. Koneksi mewakili link dari foto ini ke foto lain.

capture_time

Timestamp

Opsional. Waktu absolut saat foto diambil. Jika foto tidak memiliki stempel waktu exif, ini akan digunakan untuk menyetel stempel waktu dalam metadata foto.

upload_time

Timestamp

Hanya output. Waktu saat gambar diupload.

places[]

Place

Opsional. Tempat foto ini berada.

view_count

int64

Hanya output. Jumlah tampilan foto.

transfer_status

TransferStatus

Hanya output. Status transfer hak atas foto ini.

maps_publish_status

MapsPublishStatus

Hanya output. Status di Google Maps, apakah foto ini dipublikasikan atau ditolak.

MapsPublishStatus

Status publikasi foto di Google Maps.

Enum
UNSPECIFIED_MAPS_PUBLISH_STATUS Status foto tidak diketahui.
PUBLISHED Foto dipublikasikan ke publik melalui Google Maps.
REJECTED_UNKNOWN Foto telah ditolak karena alasan yang tidak diketahui.

TransferStatus

Status transfer hak.

Enum
TRANSFER_STATUS_UNKNOWN Status transfer ini tidak ditentukan.
NEVER_TRANSFERRED Foto ini belum pernah ditransfer.
PENDING Transfer foto ini telah dimulai, tetapi penerima belum merespons.
COMPLETED Transfer foto telah selesai, dan foto ini telah ditransfer ke penerima.
REJECTED Penerima menolak transfer foto ini.
EXPIRED Masa berlaku transfer foto berakhir sebelum penerima melakukan tindakan.
CANCELLED Pengirim membatalkan transfer foto ini.
RECEIVED_VIA_TRANSFER Penerima memiliki foto ini karena transfer hak.

PhotoId

ID untuk Photo.

Kolom
id

string

ID unik untuk foto.

PhotoResponse

Payload respons untuk satu Photo dalam operasi batch, termasuk BatchGetPhotos dan BatchUpdatePhotos.

Kolom
status

Status

Status operasi untuk mendapatkan atau memperbarui satu foto dalam permintaan batch.

photo

Photo

Resource Photo, jika permintaan berhasil.

PhotoSequence

Urutan foto 360 beserta metadata.

Kolom
id

string

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

photos[]

Photo

Hanya output. Foto dengan stempel waktu yang meningkat.

upload_reference

UploadRef

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

capture_time_override

Timestamp

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.

upload_time

Timestamp

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

raw_gps_timeline[]

Pose

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 gps_source jika pengukuran GPS mentah disediakan di raw_gps_timeline dan Camera Motion Metadata Track (CAMM).

gps_source

GpsSource

Hanya input. Jika raw_gps_timeline dan Camera Motion Metadata Track (CAMM) berisi pengukuran GPS, tentukan pengukuran mana yang lebih diprioritaskan.

imu

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.

processing_state

ProcessingState

Hanya output. Status pemrosesan urutan ini.

failure_reason

ProcessingFailureReason

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

failure_details

ProcessingFailureDetails

Hanya output. Jika urutan ini telah menetapkan failure_reason, detail tambahan tentang kegagalan tersebut dapat disertakan.

distance_meters

double

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

sequence_bounds

LatLngBounds

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

view_count

int64

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

filename

string

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 dalam raw_gps_timeline akan diprioritaskan jika ada.
CAMERA_MOTION_METADATA_TRACK GPS di Trek Metadata Gerakan Kamera (CAMM) akan diprioritaskan jika ada.

PhotoView

Menentukan tampilan Photo yang akan disertakan dalam respons.

Enum
BASIC Respons server tidak menyertakan URL download untuk byte foto. Nilai default.
INCLUDE_DOWNLOAD_URL Respons server mencakup URL download untuk byte foto.

Tempat

Metadata tempat untuk entity.

Kolom
place_id

string

ID tempat, seperti yang dijelaskan di https://developers.google.com/places/place-id.

name

string

Hanya output. Nama tempat, dilokalkan ke language_code.

language_code

string

Hanya output. Language_code yang digunakan untuk melokalkan nama. Ini harus berupa language_code yang ditentukan dalam permintaan, tetapi mungkin merupakan fallback.

Sikap

Pengukuran pose mentah untuk entity.

Kolom
lat_lng_pair

LatLng

Pasangan lintang dan bujur pose, seperti yang dijelaskan di sini: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng Saat membuat Photo, jika pasangan lintang dan bujur tidak diberikan, geolokasi dari header exif akan digunakan. Pasangan lintang dan bujur yang tidak disediakan di header foto atau exif menyebabkan proses foto gagal.

altitude

double

Ketinggian pose dalam meter di atas elipsoid WGS84. NaN menunjukkan kuantitas yang tidak terukur.

heading

double

Parameter pose berikut berkaitan dengan bagian tengah foto. URL tersebut cocok dengan https://developers.google.com/streetview/spherical-metadata. Arah kompas, diukur di bagian tengah foto dalam derajat searah jarum jam dari Utara. Nilai harus >=0 dan <360. NaN menunjukkan kuantitas yang tidak terukur.

pitch

double

Pitch, diukur di bagian tengah foto dalam derajat. Nilai harus >=-90 dan <= 90. Nilai -90 berarti melihat langsung ke bawah, dan nilai 90 berarti melihat langsung ke atas. NaN menunjukkan kuantitas yang tidak terukur.

roll

double

Rol, diukur dalam derajat. Nilai harus >= 0 dan <360. Nilai 0 berarti rata dengan cakrawala. NaN menunjukkan kuantitas yang tidak terukur.

gps_record_timestamp_unix_epoch

Timestamp

Waktu pencatatan GPS sejak epoch UTC.

level

Level

Tingkat (lantai dalam bangunan) yang digunakan untuk mengonfigurasi navigasi vertikal.

accuracy_meters

float

Perkiraan akurasi horizontal pose ini dalam meter dengan keyakinan 68% (satu deviasi standar). Misalnya, di Android, nilai ini tersedia dari metode ini: https://developer.android.com/reference/android/location/Location#getAccuracy(). Platform lain memiliki metode berbeda untuk mendapatkan estimasi akurasi yang serupa.

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.

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

InsufficientGpsFailureDetails

Lihat BasicGpsFailureDetails.

gps_data_gap_details

GpsDataGapFailureDetails

Lihat GpsDataGapFailureDetails.

imu_data_gap_details

ImuDataGapFailureDetails

Lihat ImuDataGapFailureDetails.

not_outdoors_details

NotOutdoorsFailureDetails

Lihat NotOutdoorsFailureDetails.

no_overlap_gps_details

NoOverlapGpsFailureDetails

Lihat NoTumpang-tindihGpsFailureDetails.

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.

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.

UpdatePhotoRequest

Permintaan untuk memperbarui metadata Photo. Memperbarui piksel foto tidak didukung.

Kolom
photo

Photo

Wajib. Objek Photo yang berisi metadata baru.

update_mask

FieldMask

Wajib. Mask yang mengidentifikasi kolom pada metadata foto yang akan diperbarui. Jika tidak ada, metadata Photo lama sepenuhnya akan diganti dengan metadata Photo baru dalam permintaan ini. Update akan gagal jika kolom yang tidak valid ditentukan. Beberapa kolom dapat ditentukan dalam daftar yang dipisahkan koma.

Kolom berikut valid:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

Catatan: Jika updateMask berisi kolom berulang, seluruh kumpulan nilai berulang akan diganti dengan konten baru. Misalnya, jika updateMask berisi connections dan UpdatePhotoRequest.photo.connections kosong, semua koneksi akan dihapus.

UploadRef

Referensi upload untuk file media.

Kolom
Kolom union file_source. Wajib. file_source hanya ada berupa salah satu diantara berikut:
upload_url

string

Referensi upload harus unik untuk setiap pengguna. Video tersebut mengikuti bentuk: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"