Pesan Kesalahan

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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.

Kesalahan Kunci API dan Penagihan

Pemecahan masalah

Pada kondisi tertentu, peta yang lebih gelap, atau 'negatif' gambar Street View, yang diberi watermark dengan teks "hanya untuk tujuan pengembangan", dapat ditampilkan. Perilaku ini biasanya mengindikasikan terjadi masalah pada kunci API atau penagihan. Untuk menggunakan produk Google Maps Platform, penagihan harus diaktifkan di akun, dan semua permintaan harus menyertakan kunci API yang valid. Untuk bantuan dalam menemukan pesan error, lihat bagian tentang memeriksa error di browser Anda.

Alur berikut akan membantu Anda memecahkan masalah tersebut.

Kode Error Maps JavaScript API untuk Developer dan Pemilik Situs

Tabel berikut mencantumkan kemungkinan kode error yang ditampilkan oleh Maps JavaScript API, dengan deskripsi penyebabnya dan cara Anda dapat memperbaiki masalah tersebut. Untuk bantuan dalam menemukan pesan error, lihat bagian tentang memeriksa error di 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 berfungsi dengan benar, API harus dimuat langsung dari https://maps.googleapis.com.

Lihat Memuat Maps JavaScript API.

TOSViolationMapError Situs web ini tampaknya melanggar Ketentuan Layanan Google Maps API. Google Maps API telah dinonaktifkan untuk situs web ini.

Aplikasi Anda diblokir karena ketidakpatuhan terhadap Persyaratan Layanan Google Maps Platform, setelah beberapa notifikasi email. Untuk mengajukan banding atas pemblokiran 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 diizinkan menggunakan Google Maps Client ID yang disediakan.

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 yang diberi otorisasi.

Lihat bagian Mendaftarkan URL yang Diizinkan.

Kode Error Maps JavaScript API

Jika Anda menemukan error pada Konsol JavaScript Chrome, Konsol Web Firefox, atau alat setara lainnya di browser Anda, lihat tabel di bawah untuk menemukan penjelasan kode error.

Maps JavaScript API menampilkan error dan peringatan. Error menunjukkan masalah serius yang terjadi saat memuat Maps JavaScript API. Halaman Anda tidak dapat memuat API ini 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 menyarankan potensi masalah dalam kode Anda yang memuat Maps JavaScript API. Jika Anda hanya menerima peringatan tanpa error, API akan berfungsi dengan benar di halaman tersebut. Namun, sebaiknya Anda juga memperbaiki potensi masalah ini.

Kode Kesalahan Developer Jenis Deskripsi
ApiNotActivatedMapError Error

Maps JavaScript API tidak diaktifkan pada project API Anda. Anda mungkin perlu 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 diizinkan untuk menggunakan layanan atau API ini. Periksa setelan Pembatasan API pada kunci API Anda di Google Cloud Console untuk memastikan bahwa semua API dan layanan yang perlu Anda gunakan telah ditetapkan 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 tempat Anda 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. Error ini mungkin muncul setelah Anda membuat kunci API baru jika 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

Client ID yang disertakan dalam elemen skrip yang memuat API tidak valid atau sudah tidak berlaku. Pastikan Anda menggunakan client ID dengan benar. ID klien harus diawali dengan "gme-" awalan. Jika Anda melihat error ini bahkan saat menggunakan client ID dengan benar, client ID tersebut mungkin sudah habis masa berlakunya. Hubungi Google Account Manager 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 tidak akan 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, maka tidak ada langkah yang dapat dilakukan untuk memperbaiki error ini. Namun, Anda mungkin ingin 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 diblokir karena ketidakpatuhan terhadap Persyaratan Layanan Google Maps Platform, setelah beberapa notifikasi email. Untuk mengajukan banding atas pemblokiran 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 berfungsi lagi pada saat kuota harian berikutnya direset.

Jika Anda BUKAN pemilik situs, tidak ada langkah yang dapat dilakukan untuk memperbaiki error ini. Namun, Anda mungkin ingin 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 memiliki Premium Plan Google Maps Platform, Anda dapat menggunakan parameter client atau parameter key. Jika 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. ID klien harus diawali dengan "gme-".

Lihat panduan untuk autentikasi Premium Plan.

InvalidKey Peringatan

Kunci API yang disertakan dalam elemen skrip yang memuat API tampaknya 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 memiliki Premium Plan Google Maps Platform, Anda dapat menggunakan parameter client atau parameter key. Jika 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 memiliki Premium Plan Google Maps Platform, Anda dapat menggunakan parameter client atau parameter key. Jika 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 memuat Maps JavaScript API dari jalur v2 yang tidak digunakan lagi, Anda akan mendapatkan peringatan NoApiKeys, meskipun 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 tidak bekerja dalam elemen skrip. Perbarui 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. Langkah 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. Hilangkan dari elemen skrip Anda.

SignedInNotSupported Peringatan

Parameter signed_in tidak digunakan lagi dan tidak didukung pada versi Maps JavaScript API yang Anda gunakan. Hal ini tidak akan mencegah Maps JavaScript API berfungsi, tetapi perilaku aplikasi Anda dapat berubah, jika Anda mengandalkan fitur login.

UrlAuthenticationCommonError Error

Terjadi error yang tidak sesuai dengan kategori lain pada halaman ini. Mungkin disebabkan oleh masalah 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 Kesalahan 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, ini adalah daftar 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 Developer Tools, pilih ikon menu > Alat Lainnya > Developer Tools.
  2. Untuk membuka Konsol JavaScript, tekan tombol ESC pada keyboard Anda. Tombol ESC akan mengalihkan Konsol JavaScript. Jika Anda menutup konsol, tekan tombol ESC lagi 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 kesalahan 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 di 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 menggunakan Internet Explorer (IE), upgrade ke versi IE terbaru. Mengingat akhir dukungan untuk versi IE lama, Anda juga dapat mempertimbangkan untuk menggunakan salah satu browser alternatif yang didukung oleh Maps JavaScript API.
  • Jika Anda mengembangkan aplikasi Windows native yang berjalan di WebView, menggunakan versi Internet Explorer yang didukung oleh Maps JavaScript API, kemungkinan browser akan kembali ke mode yang menggunakan Internet Explorer 7 secara default. Anda dapat mengganti perilaku default ini dengan cara berikut:
    • Tentukan mode dokumen lama dengan menggunakan header meta IE X-UA-Compatible (perbaikan yang direkomendasikan).
      <meta http-equiv="x-ua-compatible" content="IE=edge">
    • Update registry untuk menggunakan kunci registry FEATURE_BROWSER_EMULATION khusus aplikasi.

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 di video ini.

  • Cari kesalahan ketik. Ingat bahwa JavaScript adalah bahasa yang peka huruf besar/kecil.
  • Periksa dasar-dasarnya - beberapa masalah yang paling umum terjadi saat pembuatan peta awal. Misalnya:
    • Konfirmasikan bahwa 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 di Developer Tools Chrome. Mulailah dengan mencari kesalahan di Konsol JavaScript.
  • Posting pertanyaan ke Stack Overflow. Panduan tentang cara memposting pertanyaan bagus tersedia di halaman Dukungan.