REST Resource: photo

Resource: Foto

Foto digunakan untuk menyimpan foto 360 bersama dengan metadata foto.

Representasi JSON
{
  "photoId": {
    object (PhotoId)
  },
  "uploadReference": {
    object (UploadRef)
  },
  "downloadUrl": string,
  "thumbnailUrl": string,
  "shareLink": string,
  "pose": {
    object (Pose)
  },
  "connections": [
    {
      object (Connection)
    }
  ],
  "captureTime": string,
  "uploadTime": string,
  "places": [
    {
      object (Place)
    }
  ],
  "viewCount": string,
  "transferStatus": enum (TransferStatus),
  "mapsPublishStatus": enum (MapsPublishStatus)
}
Kolom
photoId

object (PhotoId)

Wajib diisi. Hanya output. Wajib diisi saat memperbarui foto. Output hanya saat membuat foto. ID untuk foto, yang unik di antara semua foto di Google.

uploadReference

object (UploadRef)

Hanya input. Wajib diisi saat membuat foto. Hanya input. URL resource tempat byte foto diupload.

downloadUrl

string

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

thumbnailUrl

string

Hanya output. URL thumbnail untuk menampilkan pratinjau foto tertentu.

pose

object (Pose)

Opsional. Pose foto.

connections[]

object (Connection)

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

captureTime

string (Timestamp format)

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

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 saat gambar diupload.

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

places[]

object (Place)

Opsional. Tempat foto ini berada.

viewCount

string (int64 format)

Hanya output. Lihat jumlah foto.

transferStatus

enum (TransferStatus)

Hanya output. Status transfer hak pada foto ini.

mapsPublishStatus

enum (MapsPublishStatus)

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

IdFoto

ID untuk Photo.

Representasi JSON
{
  "id": string
}
Kolom
id

string

ID unik untuk foto.

UploadRef

Upload referensi untuk file media.

Representasi JSON
{
  "uploadUrl": string
}
Kolom
uploadUrl

string

Referensi upload harus unik untuk setiap pengguna. Formatnya adalah: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

Pose

Pengukuran pose mentah untuk entitas.

Representasi JSON
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
Kolom
latLngPair

object (LatLng)

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

altitude

number

Ketinggian pose dalam meter di atas elipsoid WGS84. NaN menunjukkan jumlah yang belum diukur.

heading

number

Parameter pose berikut berkaitan dengan bagian tengah foto. Hasil ini cocok dengan https://developers.google.com/streetview/round-metadata. Arah kompas, diukur di tengah foto dalam derajat, searah jarum jam dari Utara. Nilai harus >=0 dan <360. NaN menunjukkan jumlah yang belum diukur.

pitch

number

Presentasi, diukur di 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 jumlah yang belum diukur.

roll

number

Rol, diukur dalam derajat. Nilai harus >= 0 dan <360. Nilai 0 berarti tingkat dengan cakrawala. NaN menunjukkan jumlah yang belum diukur.

gpsRecordTimestampUnixEpoch

string (Timestamp format)

Waktu data GPS sejak epoch UTC.

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

level

object (Level)

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

accuracyMeters

number

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

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan ganda untuk merepresentasikan derajat lintang dan derajat bujur. Kecuali ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.

Representasi JSON
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Nilainya harus dalam rentang [-90.0, +90.0].

longitude

number

Bujur dalam derajat. Nilainya harus dalam rentang [-180.0, +180.0].

Tingkat

Informasi level yang berisi nomor level dan nama yang sesuai.

Representasi JSON
{
  "number": number,
  "name": string
}
Kolom
number

number

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

name

string

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

Koneksi

Koneksi adalah link dari foto sumber ke foto tujuan.

Representasi JSON
{
  "target": {
    object (PhotoId)
  }
}
Kolom
target

object (PhotoId)

Wajib diisi. Tujuan koneksi dari foto yang dimuat ke foto lain.

Tempat

Menempatkan metadata untuk suatu entitas.

Representasi JSON
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
Kolom
placeId

string

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

name

string

Hanya output. Nama tempat, dilokalkan ke languageCode.

languageCode

string

Hanya output. LanguageCode yang dilokalkan dengan nama tersebut. Ini harus berupa languageCode yang ditentukan dalam permintaan, tetapi dapat berupa penggantian.

StatusTransfer

Status transfer hak.

Enumerasi
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 mengambil tindakan apa pun.
CANCELLED Pengirim membatalkan transfer foto ini.
RECEIVED_VIA_TRANSFER Penerima memiliki foto ini karena transfer hak.

StatusPublikasiPublikasiMaps

Status publikasi foto di Google Maps.

Enumerasi
UNSPECIFIED_MAPS_PUBLISH_STATUS Status foto tidak diketahui.
PUBLISHED Foto tersebut dipublikasikan kepada publik melalui Google Maps.
REJECTED_UNKNOWN Foto ditolak karena alasan yang tidak diketahui.

Metode

create

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

delete

Menghapus Photo dan metadatanya.

get

Mendapatkan metadata Photo yang ditentukan.

startUpload

Membuat sesi upload untuk mulai mengupload byte foto.

update

Memperbarui metadata Photo, seperti pose, pengaitan tempat, koneksi, dll.