Metadata Gambar Street View

Pengantar

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

Catatan: Nilai kolom tanggal dapat bervariasi:

• Kolom tanggal dapat memiliki perincian yang berbeda untuk panorama yang berbeda. Misalnya, kolom tanggal untuk beberapa panorama berisi tahun dan bulan, sedangkan untuk yang lain hanya berisi tahun.
• Kolom tanggal dihilangkan jika tidak ada data yang tersedia.

Permintaan metadata Street View Static API tersedia tanpa biaya. 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 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

Catatan: protokol https:// diperlukan untuk permintaan metadata.

Sebagaimana standar dalam URL, semua parameter dipisah menggunakan karakter ampersand (&).

Parameter yang diperlukan untuk permintaan metadata

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

Berikut ini opsinya:

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

Atau:

• pano — ID panorama tertentu. Ini biasanya stabil, meskipun panorama dapat berubah ID dari waktu ke waktu saat gambar diperbarui.

Begitu juga:

• key dan signature — kunci API diperlukan untuk mengautentikasi permintaan. Tanda tangan digital juga diperlukan dalam kasus 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=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

atau seperti ini:

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

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 seperti permintaan gambar untuk mempermudah pembuatan permintaan metadata yang terkait dengan permintaan gambar tertentu, tetapi untuk permintaan metadata, API mengabaikan parameter opsional dan nilainya. Lihat panduan developer Street View Static API untuk informasi cara menggunakan parameter ini.

Format respons

Respons metadata dikembalikan hanya dalam format JSON.

Contoh

Contoh 1: Panorama ditemukan

URL berikut berhasil meminta metadata dan gambar panorama yang sama.

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"
}

Respons dan permintaan gambar, dengan 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 mungkin tidak tersedia di wilayah Anda.

Contoh 2: Panorama tidak ditemukan

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

Respons dan permintaan 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"
}

Respons dan permintaan 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

Contoh mungkin tidak tersedia di wilayah Anda.

Kode status

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

Status	Deskripsi
"OK"	Menunjukkan tidak terjadi kesalahan; sebuah panorama ditemukan dan metadata dikembalikan.
"ZERO_RESULTS"	Menunjukkan panorama tidak ditemukan di dekat lokasi yang disediakan. Hal ini dapat terjadi jika ID panorama yang diberikan tidak ada atau tidak valid.
"NOT_FOUND"	Menunjukkan bahwa string alamat yang disediakan dalam parameter location tidak dapat ditemukan. Ini bisa terjadi jika alamat yang tidak ada diberikan.
"OVER_QUERY_LIMIT"	Mengindikasikan bahwa Anda telah melebihi kuota harian atau kuota per detik untuk API ini.
"REQUEST_DENIED"	Menunjukkan permintaan Anda ditolak. Ini dapat terjadi jika Anda tidak mengizinkan permintaan Anda, atau jika Street View Static API tidak diaktifkan di project Google Cloud Console yang berisi kunci API Anda.
"INVALID_REQUEST"	Umumnya menunjukkan bahwa parameter kueri (alamat atau latlng atau komponen) tidak ada.
"UNKNOWN_ERROR"	Menunjukkan permintaan tidak bisa diproses karena kesalahan server. Status ini sering kali bersifat sementara. Permintaan mungkin berhasil jika Anda mencoba lagi.

Informasi selengkapnya

Untuk informasi selengkapnya tentang penggunaan Street View Static API, atau produk Google Maps API lainnya, pastikan untuk melihat halaman Dukungan Maps API.