Google Street View Image API

Pengantar

Google Street View Image API memungkinkan Anda menyematkan panorama atau gambar kecil Street View statis (non-interaktif) ke dalam laman web, tanpa menggunakan JavaScript. Viewport didefinisikan dengan parameter URL yang dikirim melalui permintaan HTTP standar, dan dikembalikan sebagai gambar statis.

Aplikasi contoh mungkin tidak tersedia di region Anda.

https://maps.googleapis.com/maps/api/streetview?size=400x400&location=40.720032,-73.988354
&fov=90&heading=235&pitch=10
&key=YOUR_API_KEY

Parameter URL

Permintaan Street View Image adalah HTTP URL dengan bentuk berikut:

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

Baik:

• location bisa berupa string teks (misalnya Chagrin Falls, OH) atau nilai lintang/bujur (40.457375,-80.009353). Google Street View Image API akan membidik foto panorama yang terdekat dengan lokasi ini. Jika string teks alamat disediakan, API bisa menggunakan lokasi kamera yang berbeda untuk menampilkan lokasi yang ditetapkan dengan lebih baik. Jika lat/lnd disediakan, API akan menelusuri radius 50 meter untuk foto yang terdekat dengan lokasi ini. Karena gambar Street View secara berkala diperbarui, dan fotonya mungkin diambil dari posisi yang sedikit berbeda, sehingga mungkin location Anda bergeser ke panorama berbeda ketika gambar diperbarui.

Atau:

• pano adalah ID panorama tertentu. Biasanya ini stabil.

Begitu juga:

• size menetapkan ukuran keluaran gambar dalam piksel. Ukuran ditetapkan sebagai {width}x{height} - misalnya, size=600x400 akan mengembalikan gambar dengan lebar 600 piksel, dan tinggi 400.
• key memungkinkan Anda memantau penggunaan API aplikasi dalam Google API Console, memungkinkan akses ke kuota harian gratis yang cukup banyak, dan memastikan Google bisa menghubungi Anda tentang aplikasi jika diperlukan. Untuk informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.

  Catatan: Pelanggan Google Maps APIs Premium Plan bisa memilih menggunakan kunci API dan tanda tangan digital, atau ID klien dan tanda tangan digital yang valid, di permintaan Street View Anda. Dapatkan informasi selengkapnya tentang parameter autentikasi untuk pelanggan Premium Plan.

  Pelanggan yang memiliki lisensi Google Maps APIs for Work lama harus menyertakan parameter client dan signature yang valid dengan permintaannya, bukannya sebuah key. Untuk informasi selengkapnya, lihat bagian ID Klien dan tanda tangan di laman Mendapatkan Kunci dan Tanda Tangan.

Parameter opsional

• signature (disarankan) adalah tanda tangan digital yang memverifikasi bahwa setiap situs yang menghasilkan permintaan menggunakan kunci API Anda telah diotorisasi untuk melakukannya. Catatan: Jika Anda mengaktifkan penagihan, tanda tangan digital diperlukan. Jika Anda melebihi batas gratis per hari untuk pemuatan peta, pemuatan peta tambahan akan dikenakan biaya untuk sisa waktu hari itu. Pemuatan peta yang dikenakan biaya yang tidak menyertakan tanda tangan digital akan gagal. Untuk informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.

  Catatan: untuk pelanggan Google Maps APIs Premium Plan, tanda tangan digital diperlukan. Dapatkan informasi selengkapnya tentang parameter autentikasi untuk pelanggan Premium Plan.

• heading menunjukkan kepala kompas pada kamera. Nilai yang diterima adalah dari 0 hingga 360 (kedua nilai ini menunjukkan Utara, sedangkan 90 menunjukkan Timur, dan 180 menunjukkan Selatan). Jika tidak ada kepala kompas yang ditetapkan, nilainya akan dihitung mengarahkan kamera ke location yang ditetapkan, dari titik yang terdekat dengan pengambilan foto.
• fov (default-nya adalah 90) menentukan bidang pandang horizontal dari suatu gambar. Bidang pandang ini dinyatakan dalam derajat, dengan nilai maksimum yang diperbolehkan sebesar 120. Saat menangani bidang viewport berukuran tetap, seperti pada gambar Street View berukuran tertentu, bidang pandang pada dasarnya menyatakan zoom, dengan angka yang lebih kecil menunjukkan tingkat zoom lebih tinggi.

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

  Aplikasi contoh mungkin tidak tersedia di region Anda.

• pitch (default-nya adalah 0) menetapkan sudut naik atau turun kamera sesuai dengan kendaraan Street View. Biasanya, namun tidak selalu, horizontal datar. Nilai positif akan menaikkan sudut kamera (dengan 90 derajat menunjukkan lurus ke atas); sementara nilai negatif akan menurunkan sudut kamera (dengan -90 menunjukkan lurus ke bawah).

Contoh permintaan ditampilkan di bawah ini.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY

Aplikasi contoh mungkin tidak tersedia di region Anda.

Gambar tidak tersedia

Untuk lokasi yang tidak tersedia gambar Street View, Google Street View Image API mengembalikan gambar generik berwarna abu-abu, dengan teks "Sorry, we have no imagery here."

Gambar: Gambar generik ditampilkan jika tidak tersedia gambar untuk lokasi yang ditetapkan.

Aplikasi contoh mungkin tidak tersedia di region Anda.

Untuk menghindari skenario ini, Anda bisa menentukan apakah tersedia gambar untuk lokasi yang ditetapkan, serta data lain tentang gambar, dengan meminta metadata gambar Street View.

Informasi selengkapnya

Untuk informasi selengkapnya tentang penggunaan Google Street View Image API, atau produk Google Maps API lainnya, pastikan memeriksa Laman dukungan Maps API.