idn-area-boundary

Provides a simple way to get the boundary of a given area in Indonesia.

The data is taken from Alf-Anas/batas-administrasi-indonesia. The source data is extracted and converted to GeoJSON format.

The properties of the GeoJSON is also modified to be syncronized with the data from idn-area-data.

Note: The data still in syncronization and validation process, so some data may not be available yet.

Prerequisite

• Bun v1.0 or later
• PostgreSQL

Installation

• Clone this repository

• Prepare the raw data

  Download the raw data from Alf-Anas/batas-administrasi-indonesia and extract it to raw-data directory. Make sure to put the data in the following directory structure:

  .
  |- raw-data
  |  |- provinces
  |  |  |- provinces.shp
  |  |  |- provinces.dbf
  |  |  |- ...
  |  |- regencies
  |  |  |- regencies.shp
  |  |  |- regencies.dbf
  |  |  |- ...
  |  |- districts
  |  |  |- districts.shp
  |  |  |- districts.dbf
  |  |  |- ...
  |  |- villages
  |  |  |- villages.shp
  |  |  |- villages.dbf
  |  |  |- ...
  |- src
  ...

• Create .env file and set the DB_URL with your PostgreSQL connection string

• Run bun install to install all dependencies

• Run bun run db:migrate to create the database schema

• Run bun run db:seed to seed the idn-area-data

Usage

bun start [options] [command]

# Options:
#   -h, --help             display help for command

# Commands:
#   load <area>            load boundaries from raw data to the database safely (will
#                          update the data if it exists)
#   sync [options] <area>  sync boundaries from raw data with idn-area-data
#   export <area>          export synced boundaries into geojson files
#   help [command]         display help for command

Serve the data

This repository also provides a simple server to serve the data. You can run the server by running the following command:

bun serve

The server will be available at http://localhost:3000.

You can specify the port by setting the PORT environment variable before running the command. Ensure that the port is not used by another service.

Now you can access the data by sending a request to the server. For example, to get the boundary of a province with the code 32, you can send a request to http://localhost:3000/provinces/32.geojson.