Piano-Forte

A world map in two flavours:

• Piano, when you need a very light background to put data on top of if
• Forte, when you need a generic purpose map

And three languages: French, English, Arabic.

Forte

Piano

Local installation

Create a pianoforte PSQL database:

sudo -u postgres createdb pianoforte -O youruser

Clone this repository:

git clone https://github.com/tilery/pianoforte

Compile the world boundaries:

make boundary

Download the PBF from Geofabrik:

make download

Note: you can use another area by setting the PBF env var to the Geofabrik relative path (default is: africa/egypt-latest.osm.pbf).

Import the PBF and the boundaries into the database:

make import

Copy the localconfig sample, and change the db configuration inside:

cp localconfig.js.sample localconfig.js

Run kosmtik with forte:

kosmtik serve forte.yml

Or with piano:

kosmtik serve piano.yml

Production deployment

Overview

• tiles are generated by the classic mod_tile/Mapnik stack
• Mapnik XML files are distributed in dist/ folder in this repository
• OSM data is managed by Imposm
• custom data (including boundaries, country labels, main city labels) is managed by mae-boundaries

Dependencies

• postgresql
• postgis
• gdal
• apache2
• imposm
• mod-tile (see osmadmins/ppa for Ubuntu)

Instructions

• create a database with postgis extension:

    createdb tilery
    psql tilery -c "CREATE EXTENSION IF NOT EXISTS postgis"
  

Note: the database is named tilery to follow conventions in the Mapnik XML generated in the dist/ of the project, see below.

• grab Mapnik XML, fonts, icons, Imposm mapping…:

    git clone https://github.com/tilery/pianoforte /path/to/pianoforte --depth 1
  

• download OSM data

    wget https://planet.openstreetmap.org/pbf/planet-latest.osm.pbf
  

• download coastline data

    wget https://osmdata.openstreetmap.de/download/simplified-land-polygons-complete-3857.zip
    unzip simplified-land-polygons-complete-3857.zip
    wget https://osmdata.openstreetmap.de/download/land-polygons-split-3857.zip
    unzip land-polygons-split-3857.zip
  

• import OSM data

    imposm import -diff -config /path/to/imposm.conf -read /path/to/planet-latest.osm.pbf -overwritecache -write -deployproduction
  

• download and import boundary data

    wget http://nuage.yohanboniface.me/boundary.json
    ogr2ogr --config PG_USE_COPY YES -lco GEOMETRY_NAME=geometry -lco DROP_TABLE=IF_EXISTS -f PGDump boundary.sql /path/to/boundary.json -sql 'SELECT name,"name:en","name:fr","name:ar","name:es","name:de","name:ru",iso FROM boundary' -nln itl_boundary
    psql -d tilery --file /path/to/boundary.sql
  

• download and import city names

    wget https://raw.githubusercontent.com/tilery/mae-boundaries/master/city.csv
    ogr2ogr --config PG_USE_COPY YES -lco GEOMETRY_NAME=geometry -lco DROP_TABLE=IF_EXISTS -f PGDump city.sql /path/to/city.csv -select name,'name:en','name:fr','name:ar',capital,type,prio,ldir -nln city -oo X_POSSIBLE_NAMES=Lon* -oo Y_POSSIBLE_NAMES=Lat* -oo KEEP_GEOM_COLUMNS=NO -a_srs EPSG:4326
    psql -d tilery --file /path/to/city.sql
  

• download disputed areas

    wget http://nuage.yohanboniface.me/disputed.json -O data/disputed.json
  

• create custom DB indexes

    psql -d tilery -c "CREATE INDEX IF NOT EXISTS idx_road_label ON osm_roads USING GIST(geometry) WHERE name!='' OR ref!=''"
    psql -d tilery -c "CREATE INDEX IF NOT EXISTS idx_boundary_low ON osm_admin USING GIST(geometry) WHERE admin_level IN (3, 4)"
  

• in renderd configuration file (/etc/renderd.conf) add one section for any flavour/language you want to support:

    [fortefr]
    URI=/fortefr/
    TILEDIR=/srv/tilery/tmp/tiles
    XML=/srv/tilery/pianoforte/fortefr.xml
    HOST=localhost
    TILESIZE=256
    MAXZOOM=20
    CORS=*
  

• if you want retina support, add dedicated sections, example:

    [fortefr2x]
    URI=/fortefr@2x/
    TILEDIR=/srv/tilery/tmp/tiles
    XML=/srv/tilery/pianoforte/fortefr.xml
    HOST=localhost
    TILESIZE=512
    SCALE=2
    MAXZOOM=20
    CORS=*
  

• configure mod_tile; create /etc/apache2/mods-available/tile.load with this content:

    LoadModule tile_module /usr/lib/apache2/modules/mod_tile.so
  

• create /etc/apache2/mods-available/tile.load with this content:

    <IfModule tile_module>
        LoadTileConfigFile /etc/renderd.conf
        ModTileRenderdSocketName /var/run/renderd/renderd.sock
        # Timeout before giving up for a tile to be rendered
        ModTileRequestTimeout 0
        # Timeout before giving up for a tile to be rendered that is otherwise missing
        ModTileMissingRequestTimeout 30
    </IfModule>
  

• run renderd

    /usr/bin/renderd -f -c /etc/renderd.conf