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:
- 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 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:
- Penagihan belum diaktifkan di akun Anda. Aktifkan penagihan.
- Metode penagihan yang diberikan tidak valid (misalnya kartu kredit sudah tidak berlaku). Untuk mengatasinya, buka Google Cloud Console, dan pastikan Anda telah memberikan metode pembayaran yang valid.
- Batas harian yang Anda tetapkan sendiri telah terlampaui. Pelajari cara melihat atau mengubah batas tagihan harian.
- Permintaan tidak memiliki perujuk HTTP, dan Anda menggunakan kunci API yang dibatasi perujuk. Pelajari lebih lanjut cara menambahkan perujuk.
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.
- 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 > Alat Lainnya > Developer Tools.
- Untuk membuka Konsol JavaScript, klik tab Konsol di bagian atas jendela Developer Tools. Anda juga dapat menggunakan tombol ESC untuk mengaktifkan/menonaktifkan Konsol JavaScript.