README

Open City Street Map

ocitysmap generates a city street map, using the OpenStreetMap project's data and the Mapnik map renderer. The generated maps are vector graphics images, optionally including things like a street index and city grid.

For example, for a simple Chevreuse rendering, run:

./render.py -t "Ceci n'est pas Paris" --osmid=-943886

Alternatively you may specify a bounding box rather than an OSM ID:

./render.py -t "Ceci n'est pas Paris" -b 48.7268,1.9946 48.6801,2.0742

This is useful when OpenStreetMap does not contain the administrative boundary of the city you want to render. To determine the OSM ID and/or the bounding box of cities from their name, please use the nominatim service: http://nominatim.openstreetmap.org/

By default, the maps are generated in PDF format with the street index at the bottom, with an additional CSV containing the street index. To see the available options to change this behavior, please run:

./render.py --help

See INSTALL for installation instructions.

This code is under AGPLv3 (GNU Affero General Public License 3.0) except the included OpenStreetMap logo under CC-BY-SA (Creative Common Attribution-Share Alike) license.