Skip to content

iguntur/administratif-indonesia

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

56 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Administratif Wilayah Indonesia

Build Status Coverage Status XO code style PRs Welcome

Daftar wilayah administratif Indonesia


Table Of Contents


Install

Install via npm package manager

$ npm install administratif-indonesia

or if you prefer using yarn package manager

$ yarn add administratif-indonesia

Usage

const AdministratifIndonesia = require('administratif-indonesia');
const ai = new AdministratifIndonesia();

console.log(JSON.stringify(ai.all(), null, '\t'));
/*
{
    "11-aceh": "/path/your-project/node_modules/administratif-indonesia/storages/11-aceh.json",
    "12-sumatera-utara": "/path/your-project/node_modules/administratif-indonesia/storages/12-sumatera-utara.json",
    // ...
}
*/

console.log(ai.get('51-bali'));
//=> /path/your-project/node_modules/administratif-indonesia/storages/51-bali.json

API

AdministratifIndonesia

Create a new instance of AdministratifIndonesia.

Instance

.path

Returns a string for full path of source directory.
e.g: /path/your-project/node_modules/administratif-indonesia/storages

.size()

Returns a number of size values.

.all()

Returns an object for all values.

.get(key)

Returns a string for a specifie values of an input key, otherwise will returns null.

.has(key)

Returns a boolean value if key has exists.

key
  • Type: string
  • Default: undefined

Examples

NOTE: Jika ukuran (size) data sangat besar, gunakanlah ReadableStreams.

Basic

const ai = new AdministratifIndonesia();

// synchronous output
console.log(fs.readFileSync(ai.get('31-dki-jakarta'), 'utf8'));

// Readable Streams
fs.createReadStream(ai.get('31-dki-jakarta')).pipe(process.stdout);

Server

const ai = new AdministratifIndonesia();

app.get('/api/administratif-indonesia/:identifier', (request, response) => {
    fs.createReadStream(ai.get(request.params.identifier))
        .pipe(response);
});

Browser

Semua file Administratif Indonesia dapat di akses langsung via browser melalui unpkg.com.

๐Ÿ‘‰ https://unpkg.com/administratif-indonesia/storages/

Source

Mempertimbangkan beberapa sumber yang ada, librari ini menggunakan data yang bersumber dari Ditjen PUM Kemendagri (Permendagri No. 137-2017).

Conclusions

Library ini hanyalah kumpulan file-file json yang dapat anda gunakan untuk program web interface anda sehingga dapat dengan mudah membangun RESTful API pada sisi server (backend) dan juga berinovasi pada sisi (client) untuk UI/UX.

Memperhatikan sumber yang digunakan, librari ini juga dapat menjadi sebuah data acuan untuk penilitian lebih lanjut.

Related

License

MIT ยฉ Guntur Poetra