Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Maps JavaScript API

Untuk membantu Anda memulai, kami akan memandu Anda melalui Google Developers Console untuk melakukan beberapa hal terlebih dahulu:

  1. Buat atau pilih sebuah proyek
  2. Aktifkan Google Maps JavaScript API dan layanan terkait
  3. Buat kunci yang sesuai
Lanjutkan

Pesan Kesalahan


Google Maps JavaScript API menulis pesan peringatan dan kesalahan ke window.console. Tabel berikut mencantumkan kode kesalahan yang memungkinkan, yang dikembalikan oleh Google Maps JavaScript API, dengan keterangan penyebabnya dan cara memperbaiki masalah. Untuk bantuan menemukan pesan kesalahan, lihat bagian mengenai memeriksa kesalahan di browser Anda.

Kode Kesalahan Google Maps JavaScript API

Jika Anda menemukan kesalahan saat memuat Google Maps JavaScript API, lihat tabel di bawah ini untuk menemukan penjelasan kode kesalahan tersebut.

Kode Kesalahan Pesan Keterangan
InvalidKeyOrUnauthorizedURLMapError Kunci Google API yang disediakan tidak valid atau situs ini tidak diizinkan menggunakannya.

Kunci API yang disertakan dalam elemen skrip yang memuat API tidak valid, atau URL saat ini yang memuat Google Maps JavaScript API belum ditambahkan ke daftar referrer yang diperbolehkan. Anda mungkin perlu mengaktifkan Google Maps JavaScript API pada API dalam Google API Console.

Lihat Memperoleh kunci API.

NotLoadingAPIFromGoogleMapError Google Maps JavaScript API harus diunduh langsung dari server Google.

Elemen skrip yang memuat Google Maps JavaScript API tidak disertakan dengan benar pada laman Anda. Agar API bisa bekerja dengan benar, maka harus dimuat langsung dari https://maps.googleapis.com.

Lihat Memuat Maps API.

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

Aplikasi Anda telah diblokir karena ketidakpatuhan pada Ketentuan Layanan Google Maps APIs, setelah sejumlah notifikasi email. Untuk mengajukan banding atas pemblokiran dan agar implementasi Anda ditinjau, isilah formulir ini. Anda akan menerima respons lewat email dalam waktu beberapa hari kerja.

Jika Anda memiliki lisensi Google Maps APIs Premium Plan, gunakan kredensial Google Maps APIs Premium Plan Anda untuk mengatasi kesalahan ini. Lihat panduan untuk kunci API dan ID klien.

UnauthorizedURLForClientIdMapError URL ini tidak diizinkan menggunakan Google Maps Client ID yang disediakan.

ID klien Premium Plan atau Maps APIs for Work yang disertakan dalam pemuatan skrip tidak valid, kedaluwarsa, atau alamat saat ini yang memuat Google Maps JavaScript API belum ditambahkan ke daftar URL yang diizinkan.

Lihat Mendaftarkan URL Resmi.

Kode Kesalahan Google Maps JavaScript API untuk Developer

Jika Anda menemukan kesalahan pada Konsol JavaScript Chrome, Konsol Web Firefox atau alat lain yang setara di browser Anda, lihat tabel di bawah ini untuk menemukan penjelasan kode kesalahan.

Ada 2 tipe kode kesalahan, kesalahan dan peringatan. Kesalahan menunjukkan masalah berat yang terjadi saat memuat Google Maps JavaScript API. Laman Anda tidak bisa memuat API dengan benar, dan API tidak akan bekerja pada laman itu. Peringatan adalah pesan tambahan mengenai pemuatan Google Maps JavaScript API. Peringatan menjelaskan beberapa kemungkinan penyebab kesalahan, atau menunjukkan potensi masalah dalam kode Anda yang memuat Google Maps JavaScript API. Jika Anda hanya menerima peringatan tanpa kesalahan, berarti API akan bekerja dengan benar pada laman tersebut. Namun kami menyarankan Anda untuk memperbaiki juga potensi masalah.

Kode Kesalahan Developer Tipe Keterangan
ApiNotActivatedMapError Kesalahan

Google Maps JavaScript API tidak diaktifkan pada proyek API Anda. Anda mungkin perlu mengaktifkan Google Maps JavaScript API pada API dalam Google API Console.

Lihat Memperoleh kunci API.

DeletedApiProjectMapError Kesalahan

Proyek API Anda mungkin telah dihapus dari Google API Console. Periksa proyek yang Anda gunakan untuk membuat kunci API yang disertakan dalam loader JavaScript API. Anda bisa membuat proyek API baru dan mendapatkan kunci baru di Google API Console.

Lihat Memperoleh kunci API.

ExpiredKeyMapError Kesalahan

Kunci API yang disertakan dalam elemen skrip yang memuat API telah kedaluwarsa. Anda mungkin perlu membuat kunci API baru di Google API Console.

