API Gempa & Cuaca BMKG: Notifikasi Gempa dan Widget Cuaca
Oleh Tim APIPedia, Tim Engineering APIPedia · Terbit · Diperbarui · 9 menit baca
API gempa dan cuaca BMKG di APIPedia: gempa terkini, M5+, gempa dirasakan, dan prakiraan cuaca per kelurahan dalam JSON rapi lewat satu API key.

API gempa dan cuaca BMKG di APIPedia terdiri dari empat endpoint REST. Keempatnya meneruskan data terbuka BMKG dalam bentuk JSON yang sudah dirapikan: gempa terkini, daftar gempa bermagnitudo 5 ke atas, gempa yang dirasakan masyarakat, dan prakiraan cuaca per kelurahan/desa. Satu API key APIPedia sudah cukup untuk memanggil keempatnya.
Artikel ini menjelaskan cara memanggil keempat endpoint tersebut dan arti setiap field di responsnya. Setelah itu ada dua contoh pemakaian yang paling sering dicari, yaitu notifikasi gempa terbaru dan widget cuaca kecil untuk halaman web.
Apa saja endpoint API gempa dan cuaca BMKG di APIPedia?
Keempat endpoint memakai metode GET dan berada di bawah base URL https://api.apipedia.id/v1. Data gempa berasal dari umpan terbuka BMKG di data.bmkg.go.id, sedangkan prakiraan cuaca berasal dari API prakiraan cuaca publik BMKG. APIPedia tidak memproduksi data gempa atau cuaca sendiri. Tugasnya hanya meneruskan data tersebut dan merapikan bentuknya.
| Endpoint | Isi | Umpan BMKG | Parameter |
|---|---|---|---|
/gempa/terkini | Satu gempa terakhir yang tercatat | autogempa.json | Tidak ada |
/gempa/m5 | Daftar gempa terakhir bermagnitudo 5 ke atas | gempaterkini.json | Tidak ada |
/gempa/dirasakan | Daftar gempa yang guncangannya dilaporkan masyarakat | gempadirasakan.json | Tidak ada |
/cuaca | Prakiraan cuaca satu kelurahan/desa | API prakiraan cuaca publik | adm4 (wajib) |
Semua respons dibungkus amplop yang sama, yaitu { is_success, message, data }. Objek data selalu memuat field source dengan nilai "BMKG", ditambah field cached yang memberi tahu apakah jawaban tersebut diambil dari cache.
Bagaimana cara mulai memakai API gempa BMKG?
Setiap endpoint mewajibkan autentikasi dengan Bearer token. Langkahnya singkat:
- Daftar atau masuk di console.apipedia.id.
- Buka menu Token API dan buat kunci baru. Kunci ini selalu diawali
apk_. - Simpan kunci di variabel lingkungan atau secret manager. Jangan menaruhnya di kode frontend yang bisa dibuka publik.
- Kirim header
Authorization: Bearer apk_xxxsetiap kali memanggil endpoint. - Cek nilai
is_successlebih dulu sebelum membacadata.
Paket Free gratis selamanya. Kuotanya 500 request per hari dengan rate limit 10 request per detik. Kuota ini biasanya cukup untuk notifikasi gempa atau widget cuaca skala kecil, selama API tidak dipanggil di setiap kunjungan halaman.
Bagaimana mengambil gempa terkini dari BMKG lewat API?
/gempa/terkini mengembalikan satu kejadian saja, yaitu gempa terakhir yang tercatat di umpan autogempa BMKG. Endpoint ini paling pas untuk banner "gempa terbaru" atau sebagai pemicu notifikasi.
curl https://api.apipedia.id/v1/gempa/terkini \
-H "Authorization: Bearer apk_xxx"
Contoh bentuk responsnya:
{
"is_success": true,
"message": "Data gempa terkini berhasil diambil — Data: BMKG",
"data": {
"gempa": {
"tanggal": "2026-09-15T16:12:48+00:00",
"tanggal_lokal": "15 Sep 2026 23:12:48 WIB",
"magnitude": 4.2,
"kedalaman_km": 34,
"koordinat": { "lat": -4.36, "lon": 101.99 },
"lintang": "4.36 LS",
"bujur": "101.99 BT",
"wilayah": "Pusat gempa berada di laut 72 km barat daya Seluma",
"potensi": "Gempa ini dirasakan untuk diteruskan pada masyarakat",
"dirasakan": "II-III Bengkulu",
"shakemap": "https://data.bmkg.go.id/DataMKG/TEWS/20260915231248.mmi.jpg"
},
"source": "BMKG",
"cached": false
}
}
Field respons gempa
Ketiga endpoint gempa mengembalikan objek dengan bentuk yang sama. Jika sebuah field tidak tersedia di umpan tertentu, field itu tetap muncul dengan nilai null dan tidak dihilangkan. Karena itu satu kode parsing bisa dipakai untuk ketiganya.
| Field | Tipe | Keterangan |
|---|---|---|
tanggal | string | Waktu kejadian dalam format ISO 8601 (UTC) |
tanggal_lokal | string | Tanggal dan jam sesuai teks BMKG, mis. "15 Sep 2026 23:12:48 WIB" |
magnitude | number | Magnitudo, sudah dalam bentuk angka |
kedalaman_km | number | Kedalaman dalam kilometer, tanpa teks satuan |
koordinat | object | { lat, lon } yang langsung bisa dipakai di peta |
lintang, bujur | string | Teks asli dari BMKG, mis. "4.36 LS" |
wilayah | string | Deskripsi lokasi pusat gempa |
potensi | string/null | Keterangan potensi tsunami atau status gempa |
dirasakan | string/null | Skala MMI dan daerah yang melaporkan guncangan |
shakemap | string/null | URL lengkap gambar shakemap BMKG |
Apa beda /gempa/m5 dan /gempa/dirasakan?
Berbeda dengan /gempa/terkini, kedua endpoint ini mengembalikan daftar. Bentuk data-nya adalah { jumlah, gempa: [...], source, cached }, dan jumlah menunjukkan banyaknya item di dalam larik.
/gempa/m5 meneruskan umpan gempaterkini.json dari BMKG, yang berisi gempa-gempa terakhir bermagnitudo 5 ke atas. Field potensi di endpoint ini terisi, contohnya "Tidak berpotensi tsunami". Sebaliknya, dirasakan dan shakemap umumnya bernilai null. Endpoint ini cocok untuk dasbor yang memantau gempa signifikan.
/gempa/dirasakan meneruskan umpan gempadirasakan.json. Field utamanya adalah dirasakan, yang berisi skala MMI beserta daerah yang melaporkan guncangan, sedangkan potensi bisa bernilai null. Gunakan endpoint ini jika penggunamu lebih ingin tahu "apakah gempanya terasa di daerah saya" daripada seberapa besar magnitudonya.
curl https://api.apipedia.id/v1/gempa/m5 \
-H "Authorization: Bearer apk_xxx"
curl https://api.apipedia.id/v1/gempa/dirasakan \
-H "Authorization: Bearer apk_xxx"
Seberapa baru data gempa dari API ini?
API ini bukan sistem peringatan dini dan tidak menjanjikan data realtime. Respons dari umpan BMKG disimpan di memori selama lima menit. Akibatnya, data yang kamu terima bisa terlambat sampai sekitar lima menit dibanding pembaruan terakhir di BMKG. Jika field cached bernilai true, artinya jawaban itu berasal dari cache.
BMKG memperbarui umpan tersebut setiap kali ada kejadian baru. Untuk informasi resmi dan peringatan tsunami, arahkan pengguna ke kanal resmi BMKG. Cantumkan juga atribusi "Data: BMKG" di aplikasimu.
Bagaimana membuat notifikasi gempa terbaru?
Caranya sederhana. Panggil /gempa/terkini secara berkala dari server dan simpan penanda kejadian terakhir, yaitu field tanggal. Kirim notifikasi hanya jika penanda itu berubah. Karena ada cache lima menit, polling yang lebih sering dari lima menit tidak akan menghasilkan data lebih baru dan hanya menghabiskan kuota.
const API = "https://api.apipedia.id/v1";
const KEY = process.env.APIPEDIA_KEY; // apk_xxx
let tanggalTerakhir = null;
async function cekGempa() {
const res = await fetch(`${API}/gempa/terkini`, {
headers: { Authorization: `Bearer ${KEY}` },
});
const body = await res.json();
if (!body.is_success) {
console.error("Gagal:", body.message);
return;
}
const g = body.data.gempa;
if (g.tanggal === tanggalTerakhir) return; // belum ada kejadian baru
tanggalTerakhir = g.tanggal;
if (g.magnitude >= 5) {
kirimNotifikasi(
`Gempa M${g.magnitude} - ${g.wilayah} (${g.tanggal_lokal}). ` +
`Kedalaman ${g.kedalaman_km} km. ${g.potensi ?? ""} Data: BMKG`
);
}
}
function kirimNotifikasi(teks) {
// Ganti dengan Telegram, WhatsApp, email, atau push notification
console.log(teks);
}
cekGempa();
setInterval(cekGempa, 10 * 60 * 1000); // tiap 10 menit
Dengan interval 10 menit, jumlah request sekitar 144 per hari, masih di bawah kuota paket Free yang 500 request/hari. Ambang magnitude >= 5 boleh kamu ubah. Kamu juga bisa mengganti filternya dengan mencocokkan nama daerah pada field dirasakan.
Bagaimana cara memakai API cuaca BMKG?
/cuaca mengembalikan prakiraan cuaca untuk satu kelurahan/desa. Parameter adm4 wajib diisi dengan kode wilayah tingkat kelurahan/desa yang berpola dd.dd.dd.dddd. Contohnya 31.71.03.1001 untuk Kemayoran, Jakarta Pusat.
BMKG hanya melayani level adm4. Kode kecamatan tidak bisa dipakai, dan APIPedia juga tidak menebaknya secara otomatis. Jika kamu belum punya kode kelurahan, baca panduan API data wilayah dan kode pos Indonesia.
curl "https://api.apipedia.id/v1/cuaca?adm4=31.71.03.1001" \
-H "Authorization: Bearer apk_xxx"
Field respons cuaca
Objek data berisi tiga bagian. Pertama lokasi (adm4, provinsi, kabupaten_kota, kecamatan, desa, lat, lon, zona_waktu), lalu jumlah, dan terakhir larik prakiraan. Prakiraan dari BMKG sudah diratakan menjadi satu deret per jam.
| Field prakiraan | Keterangan |
|---|---|
waktu | Waktu lokal, mis. "2026-09-16 00:00:00" |
waktu_utc | Waktu dalam UTC |
suhu_c | Suhu dalam derajat Celsius |
kelembapan | Kelembapan udara (%) |
cuaca_desc | Deskripsi cuaca, mis. "Cerah" |
arah_angin | Arah angin, mis. "E" |
kecepatan_angin | Kecepatan angin (angka) |
jarak_pandang | Teks jarak pandang, mis. "> 10 km" |
Prakiraan untuk setiap kode disimpan di cache selama 30 menit. Alasannya, BMKG menerbitkan analisis harian, sehingga memanggil ulang terlalu sering tidak akan menghasilkan angka baru.
Bagaimana membuat widget cuaca sederhana?
Hindari memanggil API langsung dari browser, karena API key bisa dilihat siapa saja. Sebagai gantinya, buat endpoint kecil di server yang meneruskan permintaan, lalu biarkan frontend memanggil endpoint tersebut. Contoh di bawah ini memakai handler bergaya Express:
// server: GET /widget-cuaca?adm4=31.71.03.1001
app.get("/widget-cuaca", async (req, res) => {
const adm4 = String(req.query.adm4 ?? "");
const r = await fetch(
`https://api.apipedia.id/v1/cuaca?adm4=${encodeURIComponent(adm4)}`,
{ headers: { Authorization: `Bearer ${process.env.APIPEDIA_KEY}` } }
);
const body = await r.json();
if (!body.is_success) return res.status(r.status).json(body);
const { lokasi, prakiraan } = body.data;
res.json({
tempat: `${lokasi.desa}, ${lokasi.kabupaten_kota}`,
jam: prakiraan.slice(0, 6).map((p) => ({
waktu: p.waktu.slice(11, 16),
suhu: p.suhu_c,
cuaca: p.cuaca_desc,
})),
atribusi: "Data: BMKG",
});
});
Di sisi frontend, panggil /widget-cuaca lalu tampilkan enam jam pertama sebagai baris berisi jam, suhu, dan deskripsi cuaca. Simpan hasilnya beberapa menit di cache server milikmu sendiri supaya kuota harian tidak habis dipakai oleh lalu lintas pengunjung.
Error apa yang perlu ditangani?
- 400: parameter
adm4kosong atau formatnya tidak cocok dengan poladd.dd.dd.dddd. - 404: formatnya sudah benar, tetapi kode tersebut tidak ada di data prakiraan BMKG.
- 502: sumber data BMKG tidak bisa dihubungi atau menolak permintaan, misalnya dengan pesan "Sumber data gempa (BMKG) tidak bisa dihubungi saat ini."
Jika menerima 502, tampilkan data terakhir yang sudah kamu simpan dan coba lagi beberapa saat kemudian. Jangan mengulang permintaan dalam loop yang rapat.
Pertanyaan yang sering diajukan
Apakah API gempa BMKG di APIPedia gratis?
Ya. Keempat endpoint bisa dipakai dengan paket Free yang gratis selamanya, dengan kuota 500 request per hari dan rate limit 10 request per detik. Kamu hanya perlu membuat API key di menu Token API pada konsol.
Apakah data gempanya realtime?
Tidak sepenuhnya. Data diteruskan dari umpan BMKG dan disimpan di cache selama lima menit, jadi bisa terlambat beberapa menit. Untuk peringatan dini tsunami, rujuk kanal resmi BMKG.
Kenapa /cuaca menolak kode kecamatan?
API prakiraan cuaca publik BMKG hanya melayani level adm4 (kelurahan/desa). APIPedia sengaja tidak menebak kelurahan dari kode kecamatan, karena kode hasil tebakan bisa saja ditolak BMKG.
Bisakah saya memanggil API ini dari asisten AI?
Bisa. APIPedia menyediakan server MCP, sehingga asisten seperti Claude bisa memanggil data gempa dan cuaca. Panduannya ada di artikel menghubungkan APIPedia ke Claude lewat MCP.
Apakah saya wajib mencantumkan sumber data?
Data ini berasal dari BMKG, dan setiap respons menyertakan source: "BMKG". Sebaiknya cantumkan atribusi "Data: BMKG" di tampilan aplikasimu supaya pengguna tahu dari mana informasinya berasal.
Coba sekarang
Buat akun di console.apipedia.id, ambil API key dari menu Token API, lalu jalankan perintah curl /gempa/terkini di atas. Data gempa dan cuaca BMKG langsung tersedia dalam JSON yang rapi, siap dipakai untuk notifikasi, dasbor, atau widget. Kalau butuh data lain, baca juga cara cek ongkir lewat API.
Topik: #api gempa #api cuaca #bmkg #tutorial api #javascript
Tentang penulis
Tim APIPedia — Tim Engineering APIPedia
Tim engineering di balik APIPedia yang membangun dan memelihara API data Indonesia - ongkir, OCR KTP, data wilayah, BMKG, hingga server MCP - dan menulis panduan integrasinya dari pengalaman langsung.