README.md

GeoJSON-tile-server

A simple tile service, that takes one or more GeoJSON files and offers them as slippy maps.

For example, if you have a local data folder containing two GeoJSON files (layer1.geojson and layer2.geojson), you can access the tiles at http://localhost:8123/layer1/z/x/y.geojson and http://localhost:8123/layer2/z/x/y.geojson, where z = zoom, x and y need to be replaced by some sensible value based on the bounding box of your dataset.

If you are not sure what appropriate values are, have a look here.

Besides publishing the GeoJSON tiles, you can also retrieve the protobuf encoded vector tiles by replacing the geojson extension with mvt, e.g. http://localhost:8123/layer1/z/x/y.mvt.

Installation

Either run it standalone, or get the source.

Standalone

npm i -g geojson-tile-server

Source

git clone https://github.com/TNOCS/geojson-tile-server.git
cd geojson-tile-server
npm i
npm start

The source contains a small dataset containing some building contours in Amersfoort, The Netherlands. You can test that it is working by going to:

• GeoJSON example
• VT example
• MVT playground on flems.io: You need to insert your own Mapbox GL access key in order to make this work.

Usage

To start the development service, run:

npm start

Or if you've installed it globally, run geojson-tile-server, which by default serves the './data' folder with the GeoJSON files, and the ./public folder with static files.

Optionally, you can specify the PORT (default 8123), DATA (default ./data), and PUBLIC_FOLDER (default ./public) folder in your environment, in which case those values will be used instead.

Note

For another example of a Mapbox-based service, see here.