Pesan Error

Perlu bantuan dari manusia?
Buka halaman Support Google Maps Platform.
Halaman pesan error ini hanya untuk referensi. Kami siap membantu Anda memecahkan masalah error Maps JavaScript API. Jika Anda mencoba meminta bantuan dari manusia dengan mengirim masukan melalui halaman ini, Anda tidak akan dapat menghubungi siapa pun yang dapat membantu. Namun, jika Anda menemukan masalah terkait konten di halaman ini, beri tahu kami melalui link masukan. Terima kasih.

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.

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.

Error Kunci API dan Penagihan

Memecahkan 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.

Apakah Anda menggunakan kunci API?

Saya tidak yakin. Bagaimana cara memeriksa apakah saya menggunakan kunci API?

Kunci API diteruskan sebagai parameter key pada URL yang digunakan untuk memuat Maps JavaScript API. Berikut adalah beberapa opsi untuk memeriksa apakah Anda menggunakan kunci API:

• Gunakan ekstensi Chrome Google Maps Platform API Checker. Ekstensi ini memungkinkan Anda mengetahui apakah situs Anda mengimplementasikan Maps API berlisensi Google dengan benar atau tidak.
• Jika Anda menggunakan library atau plugin untuk memuat Maps JavaScript API, periksa setelan library tersebut dan cari opsi kunci API.
• Periksa error pada browser Anda. Jika Anda melihat pesan berikut, Anda tidak menggunakan kunci API Anda dengan benar:
• Peringatan Google Maps JavaScript API: NoApiKeys
• Error Google Maps JavaScript API: MissingKeyMapError

Untuk developer web:

• Jika Anda memiliki akses ke kode sumber dari aplikasi Anda, cari tag <script> yang digunakan untuk memuat Maps JavaScript API. Saat memuat Maps JavaScript API, ganti YOUR_API_KEY pada kode di bawah dengan kunci API Anda.

    <script async defer
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>
  

• Periksa traffic jaringan yang dihasilkan oleh situs Anda pada browser. Di Chrome, Anda dapat melihatnya melalui tab Jaringan pada DevTools. Di sini Anda akan melihat permintaan jaringan yang dibuat oleh situs Anda. Permintaan yang dibuat menggunakan Maps JavaScript API akan berada pada jalur maps/api/js. Di sini Anda dapat mengonfirmasi apakah permintaan menggunakan parameter key. Sebaiknya filter traffic jaringan Anda menurut maps/api/js saat membuka tab Network.

Tidak, saya tidak menggunakan kunci API.

Untuk mendapatkan kunci API, klik tombol di bawah ini. Jika Anda tidak melihat penyiapan terpandu, ikuti petunjuk lengkap pada Memulai Google Maps Platform.
Mulai

Ya, saya menggunakan kunci API.

Bagus! Sekarang periksa apakah akun penagihan telah dikaitkan ke project Anda.

Apakah akun penagihan dikaitkan ke project Anda?

Saya tidak yakin. Bagaimana cara memeriksa apakah akun penagihan dikaitkan ke project saya?

Buka halaman Billing di Google Cloud Console dan pilih project tempat kunci API Anda dibuat. Untuk mengonfirmasi bahwa kunci tersebut terkait dengan project:

1. Buka bagian Credentials, yang dapat diakses melalui sidebar sebelah kiri pada Google Maps Platform > Credentials.
2. Pastikan bahwa kunci API yang saat ini digunakan di situs Anda telah tercantum. Jika belum, beralihlah ke project lain, lalu periksa kredensial project tersebut.
3. Jika tidak dapat menemukan project untuk kunci API Anda, kemungkinan Anda telah kehilangan akses ke project tersebut. Minta bantuan orang lain di organisasi Anda. Jika project asli tidak dapat ditemukan, Anda harus:
   1. Membuat project baru. Hal ini dapat dilakukan dengan memilih New Project dari daftar project, atau dengan memilih Create Project melalui halaman Resource Manager.
   2. Membuat kunci API baru. Hal ini dapat dilakukan di halaman Credentials. Setelah membuka halaman tersebut, klik Create credentials, lalu pilih API key.

