Darimana sumber datanya?

Data dari 3 repo cahyadsn: cahyadsn/wilayah (db/wilayah.sql & wilayah_level_1_2.sql untuk hirarki, ibukota, lat/lng, luas, penduduk, path) sumber Kepmendagri 300.2.2-2430/2025, luas BIG, penduduk Dukcapil; cahyadsn/wilayah_kodepos (db/wilayah_kodepos.sql untuk postal_code 83762 villages); cahyadsn/wilayah_boundaries (db/kec & kel untuk polygon/paths dan lat/lng kecamatan/kelurahan dari BIG tanahair.indonesia.go.id).

Ya gratis 100% MIT, bebas komersial tanpa API key.

Host di GitHub Pages: 1 GB repo, 100 GB bandwidth/bulan, 10 builds/jam, tanpa rate limit dari kami. Untuk lebih leluasa self-host via npx wilayah download di gh-pages sendiri.

Seberapa sering data diupdate?

Mingguan via GitHub Actions cron 0 0 * * 0 Minggu 00:00 UTC, plus workflow_dispatch dan push main/v2. Cek stats.json meta.updated_at.

Seberapa akurat lat/lng dan polygon?

Lat/lng provinsi/kab-kota dari Google Maps, kecamatan/kelurahan centroid BIG, polygon multipolygon simplified 6 desimal. Cek has_path/has_latlng atau missings.json.

Bagaimana kalau ada data yang salah?

Lapor ke cahyadsn/wilayah, wilayah_kodepos, wilayah_boundaries untuk kode/nama/kodepos/polygon, atau ke emsifa/api-wilayah-indonesia untuk render API.

API Statis Wilayah Indonesia

API Statis

Tinggal fetch, beres

Nggak perlu bikin backend. Datanya cuma file JSON di GitHub Pages — tinggal fetch aja. Tanpa API key, tanpa rate limit. Gas langsung pakai.

https://www.emsifa.com/api-wilayah-indonesia/v2

Postman openapi.yml

Ada 12 endpoint total • Semuanya balik { data, meta } • Udah ke-cache CDN GitHub Pages, ngebut

CLI

Self-host datanya sendiri

Mau simpan datanya di aplikasi kamu? Download aja full datanya dan host sendiri.

npx @emsifa/wilayah skill

Kamu vibe coder? install SKILL.md supaya AI agent kamu bisa bantu integrasikan data wilayah ke proyekmu — mendukung Claude, Codex, OpenCode, Antigravity, Kiro, dan lainnya.

# Interactive — select agents via checklist (multi-select)
npx @emsifa/wilayah skill

# Non-interactive / CI
npx @emsifa/wilayah skill --agent claude,antigravity --yes

# Custom path (Others)
npx @emsifa/wilayah skill --agent others --target ./.cursor/skills/wilayah-indonesia/SKILL.md --yes

$ tips: tambahin --help buat liat opsi lengkap. Hasilnya tinggal taro di repo/server lo dan serve sendiri — beres.

Mau datanya auto-update di server lo? Tempel npx @emsifa/wilayah download di GitHub Actions / cron — tiap push auto tarik data terbaru buat self-host.

SKILL.mdAI

Bikin AI kamunggak ngarang.

SKILL.md itu contekan buat AI biar nggak halu. Daripada nebak kode wilayah, dia bakal fetch JSON beneran dari API statis. Aman.

Gimana pasangnya?

1. Paling gampang — lewat CLI

npx @emsifa/wilayah skill

Pilih agent yang kamu gunakan — file SKILL.md bakal kecopy ke folder skills yang sesuai.

2. Atau manual aja

Tinggal copy file SKILL.md dari repo ke .opencode/skills/ atau .codex/skills/— jadi.

Lihat di GitHub

Coba tanya AI kamu gini:

“Carikan semua kecamatan di Kota Bandung” → dia bakal fetch /districts/32.73.json terus kasih list beneran, bukan ngarang.

SKILL.md illustration — robot with SKILL.md API usage and floating Indonesia polygon regions

FAQ

Pertanyaan yang sering ditanya

Jawaban cepat sebelum kamu mulai. Kalau belum ketemu, buka issue di GitHub — kami bantu.

Data diambil dari 3 repository cahyadsn yang datanya merujuk ke sumber resmi pemerintah:

cahyadsn/wilayah db/wilayah.sql, db/wilayah_level_1_2.sql
Dipakai untuk hirarki wilayah & data rich provinsi/kab-kota (kode, nama, ibukota, lat/lng, elv, tz, luas, penduduk, path). Sumber asli: Kepmendagri No. 300.2.2-2430 Tahun 2025 (pemutakhiran 300.2.2-2138/2025, 100.1.1-6117/2022), luas dari Badan Informasi Geospasial (Surat Deputi BIG B-16.10/DIGD-BIG/IGD.04.04/12/2024), penduduk dari Ditjen Dukcapil Kemendagri Semester II 2024, pulau dari Gazeter Republik Indonesia (GRI) 2024 BIG.
cahyadsn/wilayah_kodepos db/wilayah_kodepos.sql
Dipakai untuk postal_code di desa/kelurahan dan endpoint /postal-codes/{kode}.json. Tabel wilayah_kodepos(kode, kodepos) untuk 83.762 desa/kelurahan sesuai Kepmendagri yang sama.
cahyadsn/wilayah_boundaries db/kec/*.sql, db/kel/*/*.sql
Dipakai untuk polygon dan koordinat kecamatan/kelurahan: /paths/{kode}.json dan lat/lng di /districts & /villages. Polygon dari BIG (tanahair.indonesia.go.id) multipolygon simplified, lat/lng adalah centroid polygon — bukan titik kantor.

Repo ini hanya agregator & pre-renderer jadi JSON statis. Jika ada selisih, rujukan resminya tetap Kepmendagri & BIG. Cek lengkapnya di cahyadsn/wilayah, wilayah_kodepos, wilayah_boundaries.

Masih ada yang bingung? Buka issue di GitHub.