Pengantar
Permintaan metadata Street View Static API menyediakan data tentang panorama Street View. Dengan menggunakan metadata, Anda dapat mengetahui apakah gambar Street View tersedia di lokasi tertentu, serta mendapatkan akses terprogram ke lintang dan bujur, ID panorama, tanggal pengambilan foto, dan informasi hak cipta untuk gambar tersebut. Dengan mengakses metadata ini, Anda dapat menyesuaikan perilaku error dalam aplikasi.
Permintaan metadata Street View Static API tersedia tanpa biaya. Kuota tidak dikonsumsi jika Anda meminta metadata. Kuota hanya dipakai jika 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
Sebagaimana standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&).
Parameter yang diperlukan untuk permintaan metadata
Permintaan metadata menerima parameter URL yang sama dengan permintaan gambar Street View Static API, meskipun hanya parameter berikut yang diperlukan:
Berikut ini opsinya:
location
— dapat berupa string teks (sepertiChagrin Falls, OH
) atau sepasang koordinat lintang/bujur (40.457375,-80.009353
) yang dipisahkan koma.
Atau:
pano
— ID panorama tertentu. Biasanya ini stabil, meskipun panorama dapat berubah ID dari waktu ke waktu seiring gambar diperbarui.
Begitu juga:
key
dansignature
— kunci API diperlukan untuk mengautentikasi permintaan. Tanda tangan digital juga diperlukan dalam instance tertentu, dan selalu direkomendasikan. Untuk informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.
Permintaan metadata Anda, yang hanya berisi parameter yang diperlukan, akan terlihat seperti ini:
https://maps.googleapis.com/maps/api/streetview/metadata?location=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
atau seperti ini:
https://maps.googleapis.com/maps/api/streetview/metadata?pano=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
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 mempermudah
pembuatan permintaan metadata yang terkait dengan permintaan gambar tertentu. Namun, untuk
permintaan metadata, API mengabaikan parameter opsional dan nilainya.
Lihat panduan developer Street View Static API
untuk informasi tentang
penggunaan parameter ini.
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, yang seharusnya tidak menampilkan gambar.
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 lokasi yang ditentukan.
Respons dan permintaan 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"
}
Respons dan permintaan 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 proses debug untuk membantu Anda memecahkan masalah yang menyebabkan permintaan
Street View tidak berfungsi. Kolom status
dapat berisi nilai berikut:
Status | Deskripsi |
---|---|
"OK" |
Menunjukkan tidak terjadi kesalahan; sebuah panorama ditemukan dan metadata dikembalikan. |
"ZERO_RESULTS" |
Menunjukkan panorama tidak ditemukan di dekat lokasi yang disediakan. Hal ini dapat terjadi jika ID panorama yang tidak ada atau tidak valid diberikan. |
"NOT_FOUND" |
Menunjukkan bahwa string alamat yang diberikan dalam parameter location
tidak dapat ditemukan. Ini bisa terjadi jika alamat yang 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. Hal ini dapat terjadi jika Anda tidak mengizinkan permintaan Anda, atau jika Street View Static API tidak diaktifkan di project Google Cloud Console yang berisi kunci API Anda. |
"INVALID_REQUEST" |
Secara umum menunjukkan bahwa parameter kueri (alamat atau latlng atau komponen) tidak ada. |
"UNKNOWN_ERROR" |
Menunjukkan permintaan tidak bisa diproses karena kesalahan server. Hal ini sering kali merupakan status sementara. Permintaan mungkin berhasil jika Anda mencoba lagi. |
Informasi selengkapnya
Untuk informasi selengkapnya tentang penggunaan Street View Static API, atau produk Google Maps API lainnya, pastikan untuk melihat halaman Dukungan Maps API.