JOSM

From OpenStreetMap Wiki
Jump to navigation Jump to search
JOSM
JOSM 17013 screenshot en.png
Authors Immanuel Scholz, Dirk Stöcker and other contributors.
License GNU General Public License
Platforms Windows, Linux, and macOS
Version 17013 Changelog (2020-09-07)
Languages Asturian, Bulgarian, Catalan, Valencian, Czech, Danish, German, Greek, English, Canadian English, Australian English, British English, Spanish, Estonian, Basque, Finnish, French, Galician, Hungarian, Indonesian, Italian, Japanese, Khmer, Norwegian Bokmål, Dutch, Polish, Portuguese, Brazilian Portuguese, Russian, Slovak, Swedish, Turkish, Ukrainian, Uzbek, Vietnamese, Simplified Chinese, and Traditional Chinese
Website https://josm.openstreetmap.de
Source code https://josm.openstreetmap.de/svn/trunk
Programming language Java

Offline highly expandable map editor

JOSM logo since August 2019

JOSM (Java OpenStreetMap Editor) is a desktop application originally developed by Immanuel Scholz and currently maintained by Dirk Stöcker. Its homepage is located at josm.openstreetmap.de.

Although it has a relatively steep learning curve, JOSM is popular among experienced editors thanks to its plugins and stability. There are other editors for OpenStreetMap data, like iD or Potlatch 2. JOSM is a feature-rich editor with an interface which can seem complex at first. If you are unsure which editor to use, see the Comparison of editors article.

Installation

JOSM can be downloaded from the JOSM homepage. Many Linux distributions offer JOSM packages. See JOSM/Linux. It can be run as a local Java installation or with Java WebStart, which causes the latest version to be fetched over the Internet each time the program is run. Java version 1.8, minimum, is required to run JOSM as of 2017. The site security certificates for JOSM WebStart are invalid and will generate multiple warnings during startup, requiring the user to accept exceptions several times before the program is ready to use.

See subpage Installation for more details

Usage

JOSM screenshot, editing in Cleveland, Ohio, USA

JOSM/Guide

The Guide will take you through getting started, downloading some data, basic editing and more advanced editing features. It is intended for beginners to read the guide from the beginning. This is a descriptive guide providing a simple introduction. Some details are intentionally left out.

JOSM/FAQ

Will cover common questions.

Video Tutorials

Main article: Video_tutorials#JOSM_video_collection

Several good tutorials have been created and shared by the Humanitarian OpenStreetMap Team via YouTube:

JOSM Basics (1.5hrs, 2019)

https://youtu.be/iwJnZQFi_C8

Two Minute Tutorials: Drawing Buildings in JOSM (2015)

https://youtu.be/DcKewl94jR4

Help with JOSM

The JOSM Help manual should provide more exhaustive in-depth explanations of each JOSM feature. It is intended to be used as a reference manual, rather than reading from end-to-end. It is also accessible by pressing F1 within the application (context sensitive help)

Bookmarklets

Open any relation from openstreetmap.org directly in JOSM.

javascript:(function(){id=location.href.match(/www\.openstreetmap\.org\/relation\/(\d+)/);if(id!=null){window.open('http://127.0.0.1:8111/load_object?objects=r'+id[1]);}else{alert('This is not a valid Openstreetmap.org relation page.')}})()

(Credits to pangoSE, Eugene and The knife)

See also bookmarklets to open relations from Waymarked Trails in JOSM.

JOSM Validator

Main article: JOSM/Validator

See also

See subpage Plugins for optional extensions that can be downloaded and installed in JOSM
See subpage Presentations for talks about JOSM given at various conferences