Permintaan Street View Image adalah URL HTTP dalam format ini:
https://maps.googleapis.com/maps/api/streetview?parameters
Gambar ditetapkan menggunakan parameter permintaan. Sebagaimana standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&). Parameter dan kemungkinan nilainya yang diperbolehkan dicantumkan di bawah ini.
Parameter wajib
Berikut ini opsinya:
location
dapat berupa string teks (sepertiChagrin Falls, OH
) atau pasangan koordinat lintang dan bujur (40.457375,-80.009353
), dan harus dienkode ke URL. Jadi konversikan alamat seperti "City Hall, New York, NY" menjadi "City+Hall,New+York,NY" sebelum Anda mengirimkan permintaan. Street View Static API akan disesuaikan dengan foto panorama yang terdekat dengan lokasi. Saat Anda memberikan string teks alamat, API dapat menggunakan lokasi kamera yang berbeda untuk menampilkan lokasi yang ditentukan dengan lebih baik. Saat Anda memberikan koordinat lintang dan bujur, API akan menelusuri radius 50 meter untuk foto yang terdekat dengan lokasi tersebut. Karena gambar Street View diperbarui secara berkala, dan fotonya mungkin diambil dari posisi yang sedikit berbeda setiap saat, mungkinlocation
Anda beralih ke panorama yang berbeda saat gambar diperbarui.
Atau:
pano
adalah ID panorama tertentu. Panorama dapat berubah ID dari waktu ke waktu, jadi jangan pertahankan ID ini. Sebagai gantinya, simpan alamat lokasi atau koordinat lintang dan bujur sehingga Anda dapat me-refresh ID panorama. Untuk mengetahui detailnya, lihat Memperbarui ID panorama yang dihapus.
Begitu juga:
size
menentukan ukuran output gambar dalam piksel. Ukuran ditentukan sebagai{width}x{height}
- misalnya,size=600x400
menampilkan gambar dengan lebar 600 piksel dan tinggi 400.key
memungkinkan Anda memantau penggunaan API aplikasi di Konsol Google Cloud, dan memastikan Google dapat menghubungi Anda terkait aplikasi Anda jika perlu. Untuk informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.
Muat 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 di-refresh.
Simpan alamat lokasi atau koordinat lintang dan bujur yang Anda gunakan untuk mendapatkan ID panorama sehingga Anda dapat me-refresh saat diperlukan.
Saat mendeteksi bahwa ID panorama telah berubah, gunakan alamat lokasi asal atau koordinat lintang dan bujur untuk menelusuri kembali panorama terdekat dengan lokasi tersebut dan dapatkan 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 gagal. Untuk informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.Catatan: untuk pelanggan Premium Plan Google Maps Platform, tanda tangan digital diperlukan. Dapatkan informasi selengkapnya tentang parameter autentikasi untuk pelanggan Premium Plan.
heading
menunjukkan judul kompas untuk kamera. Nilai yang diterima adalah dari0
hingga360
(kedua nilai menunjukkan Utara, dengan90
yang menunjukkan Timur, dan180
Selatan). Jika Anda tidak menentukan arah tujuan, nilai akan dihitung yang mengarahkan kamera kelocation
yang ditentukan, dari titik pengambilan foto terdekat.fov
(default-nya adalah90
) menentukan ruang pandang horizontal gambar yang dinyatakan dalam derajat, dengan nilai maksimum120
yang diizinkan. Saat menangani area pandang berukuran tetap, seperti pada gambar Street View dengan ukuran tertentu, ruang pandang pada dasarnya mewakili zoom, dengan angka yang lebih kecil menunjukkan tingkat zoom yang lebih tinggi.
(Kiri:fov=120
; Kanan:fov=20
)pitch
(default-nya adalah0
) menentukan sudut naik atau turun kamera relatif terhadap kendaraan Street View. Biasanya, namun tidak selalu, horizontal datar. Nilai positif akan memiringkan kamera ke atas (dengan90
derajat menunjukkan lurus ke atas); nilai negatif akan memiringkan kamera ke bawah (dengan-90
menunjukkan lurus ke bawah).radius
(default-nya adalah50
) menetapkan radius, yang ditetapkan dalam meter, untuk menelusuri panorama, yang berpusat pada lintang dan bujur yang diberikan. Nilai yang valid adalah bilangan bulat non-negatif.return_error_code
menunjukkan apakah API akan menampilkan kode error jika gambar tidak ditemukan (404 TIDAK DITEMUKAN), atau sebagai respons atas permintaan yang 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 melakukan panggilan terpisah untuk memeriksa ketersediaan gambar.source
(default-nya 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. Koleksi dalam ruangan 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 panorama tersebut berada di dalam atau di luar ruangan. Misalnya, PhotoSpheres tidak ditampilkan karena tidak diketahui apakah PhotoSpheres 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 menyediakan gambar Street View, Street View Static API akan menampilkan gambar generik berwarna abu-abu, dengan teks "Maaf, kami tidak memiliki gambar di sini.", seperti ditunjukkan dalam contoh berikut:
Hanya tampilkan gambar yang valid
Untuk menghindari tampilan gambar generik, dan memastikan bahwa halaman web Anda hanya menampilkan gambar Street View Static API yang valid, ikuti saran berikut:
- Setel parameter
return_error_code
ketrue
. Hal ini menyebabkan Street View Static API menampilkan error 404 TIDAK DITEMUKAN sebagai pengganti gambar abu-abu generik, jika tidak ada gambar yang tersedia untuk lokasi yang ditentukan. - Minta metadata gambar Street View untuk menentukan apakah ada gambar yang tersedia untuk lokasi tertentu sebelum mengirim permintaan.