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:
- Kunci API tidak ada atau tidak valid. Untuk mengatasi error ini, pastikan permintaan Anda menyertakan kunci API yang valid. Dapatkan kunci API.
- Maps Embed API tidak diaktifkan untuk project Anda. Pelajari cara mengaktifkan dan menonaktifkan API.
- Kunci API memiliki pelanggaran pembatasan. Baca selengkapnya tentang praktik terbaik kunci API.
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:
- Penagihan belum diaktifkan di akun Anda. Aktifkan penagihan.
- Metode penagihan yang diberikan tidak valid (misalnya kartu kredit yang sudah tidak berlaku). Untuk mengatasinya, buka Google Cloud Console, dan pastikan Anda telah memberikan metode pembayaran yang valid.
- Batas harian yang diterapkan secara mandiri telah terlampaui. Pelajari cara melihat atau mengubah batas tagihan harian.
- Permintaan tidak memiliki perujuk HTTP, dan Anda menggunakan kunci API yang dibatasi perujuk. Pelajari cara menambahkan perujuk lebih lanjut.
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.
- Console untuk Internet Explorer.
- Konsol Web untuk Firefox.
- Proses debug jarak jauh untuk Android.
- Web Inspector untuk iOS.
Di Chrome, Anda dapat menggunakan Konsol JavaScript untuk memeriksa output konsol seperti berikut.
- Untuk membuka Developer Tools, pilih ikon menu > Fitur Lainnya > Developer Tools.
- Untuk membuka Konsol JavaScript, klik tab Console di bagian atas jendela Developer Tools. Anda juga dapat menggunakan kunci ESC untuk mengaktifkan Konsol JavaScript.