Pesan Error

Halaman ini menjelaskan pesan error yang dapat ditampilkan oleh Maps Embed API. Saat terjadi error, Maps Embed API akan menampilkan teks pesan error sebagai pengganti peta. Kondisi error tertentu juga dapat terjadi, yang menyebabkan tampilan peta dengan watermark gelap.

Permintaan tidak valid

Jika ada permintaan yang tidak valid, Maps Embed API akan menampilkan kode status HTTP 4xx dan pesan yang menjelaskan masalah tersebut. Di bawah ini adalah contoh dari kondisi kesalahan tersebut. Catatan: Ini bukanlah daftar lengkap error yang mungkin terjadi. Periksa kode error yang sebenarnya dan pesan yang ditampilkan oleh API untuk mengetahui detail masalah tertentu.

Contoh kondisi kesalahan Kode status
Permintaan berisi parameter yang tidak valid, atau parameter yang diperlukan tidak ada. Misalnya, parameter zoom tidak berada dalam rentang nilai numerik yang diharapkan, atau parameter wajib tidak ada di permintaan. 400 BAD REQUEST
Kunci API yang disertakan dalam permintaan tidak valid. 403 FORBIDDEN

Kunci API dan error QPS

Kunci API dan error QPS dianggap sebagai permintaan yang tidak valid. Kemungkinan penyebabnya meliputi hal berikut:

Error perujuk HTTP dan penagihan

Peta yang lebih gelap, atau gambar Street View "negatif", yang diberi watermark dengan ""hanya untuk tujuan pengembangan"" akan ditampilkan jika salah satu hal berikut berlaku:

Memeriksa error di browser Anda

Untuk error perujuk HTTP dan Penagihan, Maps Embed API menulis pesan error ke window.console. Untuk permintaan yang tidak valid (termasuk kunci API dan error QPS), hanya kode status 4xx HTTP yang dilaporkan di konsol. Bagian ini menjelaskan cara memeriksa output konsol di Google Chrome. Jika Anda menggunakan browser lain, periksa dokumentasi developer untuk browser Anda. Sebagai referensi Anda, berikut adalah daftar alat untuk memeriksa output konsol di beberapa browser lain.

Di Chrome, Anda dapat menggunakan Konsol JavaScript untuk memeriksa output konsol seperti berikut.

  1. Untuk membuka Developer Tools, pilih ikon menu > Alat Lainnya > Developer Tools.
  2. Untuk membuka Konsol JavaScript, klik tab Konsol di bagian atas jendela Developer Tools. Anda juga dapat menggunakan tombol ESC untuk mengaktifkan/menonaktifkan Konsol JavaScript.