osm-rendering-workshop / getting_started.rst

Full commit
.. _getting_started:

Getting Started

This `workshop <>`_ will walk you through getting raw OpenStreetMap data, importing the data into PostGIS using osm2pgsql, rendering map tiles with Mapnik, and displaying them with OpenLayers.

.. note::

  If you are reading this documentation after September 2010, you should check for updated documentation available at

.. image:: _static/images/barcelona-old-sm.png

Learning the Toolchain

You will learn how to install and configure a mimic of the official OpenStreetMap toolchain, using the same technologies, that can be later customized to render different map styles or pull from other datasets. The OSM rendering toolchain consists of the following technologies; all of them will be touched upon in the workshop:


* `Planet.osm  <>`_ - XML based dump format of the OSM database
* `PostGIS <>`_ - Spatial Database (part of PostgreSQL)
* `osm2pgsql <>`_ - Tool for importing OSM data into PostGIS
* `Mapnik <>`_ - Rendering library
* `OpenLayers <>`_ - Javascript mapping interface
* `mod_tile <>`_ - high performance tile serving, on-demand rendering, and caching

Extra friends along the way

We will also expose you to a few other useful tools:

* `QuantumGIS <>`_ - User friendly data viewer with powerful python plugins
* `Nik2img <>`_ - Command line stylesheet renderer
* `TileLite <>`_ - lightweight development tile server
* Custom Mapnik stylesheets (`Spreadnik <>`_, `Quantumnik <>`_, and `Cascadenik <>`_)

More Help
During the course of this workshop if you get stuck, you can find more details online at the `OpenStreetMap/Mapnik wiki page <>`_. IRC (Internet Relay Chat) is also a great place to ask questions. Try the #mapnik channel on irc:// and the #osm channel on irc://

.. and at the OpenStreetMap `stylesheet guide <>`_.


This plan sound good? Great, then lets begin by :ref:`installing`.

If you are running linux first check out :ref:`virtualbox-intro`.