{{tag>Xenial openstreetmap}}
----
{{ https://josm.openstreetmap.de/svn/trunk/images/logo.png?75|}}

====== Éditeur Java pour OpenStreetMap ======

[[https://josm.openstreetmap.de/|Java OpenStreetMap Editor]], **JOSM** en abrégé, est un éditeur [[:java]] pour la [[:cartographie]] collaborative libre sur [[https://www.openstreetmap.org/|OpenStreetMap]] (OSM).
<note>Si vous ne souhaitez faire que de la consultation, vous pouvez utiliser [[:Viking]], disponible dans la logithèque.</note>

===== Pré-requis =====

  * Avoir un environnement [[:java]] fonctionnel.

===== Installation =====
[[:tutoriel:comment_installer_un_paquet|Installez les paquets]] **[[apt>josm,josm-plugins|josm et josm-plugins]]**, cependant la version de JOSM présente dans les dépôts officiels d'Ubuntu n'est pas tenue à jour autant qu'il le faudrait...\\
Notamment pour des raisons de compatibilité avec les greffons (plugins), il est recommandé d'utiliser la dernière version disponible sur le site officiel.

==== Avec les dépôts d'OpenStreetMap ====

OpenStreetMap propose un dépôt pour Ubuntu permettant de récupérer et de tenir à jour JOSM.

  - [[:tutoriel:comment_modifier_sources_maj|Modifiez vos sources de mises à jour]] pour y ajouter le dépôt d'OpenStreetMap -- **Attention** à bien remplacer <VERSION_UBUNTU> par le nom de votre [[:versions|version]] d'Ubuntu en minuscule : <file>deb https://josm.openstreetmap.de/apt <VERSION_UBUNTU> universe</file>
  - Téléchargez et installez la clé d'authentification du dépôt : <code>wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add -</code>
  - [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|Rechargez la liste des paquets]] ;
  - [[:tutoriel:comment_supprimer_un_paquet|Supprimez les paquets]] **josm** et **josm-plugins** (si vous les aviez précédemment installés) ;
  - [[:tutoriel:comment_installer_un_paquet|Installez les paquets]] **[[apt>josm|josm]]** ou **[[apt>josm-latest|josm-latest]]** pour la version en développement.
<note>La version de développement nécessite d'utiliser la version 7 java !!!</note>
<note tip>Vous pouvez automatiser l'ajout du dépôt avec sa clé d'authentification et la mise à jour de la liste des paquets avec la commande suivante : <code>echo "deb https://josm.openstreetmap.de/apt `lsb_release -sc` universe #JOSM" | sudo tee -a /etc/apt/sources.list && wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add - && sudo apt-get update</code>

Il ne vous reste ensuite plus qu'à choisir la version de JOSM qui vous intéresse !</note>

==== Manuelle ====

L'installation manuelle consiste en un téléchargement de l'archive Java sur le site officiel et, éventuellement, en la création d'un raccourci dans le menu application. Les archives Java disponibles sur le site officiel sont identiques à celles des dépôts d'OpenStreetMap. Une installation manuelle n'a donc de sens que si vous n'avez pas les droits d'administration sur la machine sur laquelle vous souhaitez utiliser JOSM...

  - Télécharger l'archive Java
    * Dernière version stable : [[https://josm.openstreetmap.de/josm-tested.jar|josm-tested.jar]] ;
    * Dernière version en développement : [[https://josm.openstreetmap.de/josm-latest.jar|josm-latest.jar]].
  - [[:permissions|Modifiez les permissions]] pour rendre l'archive exécutable.

=== Lancer JOSM ===

Vous pouvez lancer JOSM en [[terminal#comment_ouvrir_un_terminal|ouvrant un terminal]] et en tapant les commandes suivantes :
<code>cd ~/<dossier_dans_lequel_se_trouve_l_archive_de_josm>
java -jar josm-tested.jar</code>

=== Ajout du raccourci dans le menu ===

Il est possible de créer un raccourci à intégrer dans le menu d'applications. Dans les explications qui suivent, c'est **la version stable** de JOSM qui est utilisée avec l'archive **josm-tested.jar**.\\
**Adaptez le nom du fichier** si vous utilisez la version en développement contenue dans l'archive **josm-latest.jar** :!:

  * **Sous Gnome :**
    - Dans //Système -> Préférences -> **Menu Principal**// ;
    - Ajoutez un raccourci dans //Application -> **Éducation**// ;
      * Nom : //JOSM//
      * Commande : //java -jar /**<emplacement_de_l_archive_de_josm>**/josm-tested.jar//
  * **Sous KDE 4.2 :**
    - Ouvrez l'éditeur de menu avec le bouton droit de la souris sur l'icône du menu K ;
    - Ajoutez un raccourci dans //Éducation -> **Science**// ;
      * Nom : //JOSM//
      * Commande : //java -jar /**<emplacement_de_l_archive_de_josm>**/josm-tested.jar//

===== Mettre à jour JOSM =====

<note tip>Si vous avez fait une installation [[:josm#avec_les_depots_d_openstreetmap|avec les dépôt d'OpenStreetMap]], la mise est jour est automatique.</note>

Dans le cas d'une installation manuelle, vous pouvez mettre JOSM à jour afin de disposer de la dernière version disponible sur [[https://josm.openstreetmap.de/|le site officiel]] en remplaçant simplement l'archive téléchargée. Attention à conserver le même nom de fichier pour l'archive (josm-tested.jar par défaut pour la version stable) afin de ne pas briser le raccourci mis en place dans le menu application.

===== Utilisation =====

<note>Ne seront traités ici que les cas spécifiques à Ubuntu ou des cas généraux qu'un utilisateur pourrait attribuer par erreur à Ubuntu uniquement.\\ De nombreux sites spécialisés traitants l'utilisation de JOSM existent en français si l'information que vous recherchez n'est pas disponible sur cette page, veuillez consulter la rubrique "Liens externes" en fin de page.</note>

==== Activer JOSM depuis un site externe ====

Il est possible de charger des données directement dans JOSM depuis un site internet à condition que JOSM soit ouvert. Cela permet de simplifier le chargement de données en vue d'édition depuis, par exemple, le [[https://www.openstreetmap.org/|site officiel OSM]].

Pour que cette fonction soit active, allez dans les préférences (touche F12), allez dans l'onglet "Utilisation à distance" (icône télécommande) et activez le contrôle à distance. Après l'activation, redémarrez JOSM et faite un essais depuis l'éditeur de carte en ligne osm.og en choisissant le menu déroulant //Modifier -> **Modifier avec Éditeur externe (JOSM ou Merkaator)**//

===== Installation de greffons =====

Parmi les greffons (plugins) intéressants, on notera cadastre-fr, WMSplugins et validator qui permettent respectivement d'afficher en arrière-plan les données cadastrales françaises, des vues satellites et la correction de données incorrectes.

<note important>L'utilisation de cadastre demande une modification de la projection. Consultez impérativement les sites indiqués en fin de cette page pour savoir comment l'utiliser.</note>

==== Installation automatique ====

  * Appuyez sur la touche F12 pour afficher la fenêtre de configuration ;
  * Ouvrez le menu des greffons (celui dont l'icône est une prise électrique) ;
  * Cliquez sur "Télécharger la liste" puis sur "Actualiser" ;
  * Sélectionnez les greffons à installer ;
  * Validez puis relancez JOSM.

==== Installation manuelle ====

  * Téléchargez les greffons souhaités à partir de [[https://josm.openstreetmap.de/wiki/Plugins]]
  * Enregistrez les fichiers .jar obtenus dans le répertoire ///home/<votre_nom_utilisateur>/.josm/plugins// ;
  * Lancez JOSM, si besoin, activez les plugins dans la fenêtre des préférences et relancez JOSM.

===== Liens externes =====

  * [[https://josm.openstreetmap.de/|Site officiel de JOSM]] **(en)** ;
  * [[https://wiki.openstreetmap.org/wiki/FR:JOSM|La page consacrée à JOSM]] dans le wiki francophone d'OpenStreetMap **(fr)** ;
  * [[http://fr.flossmanuals.net/openstreetmap/ch011_modifier-avec-lediteur-hors-ligne-josm|Présentation et tutoriel sur OSM et les différents outils disponible]] **(fr)** ;
  * [[http://partir-en-vtt.com/php/articles/voir_article.php?id_article=282|Tutoriel sur JOSM et l'utilisation des greffons]]**(fr)** ;
  * [[https://forum.openstreetmap.fr/|Forum de discussion francophone consacré à OSM]] **(fr)**.

----

//Contributeurs :  [[utilisateurs:Spirzouf|Spirzouf]].//