✨ bps-wilayah-lib

Library untuk mengambil dan mengelola data wilayah administratif Indonesia (Provinsi, Kabupaten, Kecamatan, Desa) dari hasil crawling BPS.

⚡ Instalasi

pnpm add indonesiadata-lib
# atau
npm install indonesiadata-lib
# atau
yarn add indonesiadata-lib

Import Fungsi

import {
  getProvinsiList,
  getKabupatenByProvinsi,
  getKecamatanByKabupaten,
  getDesaByKecamatan,
} from "indonesiadata-lib";

Contoh Lengkap

async function main() {
  const provinsi = await getProvinsiList();
  console.log("Provinsi:", provinsi);

  const kabupaten = await getKabupatenByProvinsi("11");
  console.log("Kabupaten di ACEH:", kabupaten);

  const kecamatan = await getKecamatanByKabupaten("11", "1101");
  console.log("Kecamatan di Kab. Simeulue:", kecamatan);

  const desa = await getDesaByKecamatan("11", "1101", "1101010");
  console.log("Desa di Teupah Selatan:", desa);
}

main();

📊 Daftar Fungsi

Fungsi	Deskripsi	Parameter	Return
`getProvinsiList()`	Mengambil daftar semua provinsi	–	`Promise<{ kode: string, provinsiName: string }[]>`
`getKabupatenByProvinsi(kodeProvinsi)`	Mengambil daftar kabupaten/kota berdasarkan kode provinsi	`kodeProvinsi: string`	`Promise<{ kode, kabupatenName, kecamatan[] }[]>`
`getKecamatanByKabupaten(kodeProvinsi, kodeKabupaten)`	Mengambil daftar kecamatan berdasarkan kabupaten dan provinsi	`kodeProvinsi: string`, `kodeKabupaten: string`	`Promise<{ kode, kecamatanName, desa[] }[]>`
`getDesaByKecamatan(kodeProvinsi, kodeKabupaten, kodeKecamatan)`	Mengambil daftar desa berdasarkan kecamatan, kabupaten dan provinsi	`kodeProvinsi: string`, `kodeKabupaten: string`, `kodeKecamatan: string`	`Promise<{ kode, desaName }[]>`

📦 Struktur Folder Data

project-root/
├── data/
│   ├── 11.json  ← Data Provinsi Aceh
│   ├── 12.json
│   ├── ...
│   └── provinsi.json  ← Daftar semua provinsi

🎓 Tipe Data

interface Desa {
  kode: string;
  desaName: string;
}

interface Kecamatan {
  kode: string;
  kecamatanName: string;
  desa: Desa[];
}

interface Kabupaten {
  kode: string;
  kabupatenName: string;
  kecamatan: Kecamatan[];
}

interface Provinsi {
  kode: string;
  provinsiName: string;
  kabupaten: Kabupaten[];
}

interface ProvinsiList {
  kode: string;
  provinsiName: string;
}

interface Wilayah {
  provinsi: Provinsi[];
}

Untuk kontribusi atau laporan isu, silakan buka GitHub!