Setelah menemukan project Anda di Konsol Cloud, periksa apakah akun penagihan telah dikaitkan dengan membuka bagian Billing pada menu samping kiri.

Tidak, akun penagihan tidak dikaitkan ke project saya.

Buka halaman Enable Billing di Cloud Console dan tambahkan akun penagihan ke project Anda. Untuk informasi tambahan, lihat Memulai Google Maps Platform.

Ya, akun penagihan telah dikaitkan ke project saya.

Bagus! Sekarang pastikan bahwa metode penagihan yang diberikan sudah valid.

Apakah metode penagihan yang diberikan sudah tidak valid (misalnya kartu kredit yang sudah tidak berlaku)?

Anda dapat menambahkan, menghapus, atau memperbarui metode pembayaran di Cloud Console.

Apakah ada kelebihan pada batas harian yang Anda tetapkan sendiri pada API?

Jika Anda telah menetapkan batas harian pada API, yang umumnya dilakukan untuk mencegah peningkatan tak terduga, Anda dapat memperbaiki masalah ini dengan meningkatkan batas harian.

Anda dapat memeriksa batas harian dengan membuka APIs & Services Dashboard di Cloud Console. Setelah membukanya:

1. Pilih project jika diminta.
2. Pilih API dari daftar, lalu klik tab Quotas.

Apakah kunci API Anda memiliki batasan alamat IP?

