Permintaan dan respons Street View

Developer Wilayah Ekonomi Eropa (EEA)

Jika alamat penagihan Anda berada di Wilayah Ekonomi Eropa, mulai 8 Juli 2025, Persyaratan Layanan Google Maps Platform EEA akan berlaku untuk penggunaan Layanan oleh Anda. Fungsi bervariasi menurut wilayah. Pelajari lebih lanjut.

Permintaan Gambar Street View 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 yang diperlukan

Yakni:

• location dapat berupa string teks (seperti Chagrin 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 mengirim permintaan. Street View Static API akan menyesuaikan ke foto panorama yang paling dekat 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 menemukan foto yang paling dekat dengan lokasi. Karena gambar Street View diperbarui secara berkala, dan foto dapat diambil dari posisi yang sedikit berbeda setiap kali, location Anda mungkin akan diposisikan ke panorama yang berbeda saat gambar diperbarui.

Atau:

• pano adalah ID panorama tertentu. Panorama dapat berubah ID seiring waktu, jadi jangan mempertahankan ID ini. Sebagai gantinya, simpan alamat lokasi atau koordinat lintang dan bujur agar Anda dapat memuat ulang 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 piksel.
• key memungkinkan Anda memantau penggunaan API aplikasi di Konsol Google Cloud, dan memastikan bahwa Google dapat menghubungi Anda terkait aplikasi Anda jika diperlukan. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.

Memperbarui 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.

1. Simpan alamat lokasi atau koordinat lintang dan bujur yang Anda gunakan untuk mendapatkan ID panorama agar Anda dapat memuat ulang saat 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 diposisikan ke panorama yang berbeda saat gambar atau ID panorama diperbarui.

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 mengetahui informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.

  Catatan: untuk mantan pelanggan Paket Premium Google Maps Platform, tanda tangan digital diperlukan. Dapatkan informasi selengkapnya tentang parameter autentikasi untuk pelanggan Paket Premium.

• heading menunjukkan arah kompas kamera. Nilai yang diterima adalah dari 0 hingga 360 (kedua nilai menunjukkan Utara, dengan 90 menunjukkan Timur, dan 180 Selatan). Jika Anda tidak menentukan arah, nilai akan dihitung untuk mengarahkan kamera ke location yang ditentukan, dari titik pengambilan foto terdekat.
• fov (defaultnya adalah 90) menentukan ruang pandang horizontal gambar yang dinyatakan dalam derajat, dengan nilai maksimum yang diizinkan sebesar 120. Saat menangani area pandang berukuran tetap, seperti gambar Street View dengan ukuran yang ditetapkan, ruang pandang pada dasarnya mewakili zoom, dengan angka yang lebih kecil menunjukkan tingkat zoom yang lebih tinggi.

  
  
  (Kiri: fov=120; Kanan: fov=20)

• pitch (defaultnya adalah 0) menentukan sudut atas atau bawah kamera yang terkait dengan kendaraan Street View. Biasanya, namun tidak selalu, horizontal datar. Nilai positif memiringkan kamera ke atas (dengan 90 derajat menunjukkan lurus ke atas); nilai negatif memiringkan kamera ke bawah (dengan -90 menunjukkan lurus ke bawah).
• radius (defaultnya adalah 50) menetapkan radius yang ditentukan dalam meter, untuk menelusuri panorama, yang dipusatkan pada lintang dan bujur yang diberikan. Nilai yang valid adalah bilangan bulat non-negatif.
• return_error_code menunjukkan apakah API harus menampilkan kode error saat tidak ada gambar yang ditemukan (404 NOT FOUND), atau sebagai respons terhadap permintaan yang tidak valid (400 BAD REQUEST). Nilai yang valid adalah true dan false. Jika ditetapkan ke true, pesan error akan ditampilkan sebagai pengganti gambar abu-abu generik. Dengan demikian, Anda tidak perlu melakukan panggilan terpisah untuk memeriksa ketersediaan image.
• source (defaultnya adalah default) 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 dapat ditentukan apakah berada di dalam atau di luar ruangan. Misalnya, PhotoSphere tidak ditampilkan karena tidak diketahui apakah foto tersebut berada di dalam atau di luar ruangan.

Berikut 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 akan menampilkan gambar generik berwarna abu-abu, dengan teks "Maaf, kami tidak memiliki gambar di sini", seperti yang ditunjukkan dalam contoh ini:

Gambar: Gambar generik yang ditampilkan saat tidak ada gambar yang tersedia untuk lokasi yang ditentukan.

Hanya tampilkan gambar yang valid

Agar tidak menampilkan gambar umum, dan memastikan halaman web Anda hanya menampilkan gambar Street View Static API yang valid, ikuti saran berikut:

• Tetapkan parameter return_error_code ke true. Hal ini menyebabkan Street View Static API menampilkan error 404 NOT FOUND, bukan gambar abu-abu umum, jika tidak ada gambar yang tersedia untuk lokasi yang ditentukan.
• Minta metadata gambar Street View untuk menentukan apakah ada gambar yang tersedia untuk lokasi yang ditentukan sebelum mengirim permintaan.