Voraussetzungen¶

JOSM ist eine Java-Anwendung und erfordert deshalb die Installation einer Laufzeitumgebung (JRE). JOSM ist mit OpenJDK kompatibel.

Online-Nutzung¶

Statt der nachfolgend beschriebenen Installation auf dem eigenen Rechner kann man auch Java Web Start für JOSM verwenden: josm.jnlp ⮷. Dann arbeitet man automatisch immer mit der neuesten Version.

Installation¶

JOSM wird über die offiziellen Paketquellen von Ubuntu bereitgestellt. Nach Installation der Java-Laufzeitumgebung muss daher nur noch das Paket

• josm (universe)

Befehl zum Installieren der Pakete:

sudo apt-get install josm 

installiert ^[1] werden.

Nach der Installation kann JOSM über

• "Anwendungen → Wissenschaft → JOSM"

gestartet werden.

deb https://josm.openstreetmap.de/apt VERSION bionic hirsute universe

wget -q -O "-" https://josm.openstreetmap.de/josm-apt.key | sudo apt-key add - 

sudo apt-get install josm 

Manuell¶

Nach Installation der Java-Laufzeitumgebung (s.o.) wird die neueste, stabile (tested) Version als josm-tested.jar ⮷ heruntergeladen und im Verzeichnis /Downloads im Homeverzeichnis gespeichert.

Hinweis!

Fremdsoftware kann das System gefährden.

Danach kann JOSM mit folgendem Befehl aus einem Terminal ^[3] heraus gestartet werden:

java -jar ~/Downloads/josm-tested.jar 

Menü-Eintrag¶

Um JOSM bequem über das Startmenü ^[5] aufrufen zu können, sind nur wenige weitere Installationsschritte notwendig. Hierfür sind jeweils Root-Rechte erforderlich. Als erstes wird das Verzeichnis /opt/josm angelegt ^[6] (siehe auch /opt):

sudo mkdir /opt/josm 

Dann wird die zuvor heruntergeladene Datei josm-tested.jar mit folgendem Befehl in das Verzeichnis /opt/josm/ verschoben:

sudo mv ~/Downloads/josm-tested.jar /opt/josm/  

Das am Artikelanfang abgebildete JOSM-Logo herunterladen und in josm_logo.png umbenennen. Mit folgendem Befehl nach /usr/share/pixmaps/ verschieben:

sudo mv ~/Downloads/josm_logo.png /usr/share/pixmaps/ 

Nun kann mit beispielsweise mit Arronax ein Programmstarter ^[7] angelegt werden.

• Name: JOSM

• Befehl: java -jar /opt/josm/josm-tested.jar

• Kommentar: Java OpenStreetMap Editor

Alternativ einen fertigen Programmstarter josm.desktop ⮷ herunterladen und mit folgendem Befehl in das Verzeichnis /usr/share/applications verschieben:

sudo mv ~/Downloads/josm.desktop /usr/share/applications/ 

Jetzt sollte sich ein neuer Eintrag im Startmenü befinden, über den JOSM nun per Mausklick aufgerufen werden kann. Wenn man josm-latest.jar verwendet, muss noch die Datei usr/share/applications/josm.desktop mit Root-Rechten editiert und folgender Befehl angepasst werden:

Exec=java -jar /opt/josm/josm-tested.jar

Nun startet JOSM aus dem Verzeichnis /opt/josm/.

Unter Unity findet man das Programm nach erfolgreicher Installation auf der Dash-Startseite durch die Eingabe von JOSM. Der Starter kann optional gespeichert werden.

Aktualisierung

Aktualisierung¶

Sobald es eine neue JOSM-Version gibt, wird dies nach dem Start des Editors angezeigt.

Um JOSM zu aktualisieren, muss lediglich die Datei josm-tested.jar ⮷ neu heruntergeladen und mit Root-Rechten in den Ordner /opt/josm/ verschoben werden (s.o.). Es wird empfohlen, dies regelmäßig durchzuführen. Nach dem Update fragt JOSM beim ersten Start nach einer Plugin-Aktualisierung, die dann ausgeführt werden sollte.

Alternativ kann die Aktualisierung auch mit diesen Befehlen (im Terminal ausführen) ausgeführt werden:

cd /opt/josm
sudo wget --timestamping http://josm.openstreetmap.de/download/josm-tested.jar
sudo chmod +x josm-tested.jardevelop
sudo rm josm.jar
sudo ln -s josm-tested.jar josm.jar 

Befehl für einen Starter:

java -jar /opt/josm/josm-tested.jar 

Tracer2Server & JOSM

Einstellungen und Erweiterungen¶

Um JOSM komfortabel nutzen zu können, sollten nach erstmaligem Programmaufruf noch ein paar Einstellungen vorgenommen und einige Erweiterungen installiert werden, durch die zusätzliche Funktionalitäten bereitgestellt werden. Dazu wird der Menüpunkt "Bearbeiten → Einstellungen" aufgerufen. Es wird hier vorausgesetzt, dass JOSM manuell installiert wurde (Ver. 3966).

• In den Anzeige-Einstellungen wählt man unter dem Reiter "Verhalten und Aussehen" die Einstellung "GTK+" aus.

• Unter den Verbindungseinstellungen werden der OSM-Benutzername und Passwort hinterlegt. Diese Angaben werden für das Hochladen neuer Kartenelemente zum OSM-Server benötigt.

• Unter "Karteneinstellungen" sollte die Projektionsmethode auf "Merkator" umgestellt werden. Zusätzliche MapPaint-Stile erleichtern die Arbeit im Editor. So kann z.B. Coloured Streets 🇩🇪 gewählt werden um Adressen zu bearbeiten.

• Im Menü "Plugins" muss zunächst die Liste der verfügbaren Erweiterungen auf die entsprechende Schaltfläche geladen werden.

Aus der Liste der verfügbaren Erweiterungen sollten folgende ausgewählt werden:

Nach Auswahl der Erweiterungen und Bestätigung durch den "OK"-Button ist ein Neustart von JOSM erforderlich.

Benutzung¶

Die Benutzung von JOSM ist ausführlich im OpenStreetMap-Wiki 🇩🇪 dokumentiert.

Links¶

• Liste mit Eigenschaften für die Grundelemente der Karte 🇩🇪

• Liste mit Eigenschaften, nach Objekten sortiert 🇩🇪

• Tagging deutscher Straßen 🇩🇪

• Tagging von Verkehrsschildern 🇩🇪

• Zutrittsbeschränkungen für Wege und Gebiete angeben 🇩🇪

• Tracer 2 🇩🇪

• Installationsanleitung im englischsprachigen Ubuntu-Wiki 🇬🇧