Metadata Gambar Street View

Pengantar

Permintaan metadata Street View Static API memberikan data tentang panorama Street View. Dengan menggunakan metadata, Anda dapat mengetahui apakah gambar Street View tersedia di lokasi tertentu, serta mendapatkan akses terprogram ke koordinat lintang dan bujur, ID panorama, tanggal foto diambil, dan informasi hak cipta untuk gambar. Dengan mengakses metadata ini, Anda dapat menyesuaikan perilaku error di aplikasi.

Catatan: Nilai kolom tanggal dapat bervariasi:

• Kolom tanggal dapat memiliki tingkat perincian yang berbeda untuk panorama yang berbeda. Misalnya, kolom tanggal untuk beberapa panorama berisi tahun dan bulan, sedangkan untuk panorama lainnya hanya berisi tahun.
• Kolom tanggal dihilangkan jika tidak ada data yang tersedia.

Permintaan metadata Street View Static API tersedia tanpa biaya. Kuota tidak dikonsumsi jika Anda meminta metadata. Kuota hanya digunakan saat Anda memuat gambar menggunakan Street View Static API.

Saat membuat permintaan metadata gambar Street View, gambar panorama akurat hingga 50 meter.

Mengakses metadata gambar

Permintaan metadata gambar Street View adalah HTTP URL dengan bentuk berikut:

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

Catatan: protokol https:// diperlukan untuk permintaan metadata.

Sesuai dengan standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&).

Parameter yang diperlukan untuk permintaan metadata

Permintaan metadata menerima parameter URL yang sama seperti permintaan gambar Street View Static API, meskipun hanya parameter berikut yang diperlukan:

Yakni:

• location — dapat berupa string teks (seperti Chagrin Falls, OH) atau sepasang koordinat lintang dan bujur yang dipisahkan koma (40.457375,-80.009353).

Atau:

• pano — ID panorama tertentu. Panorama dapat mengubah ID dari waktu ke waktu, jadi jangan pertahankan ID ini. Sebagai gantinya, simpan alamat lokasi atau koordinat lintang dan bujur agar Anda dapat memuat ulang ID panorama. Untuk mengetahui detailnya, lihat Memuat ulang ID panorama yang dihapus.

Begitu juga:

• key dan signature — kunci API diperlukan untuk mengautentikasi permintaan. Tanda tangan digital juga diperlukan dalam kasus tertentu, dan selalu direkomendasikan. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.

Permintaan metadata Anda, hanya dengan parameter yang diperlukan, akan terlihat seperti ini:

https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

atau seperti ini:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

Memuat ulang ID panorama yang dihapus

Jika Anda mencoba mengambil ID panorama dan mendapatkan ZERO_RESULTS atau tidak ada nilai, ID panorama telah dihapus dan perlu dimuat ulang.

1. Simpan alamat lokasi atau koordinat lintang dan bujur yang Anda gunakan untuk mendapatkan ID panorama sehingga Anda dapat memuat ulang jika diperlukan.

2. Jika Anda mendeteksi bahwa ID panorama telah berubah, gunakan alamat lokasi asli atau koordinat lintang dan bujur untuk menelusuri kembali panorama terdekat ke lokasi tersebut dan mendapatkan ID panorama baru.

Catatan: Karena gambar Street View diperbarui secara berkala, dan foto dapat diambil dari posisi yang sedikit berbeda setiap kali, ID panorama tertentu dapat beralih ke panorama yang berbeda saat gambar atau ID panorama diperbarui.

Parameter opsional untuk permintaan metadata

Anda dapat menyertakan parameter berikut dalam permintaan metadata: size, heading, fov, dan pitch. Perhatikan bahwa parameter ini tidak memengaruhi data tentang panorama, atau panorama mana yang ditemukan. API memungkinkan penyertaan parameter yang sama dengan permintaan gambar untuk mempermudah pembuatan permintaan metadata yang terkait dengan permintaan gambar tertentu, tetapi untuk permintaan metadata, API mengabaikan parameter opsional dan nilainya. Untuk informasi tentang cara menggunakan parameter ini, lihat panduan developer Street View Static API.

Format respons

Respons metadata dikembalikan hanya dalam format JSON.

Contoh

Contoh 1: Panorama ditemukan

URL berikut berhasil meminta metadata dan gambar panorama yang sama.

Respons dan permintaan metadata

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

Permintaan dan respons gambar, tempat gambar yang tidak ada diharapkan.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Contoh mungkin tidak tersedia di wilayah Anda.

Contoh 2: Panorama tidak ditemukan

URL berikut meminta metadata dan gambar untuk panorama yang tidak dapat ditemukan di atau di dekat lokasi yang ditentukan.

Permintaan dan respons metadata

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "status" : "ZERO_RESULTS"
}

Permintaan dan respons gambar

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Contoh mungkin tidak tersedia di wilayah Anda.

Kode status

Kolom status dalam objek respons metadata berisi status permintaan, dan mungkin berisi informasi proses debug untuk membantu Anda memecahkan masalah penyebab permintaan Street View tidak berfungsi. Kolom status dapat berisi nilai berikut:

Status	Deskripsi
"OK"	Menunjukkan bahwa tidak terjadi error; panorama ditemukan dan metadata ditampilkan.
"ZERO_RESULTS"	Menunjukkan panorama tidak ditemukan di dekat lokasi yang disediakan. Respons ini dapat terjadi jika Anda memberikan ID panorama yang tidak ada atau tidak valid. Lihat [Memuat ulang ID panorama yang dihapus](#refresh-pano).
"NOT_FOUND"	Menunjukkan bahwa string alamat yang diberikan dalam parameter location tidak dapat ditemukan. Pesan ini dapat muncul jika alamat yang diberikan tidak ada.
"OVER_QUERY_LIMIT"	Menunjukkan bahwa Anda telah melebihi kuota harian atau kuota per detik untuk API ini.
"REQUEST_DENIED"	Menunjukkan permintaan Anda ditolak. Pesan ini dapat muncul jika Anda tidak memberi otorisasi permintaan, atau jika Street View Static API tidak diaktifkan di project konsol Google Cloud yang berisi kunci API Anda.
"INVALID_REQUEST"	Umumnya menunjukkan bahwa parameter kueri (alamat, koordinat lintang dan bujur, atau komponen) tidak ada.
"UNKNOWN_ERROR"	Menunjukkan bahwa permintaan tidak dapat diproses karena error server. Masalah ini sering kali bersifat sementara. Permintaan mungkin berhasil jika Anda mencoba lagi.

Informasi selengkapnya

Untuk informasi selengkapnya tentang cara menggunakan Street View Static API, atau produk Google Maps API lainnya, pastikan untuk melihat halaman Dukungan Maps API.