aurellemeless/philippines-json-maps

Philippine administrative boundaries in geojson and topojson format at various resolution.

Philippines Administrative Boundaries JSON Maps

Philippine administrative boundaries in geojson and topojson format at various resolution.

Demo

This repository contains Philippines vector maps suitable for use on web applications either as an overlay to interactive map services (ex. Leaflet) or rendered on HTML canvas (ex. d3js).

You can download the map files in the following directories.

.
├── topojson
├── geojson
└── ...

Low resolution topojson files are well suited for resource-constrained scenarios such as rendering dynamic maps using slow network connection. For optimal performance use medium resolution or low resolution maps.

Sample Maps

Files are generated for all locations in the Philippines at different administrative levels.

For example, the regions map will show regional boundaries on the entire country. Shown below rendered using geojson.io.

regions.topo.0.1.json

While the each of the provinces map will show provincial boundaries in a region.

provinces-region-ph020000000.topo.0.1.json

Same with municipalities and cities and barangays.

Source Files

Maps are using the WGS 1984, Lat/Long projection.

The shapefiles used for this project is available at this repo.

The 2015 Level 0 to 3 shapefiles came from OCHA Services Website.

The 2015 Level 4 shapefiles came from this Github Repo

The 2011 Level 0 to 4 shapefiles came from GADM Website Data

Please refer to the PSGC Summary of Changes to take into account potential issues that may arise when using these maps together with your datasets.

Here are some important considerations when using these maps.

• The precense of NIR Region -- was recently abolished
• Renaming of ARMM to BARRM
• Various location naming changes

Previous Maps

Output from a 2011 version of the map using GADM Website Data is also available under 2011 directory.

Files Available

Raw shapefiles, geojson and topojson for all political boundary are made available. Please feel free to file issues found.

Level	Name
Level 0	Country
Level 1	Region
Level 2	Province/District
Level 3	Municipality/Cities
Level 4	Barangays

GeoJSON and Topojson formats are available in high, medium and low resolution files.

Conversion Process

Shapefiles to GeoJSON conversion with high fidelity was done using ogr2ogr.

The high fidelity GeoJSON file is "downsampled" using mapshaper with -simplify flag at 10% (hires), 1% (medres), 0.1% (lowres) settings.

GeoJSON is then converted to a more compact topojson format using geo2topo.

Using the Scripts (OPTIONAL)

You can modify and run the scripts on your own. For example if you want to have your own settings for mapshaper simplify algorithm.

1. Install Dependencies

brew install gdal
npm install -g mapshaper
npm install -g topojson

2. Modify scripts under scripts/

3. Run the scripts (running barangays-topojson.sh might take a few minutes to finish)

cd scripts
./country-topojson.sh
./regions-topojson.sh
./provinces-topojson.sh
./municities-topojson.sh

Git LFS

This repository uses Git LFS to store shapefiles larger than 100mb

Contributing

Contributions are always welcome, no matter how large or small. Before contributing, please read the code of conduct.