Lewati ke isi dokumentasi
Peta SIPAGA Kaltim

API Data Terbuka

Semua angka yang tampil di peta SIPAGA Kaltim — indeks kerawanan kebakaran untuk 210 wilayah pantau dan titik panas satelit — tersedia sebagai JSON dan GeoJSON. Tanpa kunci, tanpa pendaftaran.

Alamat dasar
https://sipaga.bontangtechnohub.com/api/v1
Format
JSON, GeoJSON (RFC 7946)
Akses
Hanya-baca, tanpa kunci
Batas laju
60 permintaan/menit per IP
Lisensi indeks
CC BY 4.0

Mulai cepat

Setiap sumber daya adalah berkas yang dibuat ulang setelah pipeline SIPAGA berjalan. Ambil dengan GET biasa; tidak ada parameter kueri, jadi penyaringan dilakukan di sisi Anda.

curl

curl -s https://sipaga.bontangtechnohub.com/api/v1/ringkasan.json

JavaScript (peramban atau Node 18+)

const res = await fetch("https://sipaga.bontangtechnohub.com/api/v1/kabupaten.json");
if (res.status === 429) {
  const detik = Number(res.headers.get("Retry-After") ?? 60);
  throw new Error(`Batas laju tercapai, coba lagi dalam ${detik} detik`);
}
const { meta, data } = await res.json();
for (const k of data) console.log(k.nama, k.nilai_tertinggi, k.kelas_tertinggi);

Python

import requests

r = requests.get("https://sipaga.bontangtechnohub.com/api/v1/titik-panas-24jam.geojson", timeout=30)
r.raise_for_status()
geo = r.json()
print(geo["metadata"]["jumlah"], "titik panas dalam 24 jam terakhir")

QGIS dan perangkat GIS lain

Pilih Layer → Add Layer → Add Vector Layer, sumber Protocol: HTTP(S), lalu tempel alamat https://sipaga.bontangtechnohub.com/api/v1/wilayah.geojson. Atribut setiap poligon sama dengan isi wilayah.json.

Contoh respons: ringkasan.json

Diambil dari data 28 September 2026 dan dipersingkat (tanda …). Nilainya berubah setiap pembaruan.

{
  "meta": {
    "versi_api": "1",
    "diperbarui": "2026-09-28T12:49+08:00",
    "dokumentasi": "https://sipaga.bontangtechnohub.com/api/",
    "lisensi": {
      "indeks": "CC BY 4.0 (dihitung dari data cuaca Open-Meteo, CC BY 4.0)",
      "…": "…"
    },
    "atribusi": "Sumber: SIPAGA Kaltim, Bontang Techno Hub (https://sipaga.bontangtechnohub.com)",
    "tanggal_data": "2026-09-28",
    "titik_panas_diperbarui": "2026-09-28T15:05+08:00"
  },
  "data": {
    "tanggal_data": "2026-09-28",
    "luas_per_kelas_pct": {
      "Rendah": 2.7,
      "Sedang": 12.0,
      "Tinggi": 32.2,
      "Sangat Tinggi": 53.1
    },
    "kabupaten_terawan": {
      "nama": "Kabupaten Paser",
      "nilai": 296.0,
      "kelas": "Sangat Tinggi",
      "pct_tinggi_ke_atas": 100.0
    },
    "peringatan": {
      "judul": "Kerawanan kebakaran tinggi meluas di Kalimantan Timur",
      "isi": "Sekitar 53% luas daratan Kalimantan Timur berada pada kelas …",
      "wilayah": [
        "Kabupaten Paser",
        "Kota Balikpapan",
        "…"
      ]
    },
    "jumlah_petak": 194,
    "jumlah_khg": 16,
    "titik_panas_24jam": 646,
    "batas_kelas": {
      "Rendah": [
        0,
        75
      ],
      "Sedang": [
        76,
        150
      ],
      "Tinggi": [
        151,
        225
      ],
      "Sangat Tinggi": [
        226,
        300
      ]
    },
    "metode": {
      "nama": "KBDI",
      "skala": [
        0,
        300
      ],
      "keterangan": "Indeks Kekeringan Keetch-Byram yang diskalakan untuk gambut tropis; angka tinggi berarti lahan siap terbakar, bukan sedang terbakar."
    }
  }
}

