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
| Parameter | Tipe | Wajib? | Format yang Diterima | Keterangan |
|---|---|---|---|---|
| kode_kabupaten | string | undefined | Opsional | "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 titikkecamatan('32.04'); // Standar titik Kemendagri2. 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 kecamatanKasus 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"
}
]