@@ -0,0 +1,59 @@
+SETTING UP ROUTINO FOR USE WITH MARBLE
+======================================
+
+IMPORTANT: If you are upgrading from a release of Routino prior to 2.6, you MUST
+ run these steps (at least step 4) again. Existing .mem files from
+ previous releases of Routino cannot be used with version 2.6.
+
+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 PBF or OSM XML format.
+ XML Files are usually compressed as *.osm.bz2, those can be opened directly
+ by Routino.
+ 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:
+ * Starting from version 2.5, Routino supports the new binary .osm.pbf format,
+ as well as any compressed .gz or .bz2 input. (xz is NOT supported yet
+ though.) Therefore, no advance conversion (pbf2osm) nor decompression
+ should be needed anymore.
+ * 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 approximately 50 minutes 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 input 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. 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
+
+3. Process the input (.osm.pbf, .osm.bz2, etc.) 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.pbf
+ (The routino-planetsplitter will accept an entire list of input files.)
+
+4. 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).
+
+5. 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 3) and a locomotion
+ method and see the route being computed.
+
+ Kevin Kofler
|