Sumber daya

Semua jalur relatif terhadap https://sipaga.bontangtechnohub.com/api/v1. Jadwal dalam WITA. Ukuran adalah ukuran unduhan setelah kompresi gzip.

JalurIsiPembaruanUkuran
/Daftar sumber daya, waktu pembaruan, lisensitiap pembaruan1 KB
/ringkasan.jsonSebaran luas per kelas, peringatan meluas, kab/kota paling rawantiap run model cuaca baru; titik panas saat ada deteksi baru1 KB
/kabupaten.jsonSepuluh kab/kota: angka tertinggi, sebaran luas per kelas, titik panas 24 jamtiap run model cuaca baru; titik panas saat ada deteksi baru1 KB
/kabupaten.geojsonBatas kab/kota beserta atribut yang sama (GIS)tiap run model cuaca baru; titik panas saat ada deteksi baru35 KB
/kabupaten/{kode}.jsonSatu kab/kota dan semua wilayah pantau di dalamnyatiap run model cuaca baru; titik panas saat ada deteksi baru1 KB
/wilayah.json210 wilayah pantau (16 KHG, 194 petak) dengan angka terkinitiap run model cuaca baru; titik panas saat ada deteksi baru9 KB
/wilayah.geojsonPoligon 210 wilayah beserta atributnya (GIS)tiap run model cuaca baru; titik panas saat ada deteksi baru48 KB
/wilayah/{id}.jsonSatu wilayah dengan riwayat 90 hari dan prakiraantiap run model cuaca baru; titik panas saat ada deteksi baru1 KB
/wilayah-riwayat.jsonRiwayat dan prakiraan seluruh wilayah dalam satu berkastiap run model cuaca baru92 KB
/titik-panas-24jam.geojsonTitik panas 24 jam, kepercayaan sedang dan tinggisaat ada deteksi baru13 KB
/titik-panas.geojsonTitik panas 7 hari, semua tingkat kepercayaansaat ada deteksi baru147 KB
/status.jsonKesegaran data: kapan indeks dihitung, run model cuaca yang dipakai, kapan titik panas terakhir dicek dan berubahtiap 10 menit1 KB
/openapi.jsonSpesifikasi OpenAPI 3.1saat versi berubah5 KB

{kode} adalah kode wilayah Kemendagri, misalnya 64.74 untuk Kota Bontang. {id} adalah id dari wilayah.json, misalnya khg-64-02-08-01. Akhiran .json boleh dihilangkan.

Butuh data banyak wilayah? Ambil satu berkas gabungan (wilayah.json atau wilayah-riwayat.json) alih-alih 210 berkas satu per satu; yang kedua akan terbentur batas laju.

Kamus data

Angka dan kelas kerawanan

nilai adalah Indeks Kekeringan Keetch-Byram (KBDI) yang diskalakan untuk gambut tropis, dari 0 (tanah jenuh air) sampai 300 (kering maksimum). Angka tinggi berarti lahan siap terbakar bila ada sumber api, bukan bahwa kebakaran sedang terjadi.

kelasRentang nilaiArtinya
Rendah0–75Lahan lembap; api sulit menyala dan menjalar
Sedang76–150Permukaan mulai mengering
Tinggi151–225Lahan kering; api menjalar cepat
Sangat Tinggi226–300Gambut dapat terbakar di bawah permukaan

Wilayah (wilayah.json, wilayah/{id}.json)

