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 permintaan tidak valid, Maps Embed API akan menampilkan kode status HTTP 4xx dan pesan yang menjelaskan masalahnya. Di bawah ini adalah contoh dari kondisi kesalahan tersebut. Catatan: Ini bukan
daftar lengkap kemungkinan error. Periksa kode error dan pesan sebenarnya 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 yang diperlukan tidak ada dalam
permintaan. |
400 BAD REQUEST |
| Kunci API yang disertakan dalam permintaan tidak valid. | 403 FORBIDDEN |
Error kunci API dan kuota
Error kunci API dan kuota diperlakukan 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 penagihan dan perujuk HTTP
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 yang sudah tidak berlaku). Untuk mengatasi masalah ini, buka konsol Google Cloud, 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
Untuk error perujuk Penagihan dan HTTP, Maps Embed API menulis
pesan error ke window.console. Untuk permintaan yang tidak valid (termasuk
error kuota dan kunci API), 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, daftar ini berisi 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 Alat Developer, pilih ikon menu > Alat Lainnya > Alat Developer.
- Untuk membuka Konsol JavaScript, klik tab Console di bagian atas jendela Developer Tools. Anda juga dapat menggunakan tombol ESC untuk mengalihkan Konsol JavaScript.