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, salah satu kolom penting tidak ada atau terjadi error autentikasi. Meskipun BatchDeletePhotos berhasil, setiap foto dalam batch mungkin gagal. Kegagalan ini ditetapkan dalam setiap PhotoResponse.status di BatchDeletePhotosResponse.results. Lihat DeletePhoto untuk mengetahui kegagalan tertentu yang dapat terjadi per foto.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

Mendapatkan metadata dari batch Photo yang ditentukan.

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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, koneksi, dll. Mengubah piksel foto tidak didukung.

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

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

Jumlah UpdatePhotoRequest pesan di dalam BatchUpdatePhotosRequest tidak boleh lebih dari 20.

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

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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 akan memublikasikan Photo yang diupload ke Street View di Google Maps.

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

Metode ini akan menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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 yang ditetapkan di kolom Operation.name.

Metode ini akan menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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 akan menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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 akan menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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 akan menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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 = salah, jika pemrosesan PhotoSequence belum selesai.
  • Operation.done = benar (true) dan Operation.error diisi, jika terjadi error dalam pemrosesan.
  • Operation.done = benar dan Operation.response ditentukan, yang berisi pesan PhotoSequence.

Metode ini akan menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

  • 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 saja dibuat dan masih diindeks tidak ditampilkan dalam respons.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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 dari 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:

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

  • 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, koneksi, dll. Mengubah piksel foto tidak didukung.

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

Metode ini akan menampilkan kode error berikut:

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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 terhadap penghapusan batch satu atau beberapa Photos.

Kolom
status[]

Status

Status operasi untuk menghapus satu Photo dalam permintaan batch.

BatchGetPhotosRequest

Permintaan 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 GET HTTP, parameter kueri URL harus photoIds=<id1>&photoIds=<id2>&....

view

PhotoView

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

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 batch get Photos.

Kolom
results[]

PhotoResponse

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

BatchUpdatePhotosRequest

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

Kolom
update_photo_requests[]

UpdatePhotoRequest

Wajib. Daftar UpdatePhotoRequests.

BatchUpdatePhotosResponse

Respons terhadap update batch metadata untuk satu atau beberapa Photos.

Kolom
results[]

PhotoResponse

Daftar hasil untuk setiap Photo yang 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 yang memuatnya ke foto lain.

CreatePhotoRequest

Permintaan untuk membuat Photo.

Kolom
photo

Photo

Wajib. Foto untuk dibuat.

CreatePhotoSequenceRequest

Permintaan untuk membuat PhotoSequence dari video.

Kolom
photo_sequence

PhotoSequence

Wajib. PhotoSequence untuk membuat.

input_type

InputType

Wajib. Bentuk input PhotoSequence.

InputType

Bentuk input PhotoSequence.

Enum
INPUT_TYPE_UNSPECIFIED Tidak ditentukan. Server akan menampilkan google.rpc.Code.INVALID_ARGUMENT.
VIDEO Video 360.
XDM Extensible Device Metadata, 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 tidak diterapkan.

filter

string

Opsional. Ekspresi filter. Misalnya: published_status=PUBLISHED.

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

GpsDataGapFailureDetails

Detail terkait ProcessingFailureAlasan#GPS_DATA_GAP. Jika ada beberapa kesenjangan data GPS, hanya kesenjangan 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

Akselerometer mengukur 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 peningkatan 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 dalam sumbu y.

z

float

Pengukuran sensor dalam sumbu z.

ImuDataGapFailureDetails

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

Kolom
gap_duration

Duration

Durasi celah dalam data IMU yang ditemukan.

gap_start_time

Duration

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

InsufficientGpsFailureDetails

Detail terkait ProcessingFailureAlasan#INSUFFICIENT_GPS.

Kolom
gps_points_found

int32

Jumlah titik GPS yang ditemukan di video.

LatLngBounds

Persegi panjang dalam koordinat geografis.

Kolom
southwest

LatLng

Sudut barat daya dari batas tersebut.

northeast

LatLng

Sudut timur laut batas tersebut.

Tingkat

Informasi level yang berisi nomor level dan nama yang sesuai.

Kolom
number

double

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

name

string

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

ListPhotoSequencesRequest

Permintaan untuk mencantumkan semua urutan foto milik pengguna yang mengirimkan 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 harus positif. Jika pageSize adalah 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 tidak 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 mengetahui informasi selengkapnya. Kueri nama file harus dikirim sebagai Frasa untuk mendukung beberapa kata dan karakter khusus dengan menambahkan tanda petik. 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 = salah, jika pemrosesan PhotoSequence belum selesai.
  • Operation.done = benar (true) dan Operation.error diisi, jika terjadi error dalam 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 mengirimkan permintaan.

Secara default

  • tidak menampilkan URL download untuk byte foto.

Parameter:

  • view mengontrol apakah URL download untuk byte foto ditampilkan.
  • pageSize menentukan jumlah maksimum foto yang akan ditampilkan.
  • pageToken adalah nilai token halaman berikutnya yang ditampilkan dari permintaan ListPhotos sebelumnya, jika ada.
  • filter memungkinkan pemfilteran berdasarkan parameter tertentu. 'IDtempat' 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 ditampilkan. pageSize harus positif. Jika pageSize adalah 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 mengetahui 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 mencantumkan 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 terkait PhotoSequenceProcessingFailureAlasan#NO_OVERLAP_GPS.