jenis
khg (Kesatuan Hidrologis Gambut, SK MenLHK 129/2017) atau petak (petak grid 0,25°, sekitar 25 × 25 km).
kabupaten
Kab/kota yang disentuh wilayah, dengan luas_km2 di dalam masing-masing; terluas lebih dahulu.
lokasi
Titik di dalam wilayah tempat data cuaca diambil (lat, lon, WGS 84).
tren
naik, turun, atau stabil dibanding 7 hari sebelumnya, dengan ambang ±10 poin.
hujan_7hari_mm, suhu_maks_c
Jumlah hujan 7 hari terakhir (mm) dan suhu maksimum hari data (°C).
hujan_12minggu_mm_per_hari
Rata-rata hujan harian 12 minggu terakhir. Di bawah 4 mm/hari kebakaran dan asap di Indonesia meningkat tajam; di atas 6 mm/hari jarang terjadi (Field dkk. 2016). Ambangnya ada di ringkasan.json, kolom ambang_hujan_12minggu.
hujan_tahunan_normal_mm
Normal hujan tahunan 2020–2025, parameter R0 dalam rumus KBDI.
titik_panas_24jam
Titik panas 24 jam terakhir berkepercayaan sedang–tinggi di wilayah ini; null bila data titik panas sedang tidak tersedia.
riwayat, prakiraan
Daftar {tanggal, nilai, kelas}: 90 hari terakhir, lalu hari-hari berikutnya dari ramalan cuaca. Prakiraan makin tidak pasti untuk hari yang lebih jauh.

Titik panas (titik-panas*.geojson)

Setiap fitur adalah titik [bujur, lintang]. id stabil antar-pembaruan, sehingga bisa dipakai untuk membuang duplikat saat Anda menyimpan riwayat sendiri.

{
  "type": "Feature",
  "id": "fcab9fd547ef",
  "geometry": {
    "type": "Point",
    "coordinates": [
      116.3693,
      -0.058
    ]
  },
  "properties": {
    "waktu_utc": "2026-09-27T08:20:00Z",
    "satelit": "MODIS",
    "kepercayaan": "sedang",
    "kabupaten_kode": "64.02",
    "kabupaten": "Kabupaten Kutai Kartanegara",
    "wilayah_id": "khg-64-02-01",
    "di_dalam_khg": true
  }
}
waktu_utc
Waktu deteksi satelit dalam UTC. Tambah 8 jam untuk WITA.
kepercayaan
rendah, sedang, atau tinggi. Pelaporan nasional memakai sedang dan tinggi.
wilayah_id, di_dalam_khg
Wilayah pantau tempat titik jatuh; titik di atas KHG diberi true.
asal
SiPongi+ atau NASA FIRMS. SiPongi+ adalah sumber utama; NASA FIRMS melengkapi deteksi yang belum diterbitkan ulang SiPongi+ (biasanya 1–3 jam lebih cepat) dan satelit NOAA-21 yang tidak ada di SiPongi+.
sumber_tetap
true bila titik jatuh di lokasi yang panas setiap tahun bukan karena kebakaran (tambang batu bara, suar gas dan industri), menurut arsip NASA FIRMS. Titik ini tetap disertakan, tetapi tidak dihitung dalam angka 24 jam dan tidak masuk titik-panas-24jam.geojson.

Pembaruan dan cache

  • Indeks dihitung ulang setiap kali model cuaca ECMWF IFS punya run baru, sekitar 4 kali sehari. Titik panas dicek tiap 10 menit, tetapi berkasnya hanya berubah bila ada deteksi baru; sumbernya sendiri terbit 3,5–4,5 jam setelah satelit lewat.
  • Untuk sinkronisasi, pantau /status.json (kecil, Cache-Control: no-cache) tiap 5–10 menit, lalu unduh berkas lain hanya bila indeks.dihitung atau titik_panas.berubah berubah.
  • Setiap respons membawa ETag dan Last-Modified. Kirim kembali sebagai If-None-Match; bila berkas belum berubah, jawabannya 304 tanpa badan. Ini menghemat bandwidth, tetapi tetap dihitung dalam batas laju.
  • Berkas lain dikirim dengan Cache-Control: public, max-age=300; mengambil lebih sering dari 5 menit tidak memberi data yang lebih baru.
  • Waktu pembuatan data ada di meta.diperbarui (JSON) atau metadata.diperbarui (GeoJSON), dengan zona +08:00. Sumber daya indeks yang juga memuat titik_panas_24jam menyertakan titik_panas_diperbarui, karena hitungan itu diperbarui tiap jam.
