Metadata Gambar Street View

Pengantar

Permintaan metadata Street View Static API menyediakan data tentang Street View Melihat panorama. Dengan menggunakan metadata, Anda dapat mengetahui apakah suatu gambar Street View tersedia di lokasi tertentu, serta mendapatkan akses terprogram ke koordinat lintang dan bujur, ID panorama, tanggal pengambilan foto dan informasi hak cipta untuk gambar tersebut. Dengan mengakses metadata ini, Anda dapat menyesuaikan perilaku error dalam aplikasi Anda.

Permintaan metadata Street View Static API tersedia tanpa besar. Kuota tidak dikonsumsi jika Anda meminta metadata. Kuota hanya digunakan saat Anda memuat gambar menggunakan Street View Static API.

Saat membuat permintaan metadata gambar Street View, gambar panorama adalah akurat hingga 50 meter.

Mengakses metadata gambar

Permintaan metadata gambar Street View adalah HTTP URL dengan bentuk berikut:

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

Sesuai dengan standar dalam URL, semua parameter dipisah menggunakan tanda ampersan karakter (&).

Parameter wajib untuk permintaan metadata

Permintaan metadata menerima parameter URL yang sama dengan permintaan gambar Street View Static API, meskipun hanya parameter berikut yang diperlukan:

Yakni:

• location — dapat berupa string teks (seperti Chagrin Falls, OH) atau pasangan koordinat lintang dan bujur yang dipisahkan koma (40.457375,-80.009353).

Atau:

• pano — ID panorama tertentu. Panorama dapat berubah ID seiring waktu, jadi tidak mempertahankan ID ini. Sebagai gantinya, simpan alamat lokasi atau koordinat lintang dan bujur sehingga Anda dapat menyegarkan ID panorama. Untuk mengetahui detailnya, lihat Memuat ulang ID panorama yang dihapus.

Begitu juga:

• key dan signature — kunci API diperlukan untuk mengautentikasi permintaan. Tanda tangan digital juga diperlukan untuk instance tertentu, dan selalu direkomendasikan. Untuk informasi selengkapnya, lihat Mendapatkan Kunci dan Tanda Tangan.

Permintaan metadata Anda, dengan hanya parameter yang diperlukan, akan terlihat seperti ini:

https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

atau seperti ini:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

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 sebelumnya mendapatkan ID panorama sehingga Anda dapat memperbaruinya saat dibutuhkan.

2. 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 dapatkan ID panorama baru.

Parameter opsional untuk permintaan metadata

Anda dapat menyertakan parameter berikut dalam permintaan metadata: size, heading, fov, dan pitch. Perhatikan, parameter ini tidak memengaruhi data tentang panorama, atau panorama mana yang ditemukan. API memungkinkan penyertaan parameter yang sama dengan permintaan gambar untuk memudahkan pembuatan permintaan {i>metadata <i} yang terkait dengan gambar tertentu tetapi untuk permintaan metadata, API mengabaikan parameter opsional dan nilai-nilai mereka. Untuk informasi tentang penggunaan parameter ini, lihat referensi Panduan developer Street View Static API.

Format respons

Respons metadata dikembalikan hanya dalam format JSON.

Contoh

Contoh 1: Panorama ditemukan

URL berikut berhasil meminta metadata dan gambar yang sama panorama.

Respons dan permintaan metadata

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

Permintaan dan respons gambar, tempat gambar yang tidak ada diharapkan.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Contoh 2: Panorama tidak ditemukan

URL berikut meminta metadata dan gambar untuk panorama yang tidak dapat ditemukan pada atau dekat dengan lokasi yang ditentukan.

Permintaan dan respons metadata

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "status" : "ZERO_RESULTS"
}

Permintaan dan respons gambar

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Kode status

Kolom status dalam objek respons metadata berisi status permintaan, dan mungkin berisi informasi proses debug untuk membantu Anda memecahkan masalah penyebab permintaan Street View tidak berfungsi. Kolom status dapat berisi nilai berikut:

Informasi selengkapnya

Untuk informasi selengkapnya tentang cara menggunakan Street View Static API, atau produk Google Maps API lainnya, pastikan untuk memeriksa API Maps Halaman dukungan.