Pesan Kesalahan

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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

Permintaan tidak valid

Jika permintaan tidak valid, Maps Embed API menampilkan kode status HTTP 4xx dan pesan yang menjelaskan masalah tersebut. Di bawah ini adalah contoh dari kondisi kesalahan tersebut. Catatan: Ini bukan 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 menyertakan 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 dalam permintaan. 400 BAD REQUEST
Kunci API yang disertakan dalam permintaan tidak valid. 403 FORBIDDEN

Error API key dan QPS

Error kunci API dan QPS diperlakukan sebagai permintaan yang tidak valid. Kemungkinan penyebabnya meliputi:

Error terkait penagihan dan perujuk HTTP

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

Memeriksa error di browser Anda

Untuk error perujuk Penagihan dan HTTP, Maps Embed API menulis pesan error ke window.console. Untuk permintaan yang tidak valid (termasuk kunci API dan error QPS), hanya kode status HTTP 4xx 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, 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 > Fitur Lainnya > Developer Tools.
  2. Untuk membuka Konsol JavaScript, klik tab Console di bagian atas jendela Developer Tools. Anda juga dapat menggunakan kunci ESC untuk mengaktifkan Konsol JavaScript.