Search
SailfishOS Open Build Service
>
Projects
>
home:MartinK
:
sailfish
>
routino
> README-MARBLE.txt
Log In
Username
Password
Cancel
Overview
Repositories
Revisions
Requests
Users
Advanced
Attributes
Meta
File README-MARBLE.txt of Package routino
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