Halaman ini menjelaskan pesan error yang dapat dikembalikan oleh Maps Embed API. Saat terjadi error, Maps Embed API menampilkan teks pesan error sebagai pengganti peta. Kondisi kesalahan tertentu juga dapat terjadi, yang menyebabkan tampilan peta watermark yang lebih gelap.
Permintaan tidak valid
Jika permintaan tidak valid, Maps Embed API akan menampilkan
kode status HTTP 4xx dan pesan yang menjelaskan
masalah. Di bawah ini adalah contoh dari kondisi kesalahan tersebut. Catatan: Ini bukanlah
daftar lengkap kemungkinan kesalahan. Periksa kode error yang sebenarnya
dan pesan yang ditampilkan oleh API untuk detail masalah tertentu.
| Contoh kondisi kesalahan | Kode status |
|---|---|
Permintaan berisi parameter yang tidak valid, atau parameter yang diperlukan adalah
tidak ada. Misalnya, parameter zoom tidak berada dalam
rentang nilai numerik yang diharapkan, atau parameter yang diperlukan tidak ada di
terhadap permintaan. |
400 BAD REQUEST |
| Kunci API yang disertakan dalam permintaan tidak valid. | 403 FORBIDDEN |
Error kuota dan kunci API
Error kunci API dan kuota dianggap sebagai permintaan yang tidak valid. Kemungkinan penyebab meliputi hal berikut:
- Kunci API tidak ada atau tidak valid. Untuk mengatasi error ini, pastikan berisi kunci API yang valid. Mendapatkan kunci API.
- Maps Embed API tidak diaktifkan untuk project Anda. Pelajari tentang mengaktifkan dan menonaktifkan API.
- Kunci API memiliki pelanggaran pembatasan. Baca praktik terbaik kunci API selengkapnya.
Error penagihan dan perujuk HTTP
Peta yang lebih gelap, atau "negatif" Gambar Street View, diberi watermark dengan Resume"untuk untuk tujuan pengembangan" akan ditampilkan jika salah satu kondisi berikut terpenuhi:
- Penagihan belum diaktifkan pada akun Anda. Aktifkan penagihan.
- Metode penagihan yang diberikan tidak valid (misalnya kredit yang sudah tidak berlaku kartu). Untuk mengatasi hal 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 selengkapnya tentang cara menambahkan perujuk.
Memeriksa error pada browser
Untuk error Penagihan dan perujuk HTTP, Maps Embed API akan menulis
pesan error ke window.console. Untuk permintaan yang tidak valid (termasuk
Kunci API dan error kuota), hanya kode status 4xx HTTP yang dilaporkan
di konsol. Bagian ini menjelaskan cara memeriksa {i>output<i} konsol di
di Google Chrome. Jika Anda menggunakan browser lain, periksa developer
dokumentasi untuk browser Anda. Sebagai referensi Anda, ini adalah
daftar alat yang dapat
periksa {i>output<i} 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 > Alat Developer.
- Untuk membuka Konsol JavaScript, klik tab Konsol di bagian atas jendela Developer Tools. Anda juga dapat menggunakan tombol ESC untuk Konsol JavaScript.