Kolom
gps_start_time

Timestamp

Waktu titik GPS pertama yang 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 ProcessingFailureAlasan#NOT_OUTDOORS. Jika ada beberapa bingkai dalam ruangan, frame pertama akan 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. Wajib diisi saat memperbarui foto. Output hanya saat membuat foto. ID untuk foto, yang unik di antara semua foto di Google.

upload_reference

UploadRef

Input saja. Wajib diisi saat membuat foto. Input saja. 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, stempel waktu ini 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 pada 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 tersebut 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 kepada penerima.
REJECTED Penerima menolak transfer foto ini.
EXPIRED Masa berlaku transfer foto akan habis sebelum penerima melakukan tindakan apa pun.
CANCELLED Pengirim membatalkan transfer foto ini.
RECEIVED_VIA_TRANSFER Penerima memiliki foto ini karena terjadi 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 bertambah.

upload_reference

UploadRef

Input saja. Wajib diisi 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

Input saja. Pengukuran GPS mentah dengan peningkatan stempel waktu dari perangkat yang tidak disinkronkan dengan setiap foto sesuai waktu. Pengukuran mentah ini akan digunakan untuk menyimpulkan pose setiap frame. Wajib dalam input jika InputType adalah VIDEO dan pengukuran GPS mentah tidak dalam Trek Metadata Gerakan Kamera (CAMM). Pengguna dapat menunjukkan mana yang diprioritaskan menggunakan gps_source jika pengukuran GPS mentah disediakan dalam raw_gps_timeline dan Camera Motion Metadata Track (CAMM).

gps_source

GpsSource

Input saja. Jika raw_gps_timeline dan Camera Motion Metadata Track (CAMM) berisi pengukuran GPS, tentukan mana yang akan diprioritaskan.

imu

Imu

Input saja. Data IMU tiga sumbu untuk koleksi. Jika data ini terlalu besar untuk dimasukkan ke dalam permintaan, data tersebut harus ditempatkan di trek CAMM untuk video. Data ini selalu 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, ini akan berisi alasan kegagalannya. Jika processing_state adalah nilai lain, kolom ini akan dibatalkan penetapannya.

failure_details

ProcessingFailureDetails

Hanya output. Jika urutan ini telah menetapkan failure_reason, bagian ini dapat berisi detail tambahan tentang kegagalan.

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 pada platform yang menyediakan nama file.

GpsSource

Sumber utama pengukuran GPS.

Enum
PHOTO_SEQUENCE GPS di 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 menyertakan 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 penggantian.

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 garis lintang dan bujur tidak diberikan, geolokasi dari header exif akan digunakan. Pasangan lintang dan bujur yang tidak diberikan dalam header foto atau exif menyebabkan proses foto gagal.

altitude

double

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

heading

double

Parameter pose berikut berkaitan dengan bagian tengah foto. Semuanya 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 diukur.

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 diukur.

roll

double

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

gps_record_timestamp_unix_epoch

Timestamp

Waktu data GPS sejak epoch UTC.

level

Level

Tingkat (lantai pada 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 yang berbeda untuk memperoleh estimasi akurasi yang serupa.

ProcessingFailureDetails

Detail tambahan untuk menyertai enum ProcessingFailureAlasan. Pesan ini diharapkan selalu digunakan bersamaan dengan ProcessingFailureAlasan, dan salah satu nilai yang ditetapkan dalam pesan ini harus cocok dengan FailureAlasan.

Kolom
Kolom union details. Hanya satu kumpulan detail yang akan ditetapkan, dan harus cocok dengan enum yang sesuai di ProcessingFailureAlasan. details hanya dapat berupa salah satu dari berikut:
insufficient_gps_details

InsufficientGpsFailureDetails

Lihat Tidak MemadaiGpsFailureDetails.

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 NoOverlapGpsFailureDetails.

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 trek 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 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 waktu yang akan datang.
GPS_DATA_GAP Data GPS berisi jeda lebih dari 5 detik.
JUMPY_GPS Data GPS terlalu tidak menentu untuk diproses.
INVALID_IMU Data IMU (Akselerometer, Giroskop, dll.) tidak valid. Kolom tersebut mungkin tidak memiliki kolom yang wajib diisi (x, y, z, atau waktu), tidak diformat dengan benar, atau ada 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 celah dengan durasi lebih dari 0,1 detik.
UNSUPPORTED_CAMERA Kamera tidak didukung.
NOT_OUTDOORS Beberapa bingkai berada di dalam ruangan, dan ini tidak didukung.
INSUFFICIENT_VIDEO_FRAMES Frame video tidak cukup.
INSUFFICIENT_MOVEMENT Data pemindahan tidak cukup.

ProcessingState

Status pemrosesan urutan. Status tersebut bergerak sebagai berikut:

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

Urutan dapat berpindah ke FAILED dari keadaan 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 saat ini sedang diproses.
PROCESSED Urutan telah selesai diproses termasuk posisi penyempurnaan.
FAILED Urutan gagal diproses. Lihat FailureAlasan untuk mengetahui 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 akan sepenuhnya diganti dengan metadata Photo yang baru dalam permintaan ini. Update 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

Upload referensi untuk file media.

Kolom
Kolom union file_source. Wajib. file_source hanya dapat berupa salah satu dari berikut:
upload_url

string

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