curl -s -o /dev/null -w "%{http_code}\n" \
  -H 'If-None-Match: "ETag-dari-respons-sebelumnya"' \
  https://sipaga.bontangtechnohub.com/api/v1/ringkasan.json

Batas laju

Setiap alamat IP boleh mengirim 60 permintaan per menit ke /api/v1/, dengan cadangan hingga 40 permintaan beruntun. Batas ini melindungi server yang juga melayani situs lain, bukan membatasi pemakaian wajar.

  • Bila terlampaui, jawabannya 429 Too Many Requests dengan header Retry-After: 60 dan badan galat JSON. Tunggu selama itu sebelum mencoba lagi.
  • Kebijakan dinyatakan di header RateLimit-Policy: "api";q=60;w=60 (draf IETF RateLimit headers).
  • Untuk sinkronisasi terjadwal, satu atau dua permintaan per sumber daya per jam sudah cukup.

Galat

Galat dari API selalu JSON dengan bentuk yang sama:

{ "galat": { "kode": 404, "pesan": "Sumber daya tidak ditemukan. Lihat daftar di /api/v1/.", "dokumentasi": "https://sipaga.bontangtechnohub.com/api/" } }
KodeArtinya
304Berkas belum berubah sejak ETag yang Anda kirim.
404Jalur atau id tidak ada. Periksa daftar di /api/v1/.
405Metode selain GET, HEAD, atau OPTIONS. API ini hanya-baca.
429Batas laju terlampaui; lihat Retry-After.

Keamanan dan CORS

  • API ini hanya-baca dan tidak memakai kunci, cookie, atau sesi. Tidak ada data pribadi di dalamnya.
  • CORS terbuka untuk semua asal (Access-Control-Allow-Origin: *), jadi halaman web mana pun dapat membacanya langsung dari peramban.
  • Hanya HTTPS. HSTS aktif, dan respons API membawa X-Content-Type-Options: nosniff serta CSP yang menolak semua konten aktif.
  • Menemukan celah keamanan? Laporkan secara pribadi melalui kontak di /.well-known/security.txt, bukan di tempat umum.

Versi dan perubahan

  • Versi saat ini adalah v1, tertulis di jalur (/api/v1/) dan di meta.versi_api.
  • Di dalam v1, bidang baru dapat ditambahkan tanpa pemberitahuan. Aplikasi Anda sebaiknya mengabaikan bidang yang tidak dikenal.
  • Perubahan yang merusak — mengganti nama, menghapus bidang, atau mengubah artinya — hanya dilakukan di versi baru (/api/v2/). Versi lama tetap berjalan paling sedikit 90 hari setelah pengumuman di halaman ini.

Lisensi dan atribusi

Indeks kerawanan SIPAGA dilisensikan CC BY 4.0: bebas dipakai, dibagikan, dan diolah, termasuk untuk tujuan komersial, dengan menyebut sumbernya. Data dari pihak lain tetap mengikuti ketentuan sumber aslinya:

  • Titik panas: SiPongi+ Kementerian Kehutanan; cadangan NASA FIRMS.
  • Batas KHG: JIGD Kalimantan Timur (SK MenLHK 129/2017).
  • Batas kab/kota: geoBoundaries, CC BY 3.0 IGO.
  • Data cuaca yang menjadi masukan indeks: Open-Meteo, CC BY 4.0.

Cantumkan teks dari meta.atribusi, misalnya:

Sumber: SIPAGA Kaltim, Bontang Techno Hub (https://sipaga.bontangtechnohub.com)

Batasan data

  • SIPAGA Kaltim bukan produk resmi BMKG maupun Kementerian Kehutanan. Untuk peringatan resmi, rujuk BMKG dan SiPongi+.
  • Angka dihitung dengan KBDI. Versi khusus gambut (PFVI) memerlukan data tinggi muka air tanah yang belum tersedia secara terbuka untuk Kalimantan Timur.
  • Titik panas adalah indikasi dari satelit dan perlu verifikasi lapangan. Satu kebakaran dapat terdeteksi oleh beberapa satelit sekaligus.
  • Tidak ada jaminan ketersediaan. Untuk keputusan keselamatan, jangan bergantung pada satu sumber.