Lihat Memperoleh kunci API.

InvalidClientIdMapError Kesalahan

ID klien yang dimasukkan dalam elemen skrip yang memuat API tidak valid atau kedaluwarsa. Pastikan Anda menggunakan ID klien dengan benar. ID klien harus dimulai dengan awalan "gme-". Jika Anda melihat kesalahan ini bahkan saat menggunakan ID klien dengan benar, berarti mungkin ID klien telah kedaluwarsa. Hubungi Google Account Manager Anda.

Jika tidak memiliki lisensi Premium Plan atau Maps APIs for Work, Anda perlu menggunakan parameter key dengan kunci API Anda sebagai ganti parameter client .

Lihat ID klien Anda

InvalidKeyMapError Kesalahan

Kunci API yang disertakan dalam elemen skrip yang memuat API tersebut tidak ditemukan. Pastikan Anda menggunakan kunci API yang benar. Anda bisa membuat kunci API baru pada Google API Console.

Lihat Memperoleh kunci API.

MissingKeyMapError Kesalahan

Elemen skrip yang memuat API tidak berisi parameter autentikasi yang diperlukan. Jika Anda menggunakan Maps JavaScript API standar, Anda harus menggunakan parameter key dengan kunci API yang valid. Jika Anda seorang pelanggan Premium Plan, Anda harus menggunakan parameter client dengan ID klien Anda atau parameter key dengan kunci API yang valid.

Lihat panduan untuk kunci API dan ID klien.

ProjectDeniedMapError Kesalahan

Permintaan Anda belum diselesaikan. Anda mungkin bisa menemukan detail selengkapnya tentang kesalahan tersebut dalam Google API Console.

Lihat Google API Console.

RefererDeniedMapError Kesalahan

Aplikasi Anda telah diblokir karena ketidakpatuhan pada Ketentuan Layanan Google Maps APIs, setelah sejumlah notifikasi email. Untuk mengajukan banding atas pemblokiran dan agar implementasi Anda ditinjau, isilah formulir ini. Anda akan menerima respons lewat email dalam waktu beberapa hari kerja.

RefererNotAllowedMapError Kesalahan

URL saat ini yang memuat Google Maps JavaScript API belum ditambahkan ke daftar referrer yang diperbolehkan. Periksa setelan referrer kunci API Anda di Google API Console.

Lihat kunci API di Google API Console. Untuk informasi selengkapnya, lihat Praktik terbaik untuk menggunakan kunci API secara aman.

OverQuotaMapError Kesalahan

Jumlah permintaan telah melebihi batas penggunaan untuk Google Maps JavaScript API. Permintaan aplikasi Anda akan bekerja lagi pada penyetelan ulang kuota harian berikutnya.

Untuk detail selengkapnya, lihat panduan untuk batas penggunaan. Laman ini juga menjelaskan cara mendapatkan batas penggunaan yang lebih tinggi.

ClientIdLooksLikeCryptoKey Peringatan

Anda mungkin telah memberikan kunci kriptografik dalam parameter client. Jika memiliki lisensi Premium Plan atau Maps APIs for Work, tetapkan ID klien Anda sebagai parameter client. Anda tidak perlu menggunakan kunci kriptografik untuk Google Maps JavaScript API.

Lihat panduan untuk ID klien bagi pelanggan Premium Plan dan Maps APIs for Work.

ClientIdLooksLikeKey Peringatan

Anda mungkin telah memberikan kunci API dalam parameter client. Jika memiliki lisensi Premium Plan atau Maps APIs for Work, tetapkan ID klien Anda sebagai parameter client. Jika Anda memiliki Google Maps APIs Premium Plan, Anda bisa menggunakan parameter client atau parameter key. Jika tidak memiliki lisensi, Anda harus menggunakan parameter key, sebagai ganti parameter client .

Lihat panduan untuk ID klien dan kunci API.

InvalidChannel Peringatan

Anda mungkin memberikan parameter channel yang tidak valid. Saluran tersebut harus berupa string alfanumerik ASCII berisi tanda titik (.), garis bawah (_) dan tanda hubung (-). Pastikan Anda menetapkan parameter channel yang valid.

Lihat Pelaporan | Google Maps APIs Premium Plan.

InvalidClientId Peringatan

Parameter client sepertinya tidak berisi ID klien yang benar. ID klien harus dimulai dengan "gme-".

Lihat panduan untuk ID klien bagi pelanggan Premium Plan atau Maps APIs for Work.

InvalidKey Peringatan

Kunci API yang disertakan dalam elemen skrip yang memuat API sepertinya tidak benar. Pastikan Anda menggunakan kunci API yang benar. Anda bisa membuat kunci API baru pada Google API Console.

Lihat Memperoleh kunci API.

InvalidVersion Peringatan

Anda mungkin telah memberikan nomor versi yang salah dalam elemen skrip. Pastikan Anda menggunakan nomor versi yang benar.

