Pengantar
Permintaan metadata Street View Static API menyediakan data tentang Street View Melihat panorama. Dengan menggunakan metadata, Anda dapat mengetahui apakah suatu gambar Street View tersedia di lokasi tertentu, serta mendapatkan akses terprogram ke koordinat lintang dan bujur, ID panorama, tanggal pengambilan foto dan informasi hak cipta untuk gambar tersebut. Mengakses ini memungkinkan Anda menyesuaikan perilaku error dalam aplikasi.
Permintaan metadata Street View Static API tersedia tanpa besar. Kuota tidak dikonsumsi jika Anda meminta metadata. Kuota hanya terpakai saat Anda memuat gambar menggunakan Street View Static API.
Saat membuat permintaan metadata gambar Street View, gambar panorama adalah 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
Sesuai dengan standar dalam URL, semua parameter dipisah menggunakan tanda ampersan karakter (&).
Parameter wajib untuk permintaan metadata
Permintaan metadata menerima parameter URL yang sama sebagai permintaan gambar Street View Static API, meskipun hanya parameter berikut wajib ditentukan:
Yakni:
location
— dapat berupa string teks (sepertiChagrin Falls, OH
) atau pasangan koordinat lintang dan bujur yang dipisahkan koma (40.457375,-80.009353
).
Atau:
pano
— ID panorama tertentu. Panorama dapat berubah ID seiring waktu, jadi tidak mempertahankan ID ini. Sebagai gantinya, simpan alamat lokasi atau koordinat lintang dan bujur sehingga Anda dapat menyegarkan ID panorama. Sebagai lihat detailnya, lihat Memuat ulang ID panorama yang dihapus.
Begitu juga:
key
dansignature
— kunci API diperlukan untuk mengautentikasi permintaan. Tanda tangan digital juga diperlukan dalam kasus tertentu, dan selalu direkomendasikan. Untuk informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.
Permintaan metadata Anda, dengan hanya 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, berarti ID panorama telah dihapus dan perlu dimuat ulang.
Simpan alamat lokasi atau koordinat lintang dan bujur yang Anda gunakan sebelumnya mendapatkan ID panorama sehingga Anda dapat memperbaruinya saat dibutuhkan.
Saat Anda mendeteksi bahwa ID panorama telah berubah, gunakan lokasi asli alamat atau koordinat lintang dan bujur untuk menelusuri kembali panorama ke lokasi itu dan mendapatkan ID panorama baru.
Parameter opsional untuk permintaan metadata
Anda dapat menyertakan parameter berikut dalam permintaan metadata: size
,
heading
, fov
, dan pitch
. Perhatikan, parameter ini
tidak memengaruhi
data tentang panorama, atau panorama mana yang ditemukan.
API memungkinkan penyertaan parameter yang sama dengan
permintaan gambar
untuk memudahkan pembuatan permintaan {i>metadata <i}
yang terkait dengan gambar tertentu
tetapi untuk permintaan metadata, API mengabaikan parameter opsional dan
nilai-nilai mereka. Untuk informasi tentang penggunaan parameter ini, lihat referensi
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 yang sama panorama.
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 yang seharusnya adalah gambar yang hilang.
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 2: Panorama tidak ditemukan
URL berikut meminta metadata dan gambar untuk panorama yang tidak dapat ditemukan pada atau dekat dengan 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
Kode status
Kolom status
dalam objek respons metadata berisi status
permintaan, dan mungkin berisi informasi {i>debugging<i}
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; sebuah panorama ditemukan dan {i>metadata <i}dapat dikembalikan. |
"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 disediakan di location
parameter tidak dapat ditemukan. Pesan ini dapat muncul jika alamat tidak ada
diberikan. |
"OVER_QUERY_LIMIT" |
Menunjukkan bahwa Anda telah melampaui kuota harian atau kuota per detik untuk API ini. |
"REQUEST_DENIED" |
Menunjukkan permintaan Anda ditolak. Pesan ini dapat muncul jika Anda melakukannya tidak mengizinkan permintaan Anda, atau jika Street View Static API tidak diaktifkan di Project Konsol Google Cloud yang berisi kunci API Anda. |
"INVALID_REQUEST" |
Secara umum 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 memeriksa API Maps Halaman dukungan.