[[Vorlage(archiviert, )]]
{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Terminal: Ein Terminal öffnen]
[:Programme_starten: Starten von Programmen]
}}}
[[Inhaltsverzeichnis(1)]]
[[Bild(openstreetmap/logo.png, align=left, 40)]]
Dieser Artikel richtet sich an alle radfahrenden Nutzer von GPS-Geräten der Marke Garmin, die eine selber erstellte [:OpenStreetMap:Openstreetmap]-Karte auf ihr Gerät bringen wollen. 

= Installation =
Zuerst müssen einige Programme aus den ofiziellen Paketquellen installiert [1] werden:

{{{#!vorlage Paketinstallation
ant
ant-contrib
bzr
m4
subversion
openjdk-8-jdk, Xenial
}}}

=Vorbereitungen=
Um sich eine Radkarte zu erstellen, öffnet man ein Terminalfenster [2], erstellt und wechselt in einen geeigneten Ordner (z.B. '''~/OSM''') und lädt dann zuerst den Quellcode mit Bazaar aus dem Launchpad-Projekt [launchpad:radkarte:OSM Radkarte] {en} herunter:

{{{#!vorlage Befehl
bzr branch lp:radkarte
}}}

Danach wechselt man in den entstandenen Ordner:
{{{#!vorlage Befehl
cd radkarte
}}}

=Erstellen der Karte=
Nach einigen sinnvollen Anpassungen (siehe unten) gibt man 

{{{#!vorlage Befehl
ant dist
}}}
ein und schaut dem Rechner beim Arbeiten zu. Dabei ist zu beachten, das das Skript einige Dateien mit einer Gesamtgröße von ca. 500 MiB sowie die gewünschte Region von der Geofabrik herunterlädt. Wenn man die Region schon heruntergeladen hat, kopiert man sie in den Unterordner '''build/''', damit sie verwendet wird.

Die Radkarte(n) (also die entpackte(n) Datei(en) '''gmapsupp.img''' aus dem Unterordner '''build/dist/''') speichert man danach auf der SD-Karte des Garmins im Ordner '''garmin/''' ab. 

= Anpassung =
Bevor man los legt, lohnen sich einige Anpassung an der Konfigurationsdatei '''build.xml''':

== Andere Region generieren==
Wenn man eine andere Karte als Deutschland generieren will (z.B. nur ein bestimmtes Bundesland), muss man in der Datei '''build.xml''' den Downloadpfad und -dateiname anpassen:

{{{
<property name="dl_path" value="europe/"/>
<property name="dl_region" value="germany"/>
}}}

Die jeweiligen Dateien und Pfade findet man bei der [https://download.geofabrik.de/ Geofabrik] {de}. Für Stuttgart wäre es z.B.

{{{
<property name="dl_path" value="europe/germany/baden-wuerttemberg/"/>
<property name="dl_region" value="stuttgart-regbez"/>
}}}

== Karten-ID ändern ==
Wenn man mehr als eine auf diese Art generierte Karte auf dem SD-Karte speichert, gibt es das Problem, dass diese zum einen zusammengefasst werden und zum anderen nur eine der Karten angezeigt wird. Grund hierfür ist, das diese alle die gleiche ID bekommen und somit nur eine gewinnt.

Daher ändert man die Zeile

{{{
<property name="family_id_base" value="5900"/>
}}}

ab und vergibt dort bei jeder Karte andere IDs, die sich mindestens in den ersten zwei Ziffern unterscheiden sollten. Man kann z.B. die ersten zwei Ziffern hochzählen lassen: 5900, 6000, 6100, … Erst dann erscheinen beide Karten auf dem Navi für eine eigene Anwahl und können auch gleichzeitig dargestellt werden. 

= Problemlösungen =

== Radkarte kompiliert nicht ==
Seit ungefähr rev. 400 kommt eine Fehlermeldung:

{{{
BUILD FAILED
/home/radkarte/build.xml:28: Problem: failed to create task or type math
Cause: The name is undefined.
}}}

Laut [launchpad:radkarte/+bug/1210747:diesem Bugreport] {en} muss man zur Abhilfe folgendes Paket installieren:

{{{#!vorlage Paketinstallation
ant-contrib
}}}

== Radkarte kompiliert nicht (2) ==
Wenn es Fehlermeldungen der Art

{{{
[apply] Schwerwiegend (SeaGenerator): /home/dee/Downloads/radkarte/build/59000002.osm.pbf: Cannot read index file index.txt.gz
[apply] Schwerwiegend (LocationHook): /home/dee/Downloads/radkarte/build/59000005.osm.pbf: Disable LocationHook because bounds directory is unusable.
}}}

gibt, dann liegt das daran, dass die vorkompilierten Grenzdateien nicht bzw. nicht korrekt heruntergeladen wurden (siehe [launchpad:radkarte/+bug/1322802:Bugreport]).

Da diese nicht zwingend notwendig sind, reicht es, in der '''build.xml''' folgende Zeilen zu entfernen:

{{{
<arg value="--precomp-sea=${basedir}/${cachedir}/downloads/precomp_sea.zip"/>
<arg value="--bounds=${basedir}/${cachedir}/downloads/precomp_bounds.zip"/> 
}}}

{{{#!vorlage Hinweis
Diese tauchen jeweils zweimal in der Datei auf.
}}}

= Links =
 * [http://www.formann.de/radkarte/ Homepage des Projekts Radkarte von Johannes Formann] {de}
 * [launchpad:radkarte:OSM Radkarte] {en}
 * [http://www.deesaster.org/blog/index.php?/archives/2147 OSM-Radkarten selbst erstellt] {de} - Blogeintrag, 06/2013
 * [:OpenStreetMap:] {Übersicht} Übersichtsartikel
  * [:OpenStreetMap/Programme:] {Übersicht} Programmübersicht

#tag: Bildung, Einsteiger, Garmin, GPS, Hardware, OpenStreetMap