REST Resource: photo

Resource: Foto

Foto digunakan untuk menyimpan foto 360 beserta 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. Diperlukan saat memperbarui foto. Output hanya saat membuat foto. ID untuk foto, yang unik di antara semua foto di Google.

uploadReference

object (UploadRef)

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

downloadUrl

string

Hanya output. URL download untuk byte foto. Kolom ini hanya ditetapkan ketika 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. Koneksi ke foto lainnya. Foto koneksi menunjukkan link dari foto ini ke foto lain.

captureTime

string (Timestamp format)

Opsional. Waktu absolut saat foto diambil. Jika foto tidak memiliki stempel waktu exif, ini akan digunakan untuk menyetel stempel waktu di 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. Jumlah tampilan foto.

transferStatus

enum (TransferStatus)

Hanya output. Status transfer hak atas foto ini.

mapsPublishStatus

enum (MapsPublishStatus)

Hanya output. Status di Google Maps, baik 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
{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}
Kolom
Kolom union file_source. Wajib diisi. file_source hanya dapat berupa salah satu dari berikut:
uploadUrl

string

Referensi upload untuk setiap pengguna harus unik. Formatnya seperti: "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 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 foto atau header exif menyebabkan proses foto gagal.

altitude

number

Ketinggian pose dalam meter di atas ellipsoid WGS84. NaN menunjukkan jumlah yang tidak terukur.

heading

number

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

pitch

number

Nada, 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 tidak terukur.

roll

number

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

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)

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

accuracyMeters

number

Perkiraan akurasi horizontal dari pose ini dalam meter dengan keyakinan 68% (satu penyimpangan standar). Misalnya, di Android, nilai ini tersedia dari metode ini: https://developer.android.com/reference/android/location/Location#getAkurasi(). Platform lain 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 mewakili 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 tingkat pertama di atas permukaan tanah, -1 menunjukkan tingkat pertama di bawah permukaan tanah. Nilai non-bilangan bulat tidak masalah.

name

string

Wajib diisi. Nama yang ditetapkan untuk Level ini, dibatasi hingga 3 karakter. Pertimbangkan bagaimana label tombol 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 penampung ke foto lain.

Tempat

Menempatkan metadata untuk 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 digunakan untuk melokalkan nama. Ini harus berupa languageCode yang ditentukan dalam permintaan, tetapi dapat berupa penggantian.

Status Transfer

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 akan berakhir sebelum penerima mengambil tindakan.
CANCELLED Pengirim membatalkan transfer foto ini.
RECEIVED_VIA_TRANSFER Penerima memiliki foto ini karena transfer hak.

StatusPublikasi Maps

Status publikasi foto di Google Maps.

Enumerasi
UNSPECIFIED_MAPS_PUBLISH_STATUS Status foto tidak diketahui.
PUBLISHED Foto ini dipublikasikan ke publik melalui Google Maps.
REJECTED_UNKNOWN Foto telah 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 dari Photo yang ditentukan.

startUpload

Membuat sesi upload untuk mulai mengupload byte foto.

update

Memperbarui metadata dari Photo, seperti pose, asosiasi tempat, koneksi, dll.