Tingkat 3 (Kecamatan)fungsi: kecamatan(kode_kabupaten?)

Fungsi kecamatan()

Mengambil daftar kecamatan di suatu kabupaten/kota. Mendukung format kode bertitik (standar Kemendagri) maupun kode bersih tanpa titik.

1. Spesifikasi Parameter

ParameterTipeWajib?Format yang DiterimaKeterangan
kode_kabupatenstring | undefinedOpsional"3204" atau "32.04"Kode 4 digit kabupaten/kota induk. Otomatis menerima baik format dengan titik maupun tanpa titik.
Fleksibilitas Kode (Titik vs Tanpa Titik):

Anda tidak perlu pusing memikirkan apakah kode dari API/form memiliki titik atau tidak. Kedua pemanggilan di bawah ini 100% valid dan menghasilkan data yang identik:

kecamatan('3204'); // Tanpa titik
kecamatan('32.04'); // Standar titik Kemendagri

2. Perilaku Pemanggilan (Behavior)

Kasus A: Dengan Parameter Kode Kabupaten (Filter Per Kota)

Mengembalikan seluruh kecamatan di kabupaten tersebut (contoh: Kabupaten Bandung memiliki 31 kecamatan).

const listKec = kecamatan('3204');
console.log(listKec.length); // 31 kecamatan
Kasus B: Tanpa Parameter (Semua Kecamatan se-Indonesia)

Jika parameter dikosongkan, fungsi akan mengembalikan seluruh 7.265+ kecamatan yang ada di Indonesia.

const semuaKecamatan = kecamatan();
console.log(semuaKecamatan.length); // 7265+
Kasus C: Kode Tidak Ditemukan

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

const hasil = kecamatan('0000');
console.log(hasil); // []

3. Tipe Data (TypeScript Interface)

export interface Kecamatan {
  /** Kode kecamatan tanpa titik (6 digit), contoh: "320405" */
  kode: string;
  /** Kode resmi Kemendagri dengan titik, contoh: "32.04.05" */
  kode_kemendagri: string;
  /** Kode kabupaten/kota induk (4 digit), contoh: "3204" */
  kode_kabupaten: string;
  /** Kode provinsi induk (2 digit), contoh: "32" */
  kode_provinsi: string;
  /** Nama kecamatan, contoh: "Cileunyi" */
  nama: string;
}

4. Contoh Hasil Respon kecamatan('3204')

[
  {
    "kode": "320405",
    "kode_kemendagri": "32.04.05",
    "kode_kabupaten": "3204",
    "kode_provinsi": "32",
    "nama": "Cileunyi"
  },
  {
    "kode": "320407",
    "kode_kemendagri": "32.04.07",
    "kode_kabupaten": "3204",
    "kode_provinsi": "32",
    "nama": "Cilengkrang"
  },
  {
    "kode": "320408",
    "kode_kemendagri": "32.04.08",
    "kode_kabupaten": "3204",
    "kode_provinsi": "32",
    "nama": "Bojongsoang"
  }
]