Kunci API dengan pembatasan alamat IP hanya dapat digunakan pada layanan web yang ditujukan untuk penggunaan dari sisi server (seperti Geocoding API dan Web Service API lainnya). Sebagian besar layanan web ini memiliki layanan yang setara pada Maps JavaScript API (misalnya, lihat Layanan Geocoding). Untuk menggunakan layanan sisi klien Maps JavaScript API, Anda harus membuat kunci API terpisah yang dapat diamankan menggunakan pembatasan perujuk HTTP (lihat Mendapatkan, menambahkan, dan membatasi kunci API).

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 bantuan dalam menemukan 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 Premium Plan Google Maps Platform, gunakan kredensial Premium Plan 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 Google Cloud Console. Untuk mengaktifkan Maps JavaScript API untuk project Anda, klik tombol di bawah. Pelajari Caranya
ApiTargetBlockedMapError	Error	Kunci API ini tidak diberi otorisasi untuk menggunakan layanan atau API ini. Periksa setelan API restrictions pada kunci API Anda di Google Cloud Console 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 Cloud Console. 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. Pelajari Caranya
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. Pelajari lebih lanjut
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 Cloud Console. Untuk mendapatkan kunci API, klik tombol di bawah ini. Mulai
InvalidClientIdMapError	Error	ID klien 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 Premium Plan atau Maps API for Work, Anda harus menggunakan parameter key dengan kunci API, bukan parameter client . 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. Mulai
MalformedCredentialsMapError	Error	Aplikasi Anda menggunakan skema URI yang tidak didukung. Pastikan bahwa aplikasi 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 key dengan kunci API yang valid. Untuk informasi selengkapnya, lihat Memulai Google Maps Platform. Jika Anda adalah pelanggan Premium Plan, Anda harus menggunakan parameter client dengan client ID, atau parameter key dengan kunci API yang valid. Untuk informasi selengkapnya, lihat panduan untuk kunci API dan client ID. 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 Cloud Console. 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 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 Memulai Google Maps Platform.
ClientIdLooksLikeCryptoKey	Peringatan	Anda mungkin telah memberikan kunci kriptografis dalam parameter client. Jika Anda memiliki lisensi Premium Plan atau Maps API for Work, tentukan client ID Anda sebagai parameter client. Anda tidak perlu menggunakan kunci kriptografis untuk Maps JavaScript API. Lihat panduan client ID untuk pelanggan Premium Plan dan Maps API for Work.
ClientIdLooksLikeKey	Peringatan	Anda mungkin telah memberikan kunci API dalam parameter client. Jika Anda memiliki lisensi Premium Plan atau Maps API for Work, tentukan client ID sebagai parameter client. Jika Anda memiliki Premium Plan 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.
InvalidChannel	Peringatan	Anda mungkin memberikan parameter channel yang tidak valid. Saluran harus berupa string alfanumerik ASCII, yang dapat menyertakan titik (.), garis bawah (_), dan tanda hubung (-). Pastikan Anda menentukan parameter channel yang valid. Lihat Pelaporan | Premium Plan Google Maps Platform.
InvalidClientId	Peringatan	Parameter client tampaknya tidak berisi client ID yang benar. Client ID harus dimulai dengan "gme-". 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 Cloud Console. Untuk mendapatkan kunci API, klik tombol di bawah ini. Mulai
InvalidVersion	Peringatan	Anda mungkin telah memberikan nomor versi yang salah dalam elemen skrip. Pastikan Anda menggunakan nomor versi yang benar. Lihat Pembuatan Versi | Google Maps JavaScript API.
KeyLooksLikeClientId	Peringatan	Anda mungkin telah memberikan client ID sebagai parameter key. Jika Anda memiliki lisensi Premium Plan atau Maps API for Work, tentukan client ID Anda sebagai parameter client, bukan parameter key. Jika Anda memiliki Premium Plan 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 key. Jika Anda memiliki lisensi Premium Plan atau Maps API for Work, tentukan client ID Anda sebagai parameter client, dan hapus parameter key dari elemen skrip. Kunci kriptografis tidak diperlukan untuk Maps JavaScript API. Jika Anda memiliki Premium Plan Google Maps Platform, Anda dapat menggunakan parameter client atau parameter key. Jika Anda tidak memiliki lisensi, Anda bisa mendapatkan kunci API di Cloud Console. Lihat panduan untuk Menentukan client ID saat memuat API.
KeyLooksLikeProjectNumber	Peringatan	Anda mungkin telah memberikan nomor project sebagai parameter key. Pastikan Anda menggunakan kunci API yang benar. Anda dapat membuat kunci API baru di Cloud Console. 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 key. Anda dapat membuat kunci API baru di Cloud Console. Untuk mendapatkan kunci API, klik tombol di bawah untuk memulai. Mulai Jika Anda memuat Maps JavaScript API dari jalur v2 yang tidak digunakan lagi, Anda akan mendapatkan peringatan NoApiKeys, meskipun jika Anda menentukan parameter key. Lihat panduan upgrade v2 ke v3 dan migrasikan aplikasi Anda ke Maps JavaScript API v3.
RetiredVersion	Peringatan	Anda mungkin telah memberikan versi yang sudah dihentikan dalam elemen skrip. Update aplikasi Anda untuk menggunakan salah satu versi yang tersedia. Lihat Pembuatan Versi | Google Maps JavaScript API.
SensorNotRequired	Peringatan	Parameter sensor tidak lagi diperlukan untuk Maps JavaScript API. Ini tidak akan mencegah Maps JavaScript API berfungsi dengan benar, tetapi sebaiknya Anda menghapus parameter sensor dari elemen skrip.
SignatureNotRequired	Peringatan	Parameter signature tidak diperlukan untuk Maps JavaScript API. Ini tidak akan mencegah Maps JavaScript API berfungsi dengan benar, tetapi dapat menimbulkan risiko keamanan. Hapus dari elemen skrip Anda.
SignedInNotSupported	Peringatan	Parameter signed_in tidak digunakan lagi dan tidak didukung pada versi Maps JavaScript API yang Anda gunakan. Ini tidak akan mencegah Maps JavaScript API berfungsi, tetapi perilaku aplikasi dapat berubah, jika Anda mengandalkan fitur login.
UrlAuthenticationCommonError	Error	Terjadi error yang tidak masuk dalam kategori lainnya di halaman ini. Penyebabnya mungkin masalah yang sifatnya sementara. Coba lagi permintaan tersebut setelah beberapa saat. Jika cara tersebut tidak menyelesaikan masalah, tinjau panduan developer untuk memastikan permintaan 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.

1. Untuk membuka Developer Tools, pilih ikon menu > More Tools > Developer Tools.
2. 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 bisa 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. Ingatlah, 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 dan center 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.
  Lihat contoh kami untuk penerapan referensi.
• 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.