Pesan Error

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.
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 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.
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 Konsol Cloud.

Untuk mendapatkan kunci API, klik tombol di bawah ini.
Mulai

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 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 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 key dengan kunci API yang valid. Untuk informasi selengkapnya, lihat Memulai Google Maps Platform.

Jika Anda adalah pelanggan Paket Premium, 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 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 client. Jika Anda memiliki lisensi Paket Premium 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 Paket Premium atau Maps API for Work, tentukan client ID Anda sebagai parameter client. Jika 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.

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 Konsol Cloud.

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 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 key. Jika Anda memiliki lisensi Paket Premium 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 Paket Premium Google Maps Platform, Anda dapat menggunakan parameter client atau parameter key. Jika Anda tidak memiliki lisensi, Anda bisa mendapatkan kunci API di Konsol Cloud.

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 Konsol Cloud.

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. Parameter ini tidak akan mencegah Maps JavaScript API berfungsi dengan benar, tetapi dapat menimbulkan risiko keamanan. Hapus parameter ini dari elemen skrip Anda.

SignedInNotSupported Peringatan

Parameter signed_in tidak digunakan lagi dan tidak didukung pada versi Maps JavaScript API yang Anda gunakan. Parameter ini tidak akan mengganggu fungsi Maps JavaScript API, 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 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.

Di Chrome, Anda dapat menggunakan Konsol JavaScript untuk memeriksa output window.console seperti berikut.

  1. Untuk membuka Alat Developer, pilih ikon menu > Alat Lainnya > Alat Developer.
  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 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 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.