Lihat Penetapan Versi | Google Maps JavaScript API.

KeyLooksLikeClientId Peringatan Anda mungkin telah memberikan ID klien sebagai parameter key. Jika memiliki lisensi Premium Plan atau Maps APIs for Work, tetapkan ID klien Anda sebagai parameter client sebagai ganti parameter key. Jika Anda memiliki Google Maps APIs Premium Plan, Anda bisa menggunakan parameter client atau parameter key. Jika tidak memiliki lisensi, Anda harus menggunakan parameter key, sebagai ganti parameter client .

Lihat panduan untuk ID klien dan kunci API.

KeyLooksLikeCryptoKey Peringatan

Anda mungkin telah memberikan kunci kriptografik sebagai parameter key. Jika memiliki lisensi Premium Plan atau Maps APIs for Work, tetapkan ID klien Anda sebagai parameter client, dan buang parameter key dari elemen skrip Anda. Kunci kriptografik tidak diperlukan untuk Google Maps JavaScript API. Jika Anda memiliki Google Maps APIs Premium Plan, Anda bisa menggunakan parameter client atau parameter key. Jika tidak memiliki lisensi, Anda bisa mendapatkan kunci API gratis dari Google API Console.

Lihat panduan untuk ID klien dan kunci API.

KeyLooksLikeProjectNumber Peringatan

Anda mungkin telah memberikan nomor proyek sebagai parameter key. Pastikan Anda menggunakan kunci API yang benar. Anda bisa membuat kunci API baru pada Google API Console.

Lihat Memperoleh kunci API.

NoApiKeys Peringatan

Elemen skrip yang memuat API tidak memiliki kunci API. Pastikan Anda menyertakan kunci API yang valid sebagai parameter key. Anda bisa membuat kunci API baru pada Google API Console.

Lihat Memperoleh kunci API.

RetiredVersion Peringatan

Anda mungkin telah memberikan versi yang tidak bekerja dalam elemen skrip. Versi 3.0 - 3.24 sudah tidak bekerja, dan Anda mungkin menerima 3.25 sebagai gantinya. Perbarui aplikasi Anda untuk menggunakan salah satu versi yang tersedia.

Lihat Penetapan Versi | Google Maps JavaScript API.

SensorNotRequired Peringatan

Parameter sensor tidak lagi diperlukan untuk Google Maps JavaScript API. Ini tidak akan menghalangi Google Maps JavaScript API bekerja dengan benar, namun kami menyarankan Anda membuang parameter sensor dari elemen skrip.

SignatureNotRequired Peringatan

Parameter signature tidak diperlukan untuk Google Maps JavaScript API. Ini tidak akan menghalangi Google Maps JavaScript API bekerja dengan benar, namun mungkin menimbulkan risiko keamanan. Hilangkan dari elemen skrip Anda.

SignedInDeprecated Peringatan

Parameter signed_in tidak digunakan lagi dan akan diabaikan dalam Google Maps JavaScript API versi mendatang. Ini tidak akan mencegah Google Maps JavaScript API bekerja setelah mode signed-in dipensiunkan, namun perilaku aplikasi Anda mungkin berubah, jika Anda mengandalkan pada fitur signed-in saat ini.

Tinjaulah aplikasi Anda dan lihat Peta yang Dimasuki | Google Maps JavaScript API untuk detail tentang perubahan mendatang.

UrlAuthenticationCommonError Kesalahan

Terjadi kesalahan yang tidak masuk dalam kategori lainnya pada laman ini. Mungkin disebabkan oleh masalah sementara. Coba lagi permintaan tersebut setelah beberapa saat. Jika Anda tidak mengatasi masalah tersebut, tinjaulah panduan developer untuk memastikan permintaan memiliki format yang tepat.

Memeriksa Kesalahan di Browser Anda

Google Maps JavaScript API menulis pesan kesalahan ke window.console. Bagian ini menjelaskan cara memeriksa keluaran window.console di Google Chrome. Jika Anda menggunakan browser lain, periksa dokumentasi developer untuk browser Anda. Untuk referensi Anda, inilah daftar alat (bantu) untuk memeriksa keluaran window.console di beberapa browser lainnya.

Di Chrome, Anda bisa menggunakan Konsol JavaScript untuk memeriksa keluaran 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 kesalahan atau peringatan saat memuat Google Maps JavaScript API, maka akan muncul berupa 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 bisa memeriksa tabel kode kesalahan di atas untuk menemukan kode kesalahan dalam pesan kesalahan. Anda juga bisa menemukan detail tentang pesan kesalahan dalam dokumen API yang ditautkan dari pesan tersebut.

Catatan: Anda bisa memantau kesalahan autentikasi lewat program.

Kirim masukan tentang...

Google Maps JavaScript API
Google Maps JavaScript API
Butuh bantuan? Kunjungi halaman dukungan kami.