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

Input saja. Wajib diisi saat membuat foto. Input saja. 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 tertentu.

pose

object (Pose)

Opsional. Pose foto.

connections[]

object (Connection)

Opsional. Koneksi 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 digunakan untuk menyetel stempel waktu dalam metadata foto.

Stempel waktu dalam 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 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 pada 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. Ini mengikuti bentuk: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

Sikap

Pengukuran pose mentah untuk entity.

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

number

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

heading

number

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

number

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

number

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

gpsRecordTimestampUnixEpoch

string (Timestamp format)

Waktu data GPS sejak epoch UTC.

Stempel waktu dalam 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 di bangunan) yang digunakan untuk mengonfigurasi navigasi vertikal.

accuracyMeters

number

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.

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double 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 terkaitnya.

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

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 memuatnya ke foto lain.

Tempat

Metadata tempat untuk entity.

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. Bahasa ini harus berupa languageCode yang ditentukan dalam permintaan, tetapi mungkin merupakan penggantian.

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.

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.

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.