daftar-wilayah-indonesia v4.0.3

Cara mudah mendapatkan data wilayah indonesia

Berikut ini adalah penjelasan bagaimana cara menggunakan package daftar-wilayah-indonesia di Front-End maupun Back-end hususnya pengguna nodejs

Installation

$ npm install daftar-wilayah-indonesia

Tutorial penggunaan

untuk menggunakan package ini anda harus mengimport 4 function yang sudah di sediakan yakni function provinsi, kabupaten, kecamatan dan desa

import { provinsi, kabupaten, kecamatan, desa } from 'daftar-wilayah-indonesia'

PENJELASAN

Silahkan simak penjelesan dari masing - masing fungsi yang sudah kita import di atas

Function provinsi()

untuk function provinsi() ini, anda tidak perlu mengirimkan argumen apapun karena akan otomatis menampilkan semua data provinsi yang ada di indonesia. Silahkan perhatikan contoh kode di bawah ini. Saya contohkan penggunaan di NEXTJS

import { provinsi, kabupaten, kecamatan, desa } from 'daftar-wilayah-indonesia'

export default function Home() {

  // cara penggunaan
  const data = provinsi()
  console.log(data)
  // cara penggunaan

  return (
    <div>
      Hello world
    </div>
  )
}

ketika kalian menjalankan kode di atas, maka nanti akan menampilkan data berupa JSON di console, berikut ini adalah data yang akan dihasilkan

[
  { kode: '11', nama: 'Aceh' },
  { kode: '12', nama: 'Sumatera Utara' },
  { kode: '13', nama: 'Sumatera Barat' },
  { kode: '14', nama: 'Riau' },
  { kode: '15', nama: 'Jambi' },
  { kode: '16', nama: 'Sumatera Selatan' },
  { kode: '17', nama: 'Bengkulu' },
  { kode: '18', nama: 'Lampung' },
  { kode: '19', nama: 'Kepulauan Bangka Belitung' },
  { kode: '21', nama: 'Kepulauan Riau' },
  { kode: '31', nama: 'Dki Jakarta' },
  { kode: '32', nama: 'Jawa Barat' },
  { kode: '33', nama: 'Jawa Tengah' },
  { kode: '34', nama: 'Di Yogyakarta' },
  { kode: '35', nama: 'Jawa Timur' },
  { kode: '36', nama: 'Banten' },
  { kode: '51', nama: 'Bali' },
  { kode: '52', nama: 'Nusa Tenggara Barat' },
  { kode: '53', nama: 'Nusa Tenggara Timur' },
  { kode: '61', nama: 'Kalimantan Barat' },
  { kode: '62', nama: 'Kalimantan Tengah' },
  { kode: '63', nama: 'Kalimantan Selatan' },
  { kode: '64', nama: 'Kalimantan Timur' },
  { kode: '65', nama: 'Kalimantan Utara' },
  { kode: '71', nama: 'Sulawesi Utara' },
  { kode: '72', nama: 'Sulawesi Tengah' },
  { kode: '73', nama: 'Sulawesi Selatan' },
  { kode: '74', nama: 'Sulawesi Tenggara' },
  { kode: '75', nama: 'Gorontalo' },
  { kode: '76', nama: 'Sulawesi Barat' },
  { kode: '81', nama: 'Maluku' },
  { kode: '82', nama: 'Maluku Utara' },
  { kode: '91', nama: 'Papua Barat' },
  { kode: '94', nama: 'Papua' }
]

perhatikan responnya berupa array yang berisi object.

  { kode: '52', nama: 'Nusa Tenggara Barat' }

nilai dari object di atas bisa kita gunakan untuk mencari kabupaten dari masing - masing provinsi dengan cara mengambil nilai dari key kode yang dalam contoh di atas adalah 52

Function kabupaten()

Untuk tahap kabupaten, tentunya kita ingin melihat daftar kabupaten dari provinsi yang kita pilih, sebagai contoh saya ingin melihat daftar kabupaten yang ada di Nusa Tenggara Barat, maka anda perlu mengirimkan kode provinsi yang ingin anda lihat. Untuk mendapatkan kodenya, anda perlu melihatnya di function provinsi() sebagaimana yang telah kita lakukan di atas.

  { kode: '52', nama: 'Nusa Tenggara Barat' }

perhatikan keys kode yang berisi nilai string 52, nilai tersebut akan kita gunakan sebagai argumen di function kabupaten(). Silahkan perhatikan kode berikut ini

import { provinsi, kabupaten, kecamatan, desa } from 'daftar-wilayah-indonesia'

export default function Home() {

  // cara penggunaan
  const data = kabupaten('52')
  console.log(data)
  // cara penggunaan

  return (
    <div>
      Hello world
    </div>
  )
}

maka respon yang di hasilkan sebagai berikut

[
  { kode: '5201', kode_provinsi: '52', nama: 'Kabupaten Lombok Barat' },
  {
    kode: '5202',
    kode_provinsi: '52',
    nama: 'Kabupaten Lombok Tengah'
  },
  { kode: '5203', kode_provinsi: '52', nama: 'Kabupaten Lombok Timur' },
  { kode: '5204', kode_provinsi: '52', nama: 'Kabupaten Sumbawa' },
  { kode: '5205', kode_provinsi: '52', nama: 'Kabupaten Dompu' },
  { kode: '5206', kode_provinsi: '52', nama: 'Kabupaten Bima' },
  {
    kode: '5207',
    kode_provinsi: '52',
    nama: 'Kabupaten Sumbawa Barat'
  },
  { kode: '5208', kode_provinsi: '52', nama: 'Kabupaten Lombok Utara' },
  { kode: '5271', kode_provinsi: '52', nama: 'Kota Mataram' },
  { kode: '5272', kode_provinsi: '52', nama: 'Kota Bima' }
]

