README.md

This is a work in progress.

Currently address importing, clustering, PMTiles generation and raster tile rendering with Tileserver GL (for map editors like JOSM) are done.

Produce PMTiles

Docker (with Docker Compose) is required.

First, get taiwan-latest.osm.pbf from Geofabrik Download Server, put it in the source/. To use another file name, set PBF, e.g. PBF=taiwan-261022.osm.pbf docker compose run importer.

Then run the importer to import address into PostgreSQL and process the cluster, and the converter to use GDAL to generate PMTiles:

docker compose run importer
docker compose run converter

As of October 2026 (taiwan-261022.osm.pbf), the importer took about 140 seconds and converter took about 95 seconds in my Ryzen 5 5600G machine running WSL 2. The addresses table will have 9,711,502 entries, generating 202,861 address clusters; the PMTiles generated is sized 38MB.

Serve raster tiles

After source/cluster.pmtiles is generated, start Tileserver GL:

docker compose up -d tileserver

It renders raster tiles on demand at http://localhost:8886/. Traditional Chinese glyphs are built from Noto Sans CJK TC when building the image.

To use it in JOSM, add a TMS imagery layer with this URL:

tms[11,19]:http://localhost:8886/styles/address-clusters/{zoom}/{x}/{y}.png

Tileserver GL renders 256px tiles with the map one zoom level lower, so z11 is the lowest zoom with content.