REST Resource: photo

Resource: Photo

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. Hanya output. Diperlukan saat memperbarui foto. Hanya ditampilkan 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 jika GetPhotoRequest.view ditetapkan ke PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnailUrl

string

Hanya output. URL thumbnail untuk menampilkan pratinjau foto yang diberikan.
pose

object (Pose)

Opsional. Pose foto.
connections[]

object (Connection)

Opsional. Koneksi ke foto lain. Koneksi merepresentasikan 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 digunakan untuk menetapkan stempel waktu di metadata foto.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
uploadTime

string (Timestamp format)

Hanya output. Waktu saat gambar diupload.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
places[]

object (Place)

Opsional. Tempat foto ini berada.
viewCount

string (int64 format)

Hanya output. Jumlah penayangan foto.
transferStatus

enum (TransferStatus)

Hanya output. Status transfer hak atas foto ini.
mapsPublishStatus

enum (MapsPublishStatus)

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

PhotoId

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. file_source hanya dapat berupa salah satu dari berikut:
uploadUrl

string

Referensi upload harus unik untuk setiap pengguna. URL ini mengikuti format: "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 diberikan, geolokasi dari header exif akan digunakan. Pasangan garis lintang dan bujur yang tidak disediakan di foto atau header exif menyebabkan proses foto gagal.
altitude

number

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

number

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

number

Kemiringan, 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 kuantitas yang tidak terukur.
roll

number

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

string (Timestamp format)

Waktu rekaman GPS sejak epoch UTC.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
level

object (Level)

Tingkat (lantai di dalam gedung) yang digunakan untuk mengonfigurasi navigasi vertikal.
accuracyMeters

number

Estimasi akurasi horizontal pose ini dalam meter dengan keyakinan 68% (satu standar deviasi). 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 serupa.

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Ini dinyatakan sebagai pasangan nilai ganda untuk mewakili derajat lintang dan derajat bujur. Kecuali jika 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. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. 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 pengurutan. 0 menunjukkan tingkat permukaan tanah, 1 menunjukkan tingkat pertama di atas permukaan tanah, -1 menunjukkan tingkat pertama di bawah permukaan tanah. Nilai non-bilangan bulat diperbolehkan.
name

string

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

Koneksi

Koneksi adalah link dari foto sumber ke foto tujuan.

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

object (PhotoId)

Wajib. Tujuan koneksi dari foto yang berisi ke foto lain.

Tempat

Tempatkan metadata untuk entitas.

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

string

ID tempat, seperti yang dijelaskan di 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 mungkin merupakan penggantian.

TransferStatus

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

MapsPublishStatus

Status publikasi foto di Google Maps.

Enum
UNSPECIFIED_MAPS_PUBLISH_STATUS Status foto tidak diketahui.
PUBLISHED Foto dipublikasikan kepada 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 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, asosiasi tempat, koneksi, dll.