Tingkat 4 (Desa & Kelurahan)fungsi: desa(kode_kecamatan?)

Fungsi desa()

Mengambil daftar desa dan kelurahan resmi di Indonesia. Mendukung format kode titik maupun tanpa titik.

1. Spesifikasi Parameter

ParameterTipeWajib?Contoh NilaiKeterangan
kode_kecamatanstring | undefinedOpsional"320405" atau "32.04.05"Kode 6 digit kecamatan induk. Bisa dengan titik maupun tanpa titik.
Arsitektur Super Cepat & Hemat Memori (Lazy Initialization):

Indonesia memiliki lebih dari 83.345 desa/kelurahan. Di versi 5.0.1, data desa menggunakan teknik Lazy Loading. Jika aplikasi Anda hanya butuh data Provinsi dan Kabupaten, data desa sama sekali tidak akan memakan memori RAM (0 MB). Saat fungsi desa(...) pertama kali dipanggil, index hash map dibuat seketika dan query berikutnya O(1) instan (hanya ~0.005 milidetik).

2. Perilaku Pemanggilan (Behavior)

Kasus A: Dengan Parameter Kode Kecamatan (Paling Umum)

Mengembalikan seluruh desa/kelurahan di kecamatan tersebut (rata-rata 6-20 desa).

// Kedua penulisan ini bekerja sama baiknya:
const desa1 = desa('320405');   // Tanpa titik
const desa2 = desa('32.04.05'); // Format titik Kemendagri

console.log(desa1.length); // 6 desa di Kec. Cileunyi
Kasus B: Tanpa Parameter

Jika dipanggil tanpa argumen, fungsi akan mengembalikan seluruh 83.345+ desa di Indonesia.

const semuaDesa = desa();
console.log(semuaDesa.length); // 83345
Kasus C: Kode Tidak Ditemukan

Jika kode tidak terdaftar, fungsi dengan aman mengembalikan array kosong [].

const hasil = desa('999999');
console.log(hasil); // []

3. Tipe Data (TypeScript Interface)

export interface Desa {
  /** Kode desa tanpa titik (10 digit), contoh: "3204052001" */
  kode: string;
  /** Kode resmi Kemendagri dengan titik, contoh: "32.04.05.2001" */
  kode_kemendagri: string;
  /** Kode kecamatan induk (6 digit), contoh: "320405" */
  kode_kecamatan: string;
  /** Kode kabupaten/kota induk (4 digit), contoh: "3204" */
  kode_kabupaten: string;
  /** Kode provinsi induk (2 digit), contoh: "32" */
  kode_provinsi: string;
  /** Nama desa atau kelurahan, contoh: "Cileunyi Kulon" */
  nama: string;
}

4. Contoh Hasil Respon desa('320405')

[
  {
    "kode": "3204052001",
    "kode_kemendagri": "32.04.05.2001",
    "kode_kecamatan": "320405",
    "kode_kabupaten": "3204",
    "kode_provinsi": "32",
    "nama": "Cileunyi Kulon"
  },
  {
    "kode": "3204052002",
    "kode_kemendagri": "32.04.05.2002",
    "kode_kecamatan": "320405",
    "kode_kabupaten": "3204",
    "kode_provinsi": "32",
    "nama": "Cileunyi Wetan"
  },
  {
    "kode": "3204052003",
    "kode_kemendagri": "32.04.05.2003",
    "kode_kecamatan": "320405",
    "kode_kabupaten": "3204",
    "kode_provinsi": "32",
    "nama": "Cibiru Hilir"
  },
  {
    "kode": "3204052004",
    "kode_kemendagri": "32.04.05.2004",
    "kode_kecamatan": "320405",
    "kode_kabupaten": "3204",
    "kode_provinsi": "32",
    "nama": "Cibiru Wetan"
  },
  {
    "kode": "3204052005",
    "kode_kemendagri": "32.04.05.2005",
    "kode_kecamatan": "320405",
    "kode_kabupaten": "3204",
    "kode_provinsi": "32",
    "nama": "Cinunuk"
  },
  {
    "kode": "3204052006",
    "kode_kemendagri": "32.04.05.2006",
    "kode_kecamatan": "320405",
    "kode_kabupaten": "3204",
    "kode_provinsi": "32",
    "nama": "Cimekar"
  }
]