SETTING UP ROUTINO FOR USE WITH MARBLE
======================================

Since Marble 1.0.0 (kdeedu 4.6.0), Marble supports computing routes using
Routino. The following instructions describe how to set that up:

1. Download one or more OpenStreetMap extract(s) in OSM XML format. Files are
   usually compressed as *.osm.bz2.
   See http://wiki.openstreetmap.org/wiki/Planet.osm#Mirrors for possible
   download sites. For countries in Europe and for some other countries,
   http://download.geofabrik.de/osm/ is a good choice.

   IMPORTANT:
   * The new binary .osm.pbf format is NOT supported by Routino. Therefore,
     .osm.pbf files can only be used after conversion with a tool such as
     pbf2osm (http://git.openstreetmap.nl/index.cgi/pbf2osm.git/).
   * The larger the chosen map extract, the longer it takes to download and
     process. The processing time is not negligible, e.g. austria.osm.bz2 takes
     several minutes to download and over 2 hours to process on a Pentium 4.
     Think twice before using the entire (16 GiB) planet.osm.bz2!
   * Some servers (e.g. downloads.cloudmade.com) have terms of service and/or
     acceptable usage policies restricting the fields of use.
   * You can use more than one .osm.bz2 file. Sometimes, more than just a
     country-wide extract is needed for optimal routing, e.g. the optimum route
     from Vienna (Austria) to Innsbruck (Austria) goes through Germany.

2. Uncompress the downloaded .osm.bz2 files:
   bunzip2 *.osm.bz2

3. Marble expects the data to be in a ~/.local/share/marble/maps/earth/routino
   directory, so create that directory now:
   mkdir ~/.local/share/marble/maps/earth/routino

4. Process the .osm files with the routino-planetsplitter tool, setting the
   destination directory to the one expected by Marble.
   WARNING: This step may take minutes, hours or even days depending on the size
            of the input data and the speed of your computer!
   routino-planetsplitter --dir=$HOME/.local/share/marble/maps/earth/routino \
     *.osm
   (The routino-planetsplitter will accept an entire list of .osm files.)

5. If you want to use Routino's routing exclusively: In the Marble preferences,
   in the route planning tab, edit the profiles to disable all the other routing
   programs (especially the online services), keep only Routino checked. If you
   keep them checked, Marble will also query the web services and you can
   compare the computed routes (but you may want to check the web services'
   terms of use, e.g. OpenRouteService requires explicit approval for any
   commercial use).

6. Now you are ready to test your installation:
   Use the route planning applet on the left, select 2 places in whatever map
   section you downloaded in step 1 (and processed in step 4) and a locomotion
   method and see the route being computed.

        Kevin Kofler