sekarang anda lihat responya berbeda dari yang sebelumnya, kali ini objeknya berisi 3 nilai yakni kode, kode_provinsi dan nama.

  {
    kode: '5202',
    kode_provinsi: '52',
    nama: 'Kabupaten Lombok Tengah'
  },

kita akan menggunakan nilai dari keys kode untuk mencari daftar kecamatan.

PERINGATAN : Jika kalian tidak mengirimkan argumen di function kabupaten() maka nanti respon yang anda dapatkan adalah semua data kabupaten yang ada di indonesia, begitu juga jika anda salah mengirim kode di dalam argumen

function kecamatan()

untuk penggunaan function kecamatan(), kurang lebih sama dengan function kabupaten(), yakni membutuhkan 1 argumen untuk mencari kecamatan yang ada di suatu kabupaten. Silahkan perhatikan contoh berikut ini

import { provinsi, kabupaten, kecamatan, desa } from 'daftar-wilayah-indonesia'

export default function Home() {

  // cara penggunaan
  const data = kecamatan('5202')
  console.log(data)
  // cara penggunaan

  return (
    <div>
      Hello world
    </div>
  )
}

argumen 5202 yang saya kirim di function kecamatan() adalah untuk mengecek daftar kecamatan yang ada di Kabupaten Lombok Tengah

  {
    kode: '5202',
    kode_provinsi: '52',
    nama: 'Kabupaten Lombok Tengah'
  },

maka nanti respon yang akan anda dapatkan adalah sebagai berikut

[
  { kode: '5202010', kode_kabupaten: '5202', nama: 'Praya Barat' },
  { kode: '5202011', kode_kabupaten: '5202', nama: 'Praya Barat Daya' },
  { kode: '5202020', kode_kabupaten: '5202', nama: 'Pujut' },
  { kode: '5202030', kode_kabupaten: '5202', nama: 'Praya Timur' },
  { kode: '5202040', kode_kabupaten: '5202', nama: 'Janapria' },
  { kode: '5202050', kode_kabupaten: '5202', nama: 'Kopang' },
  { kode: '5202060', kode_kabupaten: '5202', nama: 'Praya' },
  { kode: '5202061', kode_kabupaten: '5202', nama: 'Praya Tengah' },
  { kode: '5202070', kode_kabupaten: '5202', nama: 'Jonggat' },
  { kode: '5202080', kode_kabupaten: '5202', nama: 'Pringgarata' },
  { kode: '5202090', kode_kabupaten: '5202', nama: 'Batukliang' },
  { kode: '5202091', kode_kabupaten: '5202', nama: 'Batukliang Utara' }
]

PERINGATAN : Jika kalian tidak mengirimkan argumen di function kecamatan() maka nanti respon yang anda dapatkan adalah semua data kecamatan yang ada di indonesia, begitu juga jika anda salah mengirim kode di dalam argumen

function desa()

function yang terakhir yakni desa(), penggunaanya mirip dengan function kabupaten() dan kecamatan(), yakni membutuhkan sebuah argumen berupa kode. Silahkan perhatikan kode berikut ini

import { provinsi, kabupaten, kecamatan, desa } from 'daftar-wilayah-indonesia'

export default function Home() {

  // cara penggunaan
  const data = desa('5202060')
  console.log(data)
  // cara penggunaan

  return (
    <div>
      Hello world
    </div>
  )
}

kode di atas artinya saya ingin mencari daftar desa yang ada di kecamatan praya

  { kode: '5202060', kode_kabupaten: '5202', nama: 'Praya' }

maka respon yang akan dapatkan adalah sebagai berikut

[
  { kode: '5202060001', kode_kecamatan: '5202060', nama: 'Panjisari' },
  { kode: '5202060004', kode_kecamatan: '5202060', nama: 'Praya' },
  { kode: '5202060005', kode_kecamatan: '5202060', nama: 'Prapen' },
  { kode: '5202060006', kode_kecamatan: '5202060', nama: 'Tiwugalih' },
  { kode: '5202060009', kode_kecamatan: '5202060', nama: 'Semayan' },
  { kode: '5202060018', kode_kecamatan: '5202060', nama: 'Bunut Baok' },
  { kode: '5202060020', kode_kecamatan: '5202060', nama: 'Gonjak' },
  { kode: '5202060021', kode_kecamatan: '5202060', nama: 'Jago' },
  { kode: '5202060022', kode_kecamatan: '5202060', nama: 'Aik Mual' },
  {
    kode: '5202060023',
    kode_kecamatan: '5202060',
    nama: 'Mertak Tombok'
  },
  {
    kode: '5202060024',
    kode_kecamatan: '5202060',
    nama: 'Montong Terep'
  },
  {
    kode: '5202060025',
    kode_kecamatan: '5202060',
    nama: 'Mekar Damai'
  }
]

PERINGATAN : Jika kalian tidak mengirimkan argumen di function desa() maka nanti respon yang anda dapatkan adalah semua data desa yang ada di indonesia, begitu juga jika anda salah mengirim kode di dalam argumen

Kurang lebih begitulah cara menggunakan package ini, dimana kita sudah mencoba untuk mencari provinsi, kabupaten, kecamatan dan desa yang di dalam contoh ini kita mencari provinsi Nusa Tenggara Barat, lalu kabupaten Lombok Tengah, kemudian Kecamatan Praya