Jawaban singkat
Aktifkan Maps JavaScript API di Google Cloud console, buka Google Maps Platform > Keys & Credentials, klik Create credentials > API key, lalu pilih Create. Sebelum dipasang di website, batasi kunci dengan Select API restrictions dan batasan situs (HTTP referrer). Kunci standar butuh project dengan penagihan aktif, tetapi tiap layanan punya kuota gratis bulanan.
Artikel ini menjelaskan cara membuat kunci API Google Maps untuk website, cara membatasinya supaya tidak disalahgunakan, dan berapa biaya yang perlu Anda perhitungkan. Semua langkah dicek ke dokumentasi resmi Google pada 28 Oktober 2026.
Yang perlu disiapkan sebelum membuat kunci
| Kebutuhan | Keterangan |
|---|---|
| Akun Google | Dipakai untuk masuk ke Google Cloud console |
| Project Google Cloud | Wadah kunci dan API. Buat baru jika belum punya |
| Akun penagihan | Wajib untuk kunci standar. Dibuat dari halaman Billing |
| Alamat website | Untuk batasan HTTP referrer, misalnya https://namausaha.com |
Google juga menyediakan Maps Demo Key untuk mencoba fitur tertentu tanpa data penagihan. Kunci itu hanya untuk uji coba dan prototipe, bukan untuk website yang sudah tayang.
Cara membuat Google Maps API key, langkah demi langkah
Panel di Google Cloud console tampil dalam bahasa Inggris pada dokumentasi resmi, jadi nama menu di bawah memakai label aslinya. Alur ini untuk Maps JavaScript API, yaitu peta interaktif di website. Dokumentasi resmi hanya menjelaskan alur lewat console di browser, bukan lewat aplikasi di HP.
SkemaTampilan Google Cloud console yang disederhanakan
Aktifkan Maps JavaScript API
Buka halaman Maps JavaScript API di Google Cloud console dan klik Enable. Jika tombolnya berubah menjadi Manage, API sudah aktif. Setelah diaktifkan, tunggu beberapa menit sebelum permintaan pertama berhasil.
Buka Keys & Credentials
Masuk ke Google Maps Platform > Keys & Credentials. Pilih project Anda jika diminta.
Klik Create credentials > API key
Klik Create credentials, lalu pilih API key. Panel Create API key akan terbuka.
Pilih API restrictions
Di panel itu, buka Select API restrictions, hapus centang API yang tidak Anda butuhkan, dan biarkan Maps JavaScript API tetap terpilih.
Klik Create
Klik Create. Panel menampilkan kunci baru. Untuk melihatnya lagi nanti, buka Keys & Credentials dan klik Show key.
Cara membatasi kunci supaya tidak disalahgunakan
Kunci Maps untuk website terlihat di kode halaman, jadi siapa pun bisa menyalinnya. Karena itu pembatasan bukan opsional. Google menulis bahwa Anda bertanggung jawab secara finansial atas tagihan yang timbul dari penyalahgunaan kunci yang tidak dibatasi.
SkemaTampilan Google Cloud console yang disederhanakan
Dua batasan yang perlu Anda atur:
- Batasan API: hanya izinkan API yang benar-benar dipakai. Untuk kunci Maps JavaScript API, API itu harus tetap termasuk.
- Batasan aplikasi: pilih Situs (HTTP referrer) untuk website. Tulis alamat lengkap dengan skema, misalnya
https://namausaha.com. Gunakanhttps://*.namausaha.comuntuk mengizinkan semua subdomain. Jangan menulis jalur halaman, karena browser biasanya menghapusnya dari permintaan lintas asal.
Untuk kunci yang dipakai server (bukan website), pilih batasan alamat IP. Kunci layanan web seperti itu tidak boleh terlihat publik. Simpan di variabel lingkungan, jangan di kode yang masuk ke GitHub. Google juga menyarankan satu kunci per aplikasi dan menghapus kunci yang tidak terpakai.
Berapa biaya Google Maps API untuk website
Harga dihitung per 1.000 permintaan (peristiwa yang dapat ditagih) dan per bulan, dalam dolar AS. Tiap layanan punya kuota gratis sendiri. Tabel di bawah dari daftar harga global Google yang dicek 28 Oktober 2026.
| Layanan | Kuota gratis per bulan | Harga setelahnya (per 1.000) |
|---|---|---|
| Dynamic Maps (peta interaktif) | 10.000 | USD 7,00 |
| Static Maps (gambar peta) | 10.000 | USD 2,00 |
| Embed dan Maps SDK | Tanpa batas | Tidak ditagih |
| Geocoding | 10.000 | USD 5,00 |
| Place Details Essentials | 10.000 | USD 5,00 |
Essentials
Essentials
Essentials
Pro
Pro
Sumber: Daftar harga layanan inti Google Maps Platform, dicek 28 Oktober 2026
Contoh hitungan untuk kafe di Gading Serpong (ilustrasi, bukan data nyata): website kafe menampilkan satu peta di halaman Lokasi, dan halaman itu dibuka 3.000 kali sebulan. Setiap pemuatan peta dihitung satu peristiwa, jadi 3.000 masih di bawah kuota gratis 10.000. Kalau halaman itu dibuka 25.000 kali, 15.000 sisanya ditagih sekitar USD 7,00 per 1.000, yaitu kira-kira USD 105 per bulan menurut tarif tingkat pertama. Kurs rupiah tidak dicantumkan karena berubah-ubah.
Atur juga pemberitahuan anggaran dan kuota penggunaan di Google Cloud console, supaya lonjakan tagihan terdeteksi lebih awal.
Jika kunci tidak berfungsi
Pesan error yang paling sering muncul
ApiNotActivatedMapError
Kemungkinan penyebab: Maps JavaScript API belum diaktifkan di project Anda.
Solusi: Buka Google Cloud console, klik Enable pada Maps JavaScript API, lalu tunggu beberapa menit.
BillingNotEnabledMapError
Kemungkinan penyebab: Penagihan belum aktif di project tersebut.
Solusi: Aktifkan akun penagihan pada project dari halaman Billing.
RefererNotAllowedMapError
Kemungkinan penyebab: Alamat website belum ada di daftar HTTP referrer kunci.
Solusi: Tambahkan alamat website, lengkap dengan https://, ke batasan situs kunci.
InvalidKeyMapError
Kemungkinan penyebab: Kunci di kode tidak ditemukan atau salah salin.
Solusi: Salin ulang lewat Show key, atau buat kunci baru.
MissingKeyMapError
Kemungkinan penyebab: Skrip Maps tidak membawa parameter kunci.
Solusi: Tambahkan key=KUNCI_ANDA pada alamat skrip Maps JavaScript API.
Pertanyaan yang sering ditanyakan
Apakah Google Maps API key gratis?
Membuat kunci gratis, tetapi kunci standar butuh project dengan penagihan aktif. Penggunaan baru ditagih setelah melewati kuota gratis bulanan tiap layanan, misalnya 10.000 pemuatan Dynamic Maps. Untuk uji coba tanpa data penagihan, Google menyediakan Maps Demo Key, khusus prototipe.
Apakah bisa membuat Google Maps API key tanpa kartu kredit?
Untuk kunci standar, project harus punya penagihan aktif. Yang tidak meminta data penagihan hanyalah Maps Demo Key untuk uji coba fitur tertentu. Kunci itu tidak untuk website yang sudah tayang.
Di mana saya melihat kunci yang sudah dibuat?
Buka Google Maps Platform > Keys & Credentials, lalu klik Show key pada kunci yang Anda cari.
Apakah kunci Maps boleh terlihat di kode website?
Kunci untuk Maps JavaScript API memang terlihat di halaman, jadi wajib dibatasi dengan HTTP referrer dan batasan API. Kunci layanan web untuk server tidak boleh terlihat publik.
Apa bedanya Embed dengan Dynamic Maps dari sisi biaya?
Menurut daftar harga Google per 28 Oktober 2026, Embed tanpa batas pemakaian gratis, sedangkan Dynamic Maps punya kuota gratis 10.000 per bulan lalu ditagih. Kalau Anda hanya perlu menampilkan lokasi usaha, cara menambahkannya ada di panduan menambahkan lokasi di Google Maps.
Baca juga
- Cara menambahkan lokasi usaha di Google Maps
- Cara verifikasi Google Bisnisku
- Jasa pembuatan Google Bisnisku
- Paket Nova Tech untuk website dan aplikasi
Sumber
- Menyiapkan Maps JavaScript API — Google for Developers · diakses 28 Oktober 2026
- Praktik Terbaik Keamanan API — Google Maps Platform · diakses 28 Oktober 2026
- Daftar harga layanan inti Google Maps Platform · diakses 28 Oktober 2026
- Pesan error Maps JavaScript API — Google for Developers · diakses 28 Oktober 2026



