Permintaan Gambar Street View adalah URL HTTP dalam format ini:
https://maps.googleapis.com/maps/api/streetview?parameters
Gambar ditetapkan menggunakan parameter permintaan. Sesuai dengan standar pada URL, semua parameter dipisah menggunakan karakter ampersand (&). Parameter dan kemungkinan nilainya yang diperbolehkan dicantumkan di bawah ini.
Parameter wajib
Yakni:
location
dapat berupa string teks (sepertiChagrin Falls, OH
) atau pasangan koordinat lintang dan bujur (40.457375,-80.009353
), dan harus dienkode ke URL. Jadi konversi alamat seperti "City Hall, New York, NY" ke "City+Hall,New+York,NY" sebelum Anda mengirim permintaan. Street View Static API menempel ke foto panorama yang terdekat dengan lokasinya. Jika Anda memberikan string teks alamat, API dapat menggunakan lokasi kamera yang berbeda untuk menampilkan lokasi yang ditentukan dengan lebih baik. Jika Anda memberikan koordinat lintang dan bujur, API mencari foto yang terdekat dengan lokasi dalam radius 50 meter. Karena gambar Street View diperbarui secara berkala, dan foto dapat diambil dari posisi yang sedikit berbeda, ada kemungkinanlocation
Anda dapat dipaskan ke panorama yang berbeda saat gambar diperbarui.
Atau:
pano
adalah ID panorama tertentu. Panorama dapat berubah ID dari waktu ke 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:
size
menentukan ukuran output gambar dalam piksel. Ukuran ditentukan sebagai{width}x{height}
- misalnya,size=600x400
menghasilkan gambar dengan lebar 600 x 400 piksel.key
memungkinkan Anda memantau penggunaan API aplikasi di Konsol Google Cloud, serta memastikan bahwa Google dapat menghubungi Anda tentang aplikasi jika diperlukan. Untuk informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.
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
signature
(direkomendasikan) adalah tanda tangan digital yang digunakan untuk memverifikasi bahwa situs yang membuat permintaan menggunakan kunci API Anda telah diberi otorisasi untuk melakukannya. Permintaan yang tidak menyertakan tanda tangan digital mungkin akan gagal. Untuk informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.Catatan: untuk mantan pelanggan Paket Premium Google Maps Platform, paket digital tanda tangan wajib diisi. Dapatkan informasi selengkapnya tentang parameter autentikasi untuk Pelanggan Paket Premium.
heading
menunjukkan arah kompas dari kamera. Nilai yang diterima adalah dari0
hingga360
(kedua nilai menunjukkan Utara, dengan90
menunjukkan Timur, dan180
Selatan). Jika Anda tidak menentukan judul, nilai akan dihitung yang mengarahkan kamera ke titik tertentulocation
, dari titik yang terdekat dengan foto yang diambil.fov
(defaultnya adalah90
) menentukan ruang pandang horizontal gambar yang dinyatakan dalam derajat, dengan nilai maksimum yang diizinkan sebesar120
. Saat menangani area pandang berukuran tetap, seperti pada gambar Street View mengatur ukuran, ruang pandang pada dasarnya mewakili zoom, dengan angka yang lebih kecil yang menunjukkan tingkat zoom yang lebih tinggi.
(Kiri:fov=120
; Kanan:fov=20
)pitch
(defaultnya adalah0
) menentukan sudut atas atau bawah kamera relatif terhadap Street View saat ini. Biasanya, namun tidak selalu, horizontal datar. Nilai positif miringkan kamera ke atas (dengan90
derajat yang menunjukkan lurus ke atas); nilai negatif akan menurunkan sudut kamera (dengan-90
menunjukkan ke bawah).radius
(defaultnya adalah50
) menetapkan radius, yang ditentukan dalam meter, untuk mencari panorama, yang berpusat pada lintang dan bujur yang diberikan. Nilai yang valid adalah non-negatif bilangan bulat.return_error_code
menunjukkan apakah API harus ditampilkan kode error ketika tidak ada gambar yang ditemukan (404 TIDAK DITEMUKAN), atau sebagai respons terhadap permintaan tidak valid (400 BAD REQUEST). Nilai yang valid adalahtrue
danfalse
. Jika ditetapkan ketrue
, pesan error akan ditampilkan sebagai pengganti gambar abu-abu generik. Dengan demikian, Anda tidak perlu lakukan panggilan terpisah untuk memeriksa ketersediaan gambar.source
(defaultnya adalahdefault
) membatasi penelusuran Street View ke sumber yang dipilih. Nilai yang valid adalah:default
menggunakan sumber default untuk Street View; penelusuran tidak terbatas pada sumber tertentu.outdoor
membatasi penelusuran ke koleksi luar ruangan. Dalam ruangan koleksi tidak disertakan dalam hasil penelusuran. Perhatikan bahwa panorama luar ruangan mungkin tidak ada untuk lokasi yang ditentukan. Perhatikan juga bahwa penelusuran hanya menampilkan panorama yang memungkinkan untuk menentukan apakah mereka berada di dalam atau di luar ruangan. Misalnya, PhotoSpheres tidak ditampilkan karena tidak diketahui apakah berada di dalam atau di luar ruangan.
Ini adalah contoh permintaan.
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Gambar tidak tersedia
Untuk lokasi yang tidak memiliki gambar Street View, Street View Static API mengembalikan gambar generik berwarna abu-abu, dengan teks "Maaf, kami tidak memiliki gambar di sini.", seperti yang ditunjukkan dalam contoh ini:
Hanya tampilkan gambar yang valid
Untuk menghindari tampilan gambar generik, dan pastikan halaman web Anda hanya menampilkan gambar Street View Static API yang valid, ikuti petunjuk berikut saran:
- Setel parameter
return_error_code
ketrue
. Hal ini menyebabkan Street View Static API menampilkan 404 NOT FOUND sebagai pengganti gambar abu-abu generik, jika tidak ada gambar yang tersedia untuk lokasi yang ditentukan. - Meminta Metadata gambar Street View untuk mengetahui apakah gambar tersedia untuk lokasi yang ditentukan sebelumnya hingga mengirim permintaan.