Regina adalah sebuah pustaka javascript (javascript library) yang menyediakan seperangkat tool sederhana untuk mengemas dan menyajikan data wilayah administrasi Republik Indonesia. Dibawah ini adalah sebuah contoh aplikasi kecil yang saya kembangkan on top of Regina dan saya beri nama Regina Browser. Tentu saja saya berharap Regina dapat dipakai untuk keperluan yang lebih luas lagi.
Ya, bila Anda tertarik menggunakan Regina, pertama-tama Anda harus tahu bahwa Regina adalah sebuah objek. Kita tidak perlu membuat sebuah instance dari Regina. Begitu Anda menyertakan Regina dalam dokumen, maka Regina otomatis tersaji untuk Anda. Untuk memperpendek coding saya memilih menggunakan variable regina.
var regina = DeepData.indonesia.Regina;
Untungnya, release Regina sudah memuat sejumlah data yang siap digunakan:
Kita dapat menambahkan (atau merubah) data Regina kapan saja. Saat ini saya sedang menyiapkan beberapa data add-on yang kompatibel dengan Regina, antara lain data kependudukan, luas wilayah, kodepos, geografis dsb.
Saya mengundang semua pihak untuk ikut menyumbang data sehingga nantinya kita memiliki basis data yang bukan saja gratis tetapi mudah digunakan (maaf, tidak seperti di situs-situs pemerintah yang suck!).
Catatan: saya menggunakan kode wilayah seperti yang dipakai BPS.
Regina dilengkapai beberapa method utama untuk melakukan queri yaitu province(), regency(), district() dan village(). Keempat method tersebut sangat sederhana namun cukup canggih serta memiliki kesamaam dalam penggunaannya. Selain itu ada method select(), deselect(), count(), dan addData().
Anda dapat langsung mencoba method-method tersebut di halaman ini bila Anda menggunakan Safari, Google Chrome, atau Firefox dengan add-on Firebug.
Selain itu, setiap objek dalam Regina, yaitu objek yang dihasilkan dari queri mempunyai dua method yang sejenis yaitu parent() dan children(). Misalnya:
var test = regina.select(8101);
maka test akan mendapat nilai yang berupa reference dari objek Kabupaten Maluku Tengga Barat.
test.children();
menghasilkan seluruh kecamatan (anak) dari kabupaten tersebut.
test.parent();
menghasilkan orangtua (provinsi) kabupaten tersebut, dalam hal ini Provinsi Maluku yang memiliki kode ISO ID-MA dan beribukota di Ambon.