Skip to content

NINAnor/nina-map-explorer

Repository files navigation

NINA map explorer

NINA map explorer is an experimental web application which renders maps defined by a MapLibre style, with the addition of ProtoMaps Tiles to serve complex spatial data as a single web-optimized file.

datasets folder

Each dataset is a folder within datasets. Each dataset folder should contain a metadata.json file, which contains information on where to find the style file for the map, the original file for downloads, and some additional information about the dataset. Both style and source are relative to the folder where the metadata file is located.

See datasets/example for an example.

PMTiles conversion

PMTiles is a valid output format only for GDAL >= 3.8.

Here is an example of how to convert a GeoPackage file to PMTiles.

docker run --rm -ti -v $PWD:/host --workdir /host ghcr.io/osgeo/gdal \
    ogr2ogr -skipfailures -f PMTiles converted.pmtiles original.gpkg -dsco MAXZOOM=15

Full documentation is available at gdal.org/drivers/vector/pmtiles.html.

COG conversion

Raster images should be converted a 4 bands RGBA GEOTiff using EPSG:3857.

If you have a single-band greyscale GEOTiff you can use generate_cog.sh to produce a valid Cloud Optimized GEOTiff.

NOTE: COG layers are static, style must be pre-applyied.

Running the webapp

The only requirement is having a web server which supports HTTP bytes serving/ranged requests, such as NGINX.

Development

docker compose --profile dev up --build

Then, the application can be seen by visiting http://localhost:8000/.

Production

Same as development, but using the prod profile:

docker compose --profile prod up