Decamelize the district name and village name like the original data written in the PDF source.

• fityannugroho/idn-area-extractor#24
• Update test suite, especially the regex
• Update the data

Add an optional option (boolean type) to remove dots from code and parent_code data for getRegencies(), getDistricts(), getVillages(), and getIslands() methods.

The option name suggestions: removeDotsFromCode.

Is your feature request related to a problem? Please describe.

Currently, the island that doesn't belong to any regency will give the regency_code value with empty string ''.

Describe the solution you'd like

It is better if the regency_code value of the island that doesn't belong to any regency (and any empty value later) is transformed into null.

Description

Update the data based on latest regulation:

Keputusan Menteri Dalam Negeri Nomor 100.1.1-6117 Tahun 2022 Tentang Pemberian dan Pemutakhiran Kode, Data Wilayah Administrasi Pemerintahan, dan Pulau (alternative link)

The main changes is the expansion of the province PAPUA and PAPUA BARAT.

TODO

• Update provinces data
• Update regencies data
• Update districts data
• Update villages data
• Update islands data (start from page 3878)

• Migrate to TypeScript
• Use Node.js 18
• Bundle using tsup and publish only necessary files
• Migrate jest to vitest for testing
• Add options to transform the header and value
• Rename getter functions (provinces() -> getProvinces(), etc)
• Update the CI since the Node.js 16 is no longer supported
• #46
• #45
• #52

kode 96

Add dot separator in the code field like the original data from PDF

Description

Translate the README into Bahasa Indonesia and other languages.

Guides

• Save the translation files in docs folder and named it with README_{2 letter of language code}.md the language code must follows the ISO 639-1 code languages, e.g. README_id.md for Indonesian (Bahasa Indonesia).
• Create new PR and fill the form by following the contribution guide. Make sure you reference this issue in your PR.
• Translate the title into your language only. Remove the <i>Data Wilayah Indonesia</i>.
• Make sure all links is working, especially link in TOC and link to other file in this repo.
  • The links in the table of content (TOC) also need to be translated to make it work. The link is a snake-case version of the header without any symbol.
  • Use relative paths for links that go to other files (see the following article).
• DON'T translate blocks of code, unless there are comments that need to be translated.
• DON'T translate the GitHub Alerts syntax ([!NOTE], [!IMPORTANT], and [!WARNING]).

For everyone who wants to contribute to this issue, please fork this repo, make changes, and create a new PR. When ready, ask me to review your work. I will not assign each person individually.

Halo,

Sebelumnya terimakasih telah membuat projek yang sangat bagus seperti ini, sangat berguna sekali diprojekan saya.

Tapi disisi lain, menurut saya ada yang kurang diprojek ini, yaitu file SQL untuk programmer yang masih berkutat dibidang RDBMS seperti saya ini.

Dengan tersedianya file SQL, programmer tidak perlu repot-repot lagi untuk mengubah dari CSV ke SQL atau melakukan pembuatan table wilayah lalu import csvnya.

Apa mas @fityannugroho berkenan kalau saya open PR untuk menambahkan file SQL tersebut?

Terimakasih ☕️

Put it at /docs/upgrading directory

Is your feature request related to a problem? Please describe.

This package is currently not providing the islands data contained in REF-2022-1 (starts from page 3548 to 4038).

The island data consists of:

• Island code, for example: 11.06.40007
11.06 is the regency code, 4 is digit indicating it's an island, and 0007 is the serial number starts from 0001.

  But sometimes, the island does not belong to any regency. So that, the third and fourth digits will be zero (00). See 12.00.40001 Pulau Babi for the example.

• Island name, for example: Pulau Bateeleblah

• Island coordinate, for example: 05°47'34.72" U 094°58'26.09" T
  The coordinate is written in DMS (degree minute seconds) format. U stands for "Utara" or "North", and T stands for "Timur" or "East".

• Island information, for example: TBP (PPKT)
  The information available includes:

  • BT: stands for "Berpenghuni" or "Populated".
  • TBP: stands for "Tidak Berpenghuni" or "Unpopulated".
  • PPKT: stands for "Pulau-Pulau Kecil Terluar" or "Outermost Small Islands" (see the definition).

Describe the solution you'd like

1. Create islands.csv file that contains this column:

   • code for the island code without dot separation. For example: 110640007.
   • regency_code for relation to the regency data. For example: 1106. If the island does not belong to any regency, just leave the regency_code column empty (put , and go to the next column).
   • coordinate for the island coordinate with English term. For example: 05°47'34.72" N 094°58'26.09" E.
   • is_populated with value 1 if the island is populated (BT), or 0 if (TBP) and no available data.
   • is_outermost_small with value 1 if the island is The Outermost Small Islands (PPKT), or 0 if not.
   • name for the island name. For example: Pulau Bateeleblah.

2. Create new function to get all island data.

3. Create a tests suite to test the islands data.

Describe alternatives you've considered

None

Additional context

Especially for the development of this feature, please PR to feat/islands branch.

To adding the island data, you can ask ChatGPT help to formatting the data with this prompt:

I need you to sanitize and format this raw data.
First you must learn and analyze the pattern of this raw data and the result.

// raw data
11.09.40017 Pulau Babi 02°10'08.00" U 096°38'10.00" T
11.09.40018 Pulau Balok 02°28'58.49" U 096°23'11.95" T TBP
11.09.40019 Pulau Balubuk 02°53'52.51" U 095°50'14.15" BP
11.09.40020 Pulau Balung 02°40'13.00" U 096°07'58.00" T PPTK
11.09.40023 Pulau Batuberlayar Kecil 02°25'29.46" U 096°31'18.48" T BP (PPTK)
11.09.40024 Pulau Batuhek 02°21'37.72" U 096°12'13.66" T BP
11.09.40025 Pulau Benar 02°32'17.33" U 096°21'27.12" T TBP (PPTK)
// result
code,regency_code,coordinate,is_populated,is_outermost_small,name
110940017,1109,02°10'08.00" N 096°38'10.00" E,0,0,Pulau Babi
110940018,1109,02°28'58.49" N 096°23'11.95" E,0,0,Pulau Balok
110940019,1109,02°53'52.51" N 095°50'14.15" E,1,0,Pulau Balubuk
110940020,1109,02°40'13.00" N 096°07'58.00" E,0,1,Pulau Balung
110940023,1109,02°25'29.46" N 096°31'18.48" E,1,1,Pulau Batuberlayar Kecil
110940024,1109,02°21'37.72" N 096°12'13.66" E,1,0,Pulau Batuhek
110940025,1109,02°32'17.33" N 096°21'27.12" E,0,1,Pulau Benar

Hint for you:
- Value for is_populated: `1` if `BP` present, and `0` if not.
- Value for is_outermost_small, `1` if `PPKT` present, and `0` if not .
- `BP` not same with `TBP`.
- Just ignore the `TBP`.

DON'T RETURN ANY RESPONSE NOW! Just analyze the data.

Then you can start asking ChatGPT to formatting the real data in the next prompt.

Make sure you check the ChatGPT answer from wrong data, typo, etc.
Don't trust ChatGPT completely.