Halaman ini menjelaskan pesan error yang dapat ditampilkan oleh Maps JavaScript API. Maps JavaScript API menulis pesan error dan peringatan ke konsol JavaScript. Kondisi error tertentu juga dapat terjadi, yang menyebabkan tampilan peta dengan watermark gelap.
Error Kunci API dan Penagihan
Pemecahan masalah
Pada kondisi tertentu, peta yang lebih gelap, atau gambar Street View 'negatif', yang diberi watermark dengan teks "hanya untuk tujuan pengembangan", mungkin akan ditampilkan. Perilaku ini biasanya mengindikasikan terjadi masalah pada kunci API atau penagihan. Untuk menggunakan produk Google Maps Platform, penagihan harus diaktifkan di akun Anda, dan semua permintaan harus menyertakan kunci API yang valid. Untuk mendapatkan bantuan terkait munculnya pesan error, lihat bagian tentang memeriksa error pada browser Anda.
Alur berikut akan membantu Anda memecahkan masalah tersebut.
Kode Error Maps JavaScript API untuk Developer dan Pemilik Situs
Tabel berikut berisi kemungkinan kode error yang dikembalikan oleh Maps JavaScript API, dengan deskripsi penyebabnya dan cara memperbaiki masalah tersebut. Untuk mendapatkan bantuan terkait munculnya pesan error, lihat bagian tentang memeriksa error pada browser Anda.
Error Pemuatan Peta
Jika Anda menemukan error saat memuat Maps JavaScript API, lihat tabel di bawah ini untuk menemukan penjelasan kode error.
Kode Error | Pesan | Deskripsi |
---|---|---|
NotLoadingAPIFromGoogleMapsError
|
Maps JavaScript API harus didownload langsung dari server Google. |
Elemen skrip yang memuat Maps JavaScript API tidak disertakan dengan benar di halaman Anda. Agar dapat bekerja dengan benar, API harus dimuat langsung dari https://maps.googleapis.com. Lihat Memuat Maps JavaScript API. |
TOSViolationMapError
|
Situs ini tampaknya melanggar Persyaratan Layanan Google Maps API. Google Maps API telah dinonaktifkan untuk situs ini. |
Aplikasi Anda telah diblokir karena ketidakpatuhan terhadap Persyaratan Layanan Google Maps Platform, setelah beberapa notifikasi email. Untuk mengajukan banding atas pemblokiran tersebut dan agar penerapan Anda ditinjau, isi formulir ini. Anda akan menerima respons lewat email dalam waktu beberapa hari kerja. Jika Anda memiliki lisensi Paket Premium Google Maps Platform, gunakan kredensial Paket Premium Google Maps Platform Anda untuk mengatasi error ini. Lihat panduan untuk autentikasi Premium Plan. |
UnauthorizedURLForClientIdMapError
|
URL ini tidak diberi otorisasi untuk menggunakan Client ID Google Maps yang diberikan. |
Client ID Premium Plan atau Maps API for Work yang disertakan dalam pemuatan skrip tidak valid, sudah tidak berlaku, atau alamat saat ini yang memuat Maps JavaScript API belum ditambahkan ke daftar URL resmi. Lihat Mendaftarkan URL Resmi. |
Kode Error Maps JavaScript API
Jika Anda menemukan error pada Konsol JavaScript Chrome, Konsol Web Firefox, atau alat lain yang setara di browser Anda, lihat tabel di bawah untuk menemukan penjelasan kode error.
Maps JavaScript API mengembalikan error dan peringatan. Error menunjukkan masalah serius yang terjadi saat memuat Maps JavaScript API. Halaman Anda tidak dapat memuat API dengan benar, dan API tidak akan berfungsi pada halaman tersebut. Peringatan adalah pesan tambahan tentang pemuatan Maps JavaScript API. Peringatan ini menjelaskan kemungkinan alasan terjadinya error, atau mengindikasikan potensi masalah dalam kode Anda yang memuat Maps JavaScript API. Jika Anda hanya menerima peringatan tanpa error, berarti API akan berfungsi dengan benar pada halaman tersebut. Namun, sebaiknya Anda juga memperbaiki potensi masalah ini.
Kode Error Developer | Jenis | Deskripsi |
---|---|---|
ApiNotActivatedMapError
|
Error |
Maps JavaScript API tidak diaktifkan di project API Anda. Anda mungkin harus mengaktifkan Maps JavaScript API pada API di Konsol Google Cloud. Untuk mengaktifkan Maps JavaScript API untuk project Anda, klik tombol di bawah.
|
ApiTargetBlockedMapError
|
Error |
Kunci API ini tidak diberi otorisasi untuk menggunakan layanan atau API ini. Periksa setelan API restrictions pada kunci API Anda di Konsol Google Cloud untuk memastikan semua API dan layanan yang perlu Anda gunakan sudah ditentukan dengan benar dalam daftar API yang diaktifkan. Lihat kunci API di Cloud Console. Untuk informasi selengkapnya, lihat Praktik terbaik keamanan API. |
DeletedApiProjectMapError
|
Error |
Project API Anda mungkin telah dihapus dari Konsol Cloud. Periksa project yang Anda gunakan untuk membuat kunci API yang disertakan dalam loader JavaScript API. Anda dapat membuat project API baru dan mendapatkan kunci baru di Cloud Console. Untuk membuat project baru dan mendapatkan kunci API project, klik tombol di bawah ini.
|
ClientBillingNotEnabledMapError
|
Error |
Anda belum mengaktifkan penagihan pada project. Anda harus mengaktifkan Penagihan pada Project Google Cloud yang terkait dengan client ID ini, di sini. |
BillingNotEnabledMapError
|
Error |
Anda belum mengaktifkan penagihan pada project yang menyebabkan error ini. Anda harus mengaktifkan Penagihan pada Project Google Cloud di sini. |
ExpiredKeyMapError
|
Error |
Kunci API yang disertakan dalam elemen skrip yang memuat API telah habis masa berlakunya atau tidak dikenali oleh sistem. Anda mungkin menerima error ini setelah membuat kunci API baru jika Anda mencoba menggunakan kunci tersebut sebelum dikenali oleh sistem. Tunggu beberapa menit dan coba lagi, atau Anda mungkin perlu membuat kunci API baru di Konsol Cloud. Untuk mendapatkan kunci API, klik tombol di bawah ini.
|
InvalidAppCheckTokenMapError
|
Error |
Token App Check yang diberikan tidak valid atau sudah tidak berlaku. Error ini hanya dapat terjadi jika Verifikasi App Check sedang digunakan. Lihat panduan untuk Verifikasi App Check. |
InvalidClientIdMapError
|
Error |
Client ID yang dimasukkan dalam elemen skrip yang memuat API tidak valid atau habis masa berlakunya. Pastikan Anda menggunakan client ID dengan benar. Client ID harus dimulai dengan awalan "gme-". Jika Anda melihat error ini bahkan saat menggunakan client ID dengan benar, berarti client ID mungkin telah habis masa berlakunya. Hubungi Account Manager Google Anda.
Jika tidak memiliki lisensi Paket Premium atau Maps API for Work, Anda harus menggunakan parameter Lihat panduan untuk autentikasi Premium Plan. |
InvalidKeyMapError
|
Error |
Kunci API yang disertakan dalam elemen skrip yang memuat API tersebut tidak ditemukan. Pastikan Anda menggunakan kunci API yang benar. Anda dapat membuat kunci API baru di Cloud Console. Untuk mendapatkan kunci API, klik tombol di bawah ini.
|
MalformedCredentialsMapError
|
Error |
Aplikasi Anda menggunakan skema URI yang tidak didukung. Pastikan bahwa aplikasi tersebut menggunakan format URI yang valid seperti yang ditetapkan dalam RFC 3986. |
MissingKeyMapError
|
Error |
Elemen skrip yang memuat API tidak berisi parameter autentikasi yang diperlukan. Jika menggunakan Maps JavaScript API standar, Anda harus menggunakan parameter Jika Anda adalah pelanggan Paket Premium, Anda harus menggunakan parameter Jika Anda BUKAN pemilik situs, tidak ada langkah-langkah yang dapat Anda lakukan untuk memperbaiki error ini. Namun, Anda dapat memberi tahu pemilik situs jika memungkinkan. |
ProjectDeniedMapError
|
Error |
Permintaan Anda belum diselesaikan. Anda mungkin dapat menemukan detail selengkapnya tentang error tersebut di Konsol Cloud. Lihat Cloud Console. |
RefererDeniedMapError
|
Error |
Aplikasi Anda telah diblokir karena ketidakpatuhan terhadap Persyaratan Layanan Google Maps Platform, setelah beberapa notifikasi email. Untuk mengajukan banding atas pemblokiran tersebut dan agar penerapan Anda ditinjau, isi formulir ini. Anda akan menerima respons lewat email dalam waktu beberapa hari kerja. |
RefererNotAllowedMapError
|
Error |
URL saat ini yang memuat Maps JavaScript API belum ditambahkan ke daftar perujuk yang diizinkan. Periksa setelan perujuk kunci API Anda di Cloud Console. Lihat Maps JavaScript API dan bagian Mendapatkan Kunci API. |
OverQuotaMapError
|
Error |
Jumlah permintaan telah melebihi batas penggunaan untuk Maps JavaScript API. Permintaan aplikasi Anda akan normal kembali saat reset kuota harian berikutnya. Jika Anda BUKAN pemilik situs, tidak ada langkah-langkah yang dapat Anda lakukan untuk memperbaiki error ini. Namun, Anda dapat memberi tahu pemilik situs jika memungkinkan. Untuk mengetahui detail selengkapnya, lihat panduan untuk batas penggunaan. Halaman ini juga menjelaskan cara mendapatkan batas penggunaan yang lebih tinggi. |
ApiProjectMapError
|
Error |
Kunci API yang diberikan atau project API yang terkait tidak dapat diselesaikan. Error ini mungkin bersifat sementara. Jika pesan error ini terus berlanjut, Anda mungkin perlu mendapatkan kunci API baru atau membuat project API baru. Untuk informasi selengkapnya, lihat artikel Memulai Google Maps Platform. |
ClientIdLooksLikeCryptoKey
|
Peringatan |
Anda mungkin telah memberikan kunci kriptografis dalam parameter Lihat panduan client ID untuk pelanggan Premium Plan dan Maps API for Work. |
ClientIdLooksLikeKey
|
Peringatan |
Anda mungkin telah memberikan kunci API dalam parameter Lihat panduan untuk autentikasi Premium Plan. |
InvalidChannel
|
Peringatan |
Anda mungkin memberikan parameter |
InvalidClientId
|
Peringatan |
Parameter Lihat panduan untuk autentikasi Premium Plan. |
InvalidKey
|
Peringatan |
Kunci API yang disertakan dalam elemen skrip yang memuat API sepertinya tidak benar. Pastikan Anda menggunakan kunci API yang benar. Anda dapat membuat kunci API baru di Konsol Cloud. Untuk mendapatkan kunci API, klik tombol di bawah ini.
|
InvalidVersion
|
Peringatan |
Anda mungkin telah memberikan nomor versi yang salah dalam elemen skrip. Pastikan Anda menggunakan nomor versi yang benar. |
KeyLooksLikeClientId
|
Peringatan |
Anda mungkin telah memberikan client ID sebagai parameter key . Jika Anda memiliki lisensi Paket Premium atau Maps API for Work, tentukan client ID Anda sebagai parameter client , bukan parameter key . Jika Anda memiliki Paket Premium Google Maps Platform, Anda dapat menggunakan parameter client atau parameter key . Jika Anda tidak memiliki lisensi, Anda harus menggunakan parameter key , bukan parameter client
.
Lihat panduan untuk autentikasi Premium Plan. |
KeyLooksLikeCryptoKey
|
Peringatan |
Anda mungkin telah memberikan kunci kriptografis atau rahasia penandatanganan sebagai parameter Lihat panduan untuk Menentukan client ID saat memuat API. |
KeyLooksLikeProjectNumber
|
Peringatan |
Anda mungkin telah memberikan nomor project sebagai parameter Pelajari cara mendapatkan kunci API. |
NoApiKeys
|
Peringatan |
Elemen skrip yang memuat API tidak memiliki kunci API. Pastikan Anda menyertakan kunci API yang valid sebagai parameter
Untuk mendapatkan kunci API, klik tombol di bawah untuk memulai.
Jika Anda memuat Maps JavaScript API dari jalur v2 yang tidak digunakan lagi, Anda akan mendapatkan peringatan |
RetiredVersion
|
Peringatan |
Anda mungkin telah memberikan versi yang sudah dihentikan dalam elemen skrip. Update aplikasi Anda untuk menggunakan salah satu versi yang tersedia. |
SensorNotRequired
|
Peringatan |
Parameter |
SignatureNotRequired
|
Peringatan |
Parameter |
SignedInNotSupported
|
Peringatan |
Parameter |
UrlAuthenticationCommonError
|
Error |
Terjadi error yang tidak masuk dalam kategori lainnya di halaman ini. Penyebabnya mungkin sebuah masalah yang bersifat sementara. Coba lagi permintaan tersebut setelah beberapa saat. Jika cara tersebut tidak menyelesaikan masalah, tinjau panduan developer untuk memastikan permintaan tersebut memiliki format yang tepat. |
Memeriksa Error di Browser Anda
Maps JavaScript API menulis pesan error ke
window.console
. Bagian ini menjelaskan cara memeriksa
output window.console
di Google Chrome. Jika Anda menggunakan browser lain, periksa dokumentasi developer untuk browser Anda. Sebagai referensi Anda, daftar ini berisi alat untuk memeriksa output window.console
di beberapa browser lain.
- Konsol Web untuk Firefox.
- Proses debug jarak jauh untuk Android.
- Web Inspector untuk iOS.
Di Chrome, Anda dapat menggunakan
Konsol JavaScript
untuk memeriksa output window.console
seperti berikut.
- Untuk membuka Alat Developer, pilih ikon menu > Alat Lainnya > Alat Developer.
- Untuk membuka Konsol JavaScript, tekan tombol ESC pada keyboard Anda. Tombol ESC akan mengalihkan Konsol JavaScript. Jika Anda menutup konsol, tekan lagi tombol ESC untuk membukanya.
Jika terjadi error atau peringatan saat memuat Maps JavaScript API, error atau peringatan tersebut akan muncul sebagai satu atau beberapa baris di konsol. Pesan peringatan atau error memiliki format berikut:
Google Maps API error: [ERROR CODE] [Link to API document]
atau
Google Maps API warning: [ERROR CODE] [Link to API document]
Anda dapat memeriksa tabel kode error di atas untuk menemukan kode error dalam pesan error. Anda juga dapat menemukan detail tentang pesan error dalam dokumen API yang ditautkan dari pesan tersebut.
Catatan: Anda dapat memproses error autentikasi secara terprogram.
Menangani browser yang tidak didukung
Pastikan versi browser yang Anda gunakan saat ini didukung oleh Maps JavaScript API.
Jika Anda mengembangkan aplikasi Windows native yang berjalan di WebView, pastikan Anda menggunakan WebView2 berdasarkan Edge. Versi WebView sebelumnya, yaitu berdasarkan Internet Explorer, tidak lagi didukung.
Jika kode Anda masih tidak berfungsi
Untuk membantu Anda menyiapkan dan menjalankan kode peta, Brendan Kenny dan Mano Marks menunjukkan beberapa kesalahan umum dan cara memperbaikinya dalam video ini.
- Cari kesalahan ketik. Ingat, JavaScript adalah bahasa yang peka huruf besar dan kecil.
- Periksa dasar-dasarnya - beberapa masalah yang paling umum terjadi saat awal pembuatan peta. Misalnya:
- Pastikan Anda telah menentukan properti
zoom
dancenter
di opsi peta Anda. - Pastikan Anda telah mendeklarasikan elemen div tempat peta akan muncul di layar.
- Pastikan elemen div untuk peta memiliki ketinggian. Secara default, elemen div dibuat dengan ketinggian 0, sehingga tidak terlihat.
- Pastikan Anda telah menentukan properti
- Gunakan debugger JavaScript untuk membantu mengidentifikasi masalah, seperti yang tersedia dalam Chrome Developer Tools. Mulailah dengan mencari error di konsol JavaScript.
- Posting pertanyaan ke Stack Overflow. Panduan tentang cara memposting pertanyaan bagus tersedia di halaman Dukungan.