Respons dan permintaan Street View

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 wajib

Berikut ini opsinya:

  • location dapat berupa string teks (seperti Chagrin Falls, OH) atau nilai lintang/bujur (40.457375,-80.009353), dan harus dienkode ke URL, sehingga alamat seperti "City Hall, New York, NY" harus dikonversi menjadi "City+Hall,New+York,NY", sebelum permintaan ditandatangani. Street View Static API akan diambil ke panorama yang difoto terdekat dari lokasi ini. Jika string teks alamat disediakan, API tersebut dapat menggunakan lokasi kamera yang berbeda untuk menampilkan lokasi yang ditentukan dengan lebih baik. Jika lintang/bujur diberikan, API akan menelusuri radius 50 meter untuk foto yang terdekat dengan lokasi ini. Karena gambar Street View secara berkala diperbarui, dan foto dapat diambil dari posisi yang sedikit berbeda setiap kalinya, mungkin location dapat bergeser ke panorama yang berbeda saat gambar diperbarui.

Atau:

  • pano adalah ID panorama tertentu. Biasanya ini stabil.

Begitu juga:

  • size menentukan ukuran output gambar dalam piksel. Ukuran ditetapkan sebagai {width}x{height} - misalnya, size=600x400 menampilkan gambar dengan lebar 600 piksel, dan tinggi 400.
  • key memungkinkan Anda memantau penggunaan API aplikasi di Google Cloud Console, dan memastikan bahwa Google dapat menghubungi Anda tentang aplikasi Anda jika diperlukan. Untuk informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.

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 pelanggan lama Premium Plan Google Maps Platform, tanda tangan digital diperlukan. Dapatkan informasi selengkapnya tentang parameter autentikasi untuk pelanggan Premium Plan.

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


    Screenshot ruang pandang yang luas, yang menampilkan langit-langit, dinding, lantai, dan jendela tangki di dalam akuarium. Screenshot bidang pandang jarak dekat, yang menampilkan detail foto Street View yang diperbesar di dalam akuarium.
    (Kiri: fov=120; Kanan: fov=20)

  • pitch (default-nya adalah 0) menentukan sudut naik atau turun kamera relatif terhadap kendaraan Street View. Biasanya, namun tidak selalu, horizontal datar. Nilai positif menaikkan sudut kamera (dengan 90 derajat menunjukkan lurus ke atas); nilai negatif akan menurunkan sudut kamera (dengan -90 menunjukkan lurus ke bawah).
  • radius (default-nya adalah 50) menetapkan radius yang ditetapkan 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 gambar tidak 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 umum. Dengan cara tersebut, Anda tidak perlu melakukan panggilan terpisah untuk memeriksa ketersediaan gambar.
  • source (default-nya adalah default) membatasi penelusuran Street View untuk 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 jika memungkinkan untuk menentukan apakah panorama tersebut berada di dalam atau di luar ruangan. Misalnya, PhotoSpheres tidak dikembalikan 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
Screenshot foto titik pandang tingkat jalan yang menunjukkan jalur rel listrik.

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 yang ditunjukkan dalam contoh berikut:

Screenshot gambar generik yang ditampilkan saat tidak ada gambar yang tersedia untuk lokasi yang ditentukan. Latar belakangnya cokelat muda, dan menampilkan teks yang bertuliskan 'Maaf, kami tidak memiliki gambar di sini'.
Gambar: Gambar umum ditampilkan jika tidak ada gambar yang tersedia untuk lokasi yang ditentukan.

Hanya tampilkan gambar yang valid

Agar gambar umum tidak ditampilkan, 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 akan menyebabkan Street View Static API menampilkan error 404 NOT FOUND sebagai ganti gambar abu-abu umum, jika tidak ada gambar yang tersedia untuk lokasi yang ditentukan.
  • Meminta metadata gambar Street View untuk menentukan apakah ada gambar yang tersedia untuk lokasi yang ditentukan sebelum mengirim permintaan.