Home

render(myMap) - Printed OpenStreetMap maps for local surveys

render(myMap) provides easy way to render specially styled OpenStreetMap maps, for surveying the area. We call it detail survey print, where all objects are rendered.

It consists of a web frontend and a server backend that uses an external OSM render engine to generate maps. No PostGIS or other complex OSM backend required. The system has been in development since 2011. See built in help on the live website (demo) for more info on usage.

NOTE this will not run on usual web hosting providers, because it requires rendering backend installed on the server. So you need your own complete server or virtual host.

Features of the web frontend:

• Browse the map using default OpenStreetMap style
• Search for places using Nominatim
• Select a box that you want to print
• Choose page options
• Choose from 3 styles
• Choose from 3 detail levels
• Browse and view previous renders

Features of the backend

• Listens for jobs coming from the frontent and responds immediately using incrond
• Downloads live OSM data from the OSM servers
• Renders OSM data into a map using Ceyx
• Generates a printer firendly HTML page

Frontend system requirements

• PHP
• (no database required)

Backend system requirements

• Ceyx and requirements of that software thereof
• incrond if you want instant response to incoming requests (start scripts are available for normal cron or manual invokation)

Installation

• Copy the frontend files to your webserver
• Allow web server write access to:
  • "jobs" - this is where PHP will place the requests
  • "previews" - this is where results list will generate a small preview images of the maps on the fly
• Install Ceyx and its requirements
• Copy the mapcss files to Ceyx directory
• Copy the sjjb icons directory into Ceyx icons directory
• Install the shell scripts in home bin directory (preferably a user dedicated to render, e.g. /home/render/bin/)
• Configure the shell scripts with paths to Ceyx and the web folders (in rendermymap.config)
• If you have incrond, configure it as rendermymap-incrond.sh shows
• If you have crond, configure it as rendermymap-crond.sh shows

Contribute

Contributions welcome. See TODO list or your ideas.

Links

• Demo URL
• OSM Wiki page

TODO

TODO

Project Members:

• Kempelen (admin)