Cara Membuat Google Maps API Key untuk Website: Langkah, Batasi Kunci, dan Biaya

Cara membuat Google Maps API key untuk website: aktifkan Maps JavaScript API, buat kunci, batasi dengan HTTP referrer, dan hitung kuota gratis serta biaya per bulan.

Oleh Ibrahim Kamara6 menit baca

Ilustrasi cara membuat Google Maps API key untuk website usaha

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

KebutuhanKeterangan
Akun GoogleDipakai untuk masuk ke Google Cloud console
Project Google CloudWadah kunci dan API. Buat baru jika belum punya
Akun penagihanWajib untuk kunci standar. Dibuat dari halaman Billing
Alamat websiteUntuk 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

console.cloud.google.com/google/maps-apis
Keys & Credentials2
Maps JavaScript APIEnable atau Manage
Enable1
Create credentials3
API key3
Show keyUntuk melihat kunci nanti
Skema alur di console: aktifkan API, buka Keys & Credentials, lalu buat kunci · Skema, bukan tangkapan layar: tampilan aslinya bisa berbeda. Alur dicek di Google for Developers: Menyiapkan Maps JavaScript API.
  1. 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.

  2. Buka Keys & Credentials

    Masuk ke Google Maps Platform > Keys & Credentials. Pilih project Anda jika diminta.

  3. Klik Create credentials > API key

    Klik Create credentials, lalu pilih API key. Panel Create API key akan terbuka.

  4. Pilih API restrictions

    Di panel itu, buka Select API restrictions, hapus centang API yang tidak Anda butuhkan, dan biarkan Maps JavaScript API tetap terpilih.

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

console.cloud.google.com/apis/credentials
Create API keyPanel pembuatan kunci
Select API restrictionsMaps JavaScript API4
Set an application restrictionWebsite (HTTP referrer)
Create5
Skema panel pembuatan kunci: batasan API dan batasan aplikasi · Skema, bukan tangkapan layar: tampilan aslinya bisa berbeda. Alur dicek di Google for Developers: Praktik Terbaik Keamanan API.

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. Gunakan https://*.namausaha.com untuk 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.

LayananKuota gratis per bulanHarga setelahnya (per 1.000)
Dynamic Maps (peta interaktif)10.000USD 7,00
Static Maps (gambar peta)10.000USD 2,00
Embed dan Maps SDKTanpa batasTidak ditagih
Geocoding10.000USD 5,00
Place Details Essentials10.000USD 5,00
Kuota gratis per bulan menurut layanan Google Maps Platform
Dynamic Maps10.000 permintaan

Essentials

Static Maps10.000 permintaan

Essentials

Geocoding10.000 permintaan

Essentials

Place Details Pro5.000 permintaan

Pro

Text Search Pro5.000 permintaan

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

Paket Nova Media LabNova TechKalau Anda ingin peta, formulir, atau toko online di website usaha dikerjakan dan dirawat tim, Nova Tech membangunnya dan mengurus hal teknis seperti kunci API dan tagihan.Mulai Rp 25.000.000 per proyek

Ditulis oleh

Ibrahim Kamara · Founder, Nova Media Lab

Pendiri Nova Media Lab, agensi digital marketing dan studio konten di Park Avenue, Tangerang. Sehari-hari menangani media sosial, Google Maps, iklan Meta dan TikTok, serta produksi konten untuk usaha lokal di Serpong, Lippo Village, dan Legok.

Cara artikel ini dibuat

Disusun dengan bantuan AI dari riset dan sumber resmi yang kami tautkan, lalu dibaca ulang dan divalidasi oleh Ibrahim Kamara sebelum terbit, sesuai kebijakan redaksi kami.

Artikel terkait

Siap terlihat?

Ceritakan usaha Anda. Konsultasi pertama gratis, tanpa kewajiban.