A Guide to the Training Session 2 - Mapping areas in OpenStreetMap with JOSM editor and the Training Session 3 - Validation with JOSM editor and other programs

Training sessions on Mapping with OpenStreetMap 2025 - Dr. Raquel Dezidério Souto Training session #1 - MAPPING WAYS IN OPENSTREETMAP WITH ID EDITOR Training session #2 - MAPPING AREAS IN OPENSTREETMAP WITH JOSM EDITOR Training session #3 - VALIDATION WITH JOSM EDITOR AND OTHER PROGRAMS Dr. Raquel Dezidério Souto - IVIDES DATA® - dra.ra[email protected] Video Record - pt-BR* - Training session #1 (18 set. 2025) - https://youtube.com/live/vuTZWaiutFU Video Record - pt-BR* - Training session #2 (02 out. 2025) - https://youtube.com/live/x0kAau2VLDY Video Record - pt-BR* - Training session #3 (15 out. 2025) - https://youtube.com/live/MyOQVqlO5MM * You can activate the auto translation in the controls of the video on YouTube and select English. JOSM Home Page: https://josm.openstreetmap.de/ JOSM Wiki OSM: https://wiki.openstreetmap.org/wiki/JOSM CONTENT Training session #1: https://doi.org/10.5281/zenodo.17162510 (PDF) (pt-BR | EN) Training sessions #2 and #3 as below 1 - JOSM instalation and requirements •You must install Java JRE v. 11+ in the computer (if not installed) before installing the Java OpenStreetMap Editor (JOSM); •Download the installer - https://josm.openstreetmap.de/ and run it on your computer. If the installation does not work, install directly from the server, clicking on: josm.jnlp; •When starting up, it should display a screen with warnings and general information; •Configure the JOSM environment (see the section 2 below) and install the plugins (see the section 3 below) before you start mapping; •Configure the remote control in JOSM (as the section 2 below) to open the area in the editor directly from the web browser (chosen area on the website https://osm.org). [email protected] IVIDES DATA® 1 de 7 To access this document in Brazilian portuguese: https://doi.org/10.5281/zenodo.17376118 Training sessions on Mapping with OpenStreetMap 2025 - Dr. Raquel Dezidério Souto 2 - Configuration of the JOSM and basic editing - some sources: A - Part #6 of the "Course on mapping with OpenStreetMap" [in pt-BR] Home page - https://ivides.org/curso-osm-parte-6 Lesson (PDF) - https://ivides.org/wp-content/uploads/2024/01/aula06_curso_osm2023_ed2.pdf B - JOSM in the Wiki OSM - https://wiki.openstreetmap.org/wiki/JOSM/Guide C - JOSM in the LearnOSM - https://learnosm.org/en/josm/ (a little outdated) D - JOSM Functions (with examples): https://josm.openstreetmap.de/wiki/Help/Action 3 - Plugins - Installed directly in the JOSM Preferences menu: •FULL LIST - https://josm.openstreetmap.de/wiki/Plugins •buildings_tools - design buildings more easily, already includes the tag building=yes https://wiki.openstreetmap.org/wiki/JOSM/Plugins/BuildingsTools •BuildingGeneralization - correct the angle of buildings to 90 degrees and align all loaded buildings to the nearest road https://wiki.openstreetmap.org/wiki/JOSM/Plugins/Building_Generalization •conflation - allows you to compare two layers and eliminate data overlaps, allowing you to upload only data that is not already in the OSM cartographic database https://wiki.openstreetmap.org/wiki/JOSM/Plugins/Conflation •countourmerge - join the outline of areas https://wiki.openstreetmap.org/index.php/JOSM/Plugins/ContourMerge •FastDraw - draw areas freehand more easily, when you need to define one or more tags https://wiki.openstreetmap.org/wiki/JOSM/Plugins/FastDraw •FieldPapers - Load the mapped data onto the printed maps with the FieldPapers (focused in sketch maps) - https://wiki.openstreetmap.org/wiki/JOSM/Plugins/FieldPapers •GeoJSON - allows you to load layers in .geojson format https://wiki.openstreetmap.org/wiki/JOSM/Plugins/GeoJSON [email protected] IVIDES DATA® 2 de 7 Training sessions on Mapping with OpenStreetMap 2025 - Dr. Raquel Dezidério Souto •geotools - library required for others plugins https://learnosm.org/pt/josm/josm-relations/ •imagery_offset_db - image displacement database https://wiki.openstreetmap.org/wiki/Imagery_Offset_Database •ImportImagePlugin - allows you to import georeferenced images (of certain formats) into JOSM, transforming them from different coordinate reference systems (CRS) to WGS-84 (used in OSM) - https://wiki.openstreetmap.org/wiki/JOSM/Plugins/ImportImagePlugin •Mapillary - displays photographs at street level to facilitate mapping https://wiki.openstreetmap.org/wiki/JOSM/Plugins/Mapillary •mapwithai - allows mapping with MapWithAI (the same AI used in the RapiD editor) https://github.com/JOSM/MapWithAI •markseen - displays a mini map in the JOSM, useful when mapping larger areas https://github.com/JOSM/markseen •Mbtiles - allows you to display tilesets and mbtiles as background images https://wiki.openstreetmap.org/wiki/JOSM/Plugins/Mbtiles •Multipol - easily creates relations with the mouse button https://wiki.openstreetmap.org/wiki/JOSM/Plugins/multipoly •opendata - allows you to open different file formats (.CSV, .XLS, .ODS, .KML, .KMZ, .SHP, ,MIF) directly in JOSM and save them in .OSM format. It supports .ZIP and .7Z compression formats https://wiki.openstreetmap.org/wiki/JOSM/Plugins/OpenData •pbf - allows you to import .PBF files (which have a larger capacity than .OSM format) directly into JOSM - https://learnosm.org/pt/josm/josm-relations/ •pdfimport - allows you to import ways from an imported PDF directly into JOSM https://wiki.openstreetmap.org/wiki/JOSM/Plugins/Pdf_Import •PicLayer - allows you to import images in different formats. An alternative to ImportVec, as it is easier to use - https://wiki.openstreetmap.org/wiki/JOSM/Plugins/PicLayer [email protected] IVIDES DATA® 3 de 7 Training sessions on Mapping with OpenStreetMap 2025 - Dr. Raquel Dezidério Souto •RelationDissolve - dissolves adjacent relations into a single relation https://wiki.openstreetmap.org/wiki/JOSM/Plugins/RelationDissolve •Relation Toolbox (reltoolbox) - panel for editing relation https://wiki.openstreetmap.org/wiki/JOSM/Plugins/Relation_Toolbox •Reverter - Reverse a set of changes or undo the changes made in a specific changeset or changesets - https://wiki.openstreetmap.org/wiki/JOSM/Plugins/Reverter •SeaChart - allows you to load nautical chart images directly into JOSM •SeaMapEditor - preset of tags related to the sea in the OpenSeaMap (focusing in navigation), such as lighthouses, ports and others •Terracer - allows you to draw terraced buildings as independent polygons and including identification numbers automatically https://wiki.open streetmap.org/wiki/JOSM/Plugins/Terracer | vídeo demonstrativo •Todo - allows you to make bulk edits https://wiki.openstreetmap.org/wiki/JOSM/Plugins/TODO_list •Undelete - Allows you to recover deleted features https://wiki.openstreetmap.org/wiki/JOSM/Plugins/Undelete •Utilsplugin2 - allows easy editing of features https://wiki.openstree tmap.org/wiki/JOSM/Plugins/utilsplugin2 •Wikipedia - allows you to include tags for Wikipedia and Wikidata entries, used in feature documentation - https://wiki.openstreetmap.org/wiki/JOSM/Plugins/Wikipedia 4 - Drawing areas with JOSM - important tips: •Use the FastDraw plugin (pencil icon in the left menu) to better draw curved features. When finished, press Enter; and to join the start and end nodes of the area (Tools >> Merge nodes). [email protected] IVIDES DATA® 4 de 7 Training sessions on Mapping with OpenStreetMap 2025 - Dr. Raquel Dezidério Souto •Observe the land division in the background image, draw the areas as broadly as possible, and, if necessary, use multipolygons to distinguish smaller areas within the larger one, such as the presence of one or more lakes or dams, islands etc.; •Do not draw connected land cover and land use areas (sharing nodes) with highways that pass through the feature; however, if more than one highway passes through it and they intersect, these highways must be connected to each other, with a common node at the intersection; •In the case of rivers (waterway=river) and streams (waterway=stream), draw them connected to other bodies of water, such as lakes, lagoons etc. (a node shared between the road and the area).; •Do not overlap farmland with natural formations such as forests (natural=wood), as this is not the case in the real world, except in very rare cases such as permaculture; •The same applies to overlaps with buildings or other features that do not overlap in the real world; they will also not be vectorized (drawn) as overlaps; •The landuse=residential tag is used for larger groups of buildings. Do not use it to encompass small groups of buildings within agricultural areas, for example. The same reasoning applies to blocks in urban areas: do not map them as landuse=residential, but apply this tag to the area that encompasses all the blocks; •About customizing background images in JOSM (with geoservices) https://josm.openstreetmap.de/wiki/Maps 5 - Relation •One of the three fundamental types of OSM elements (the others are node and way), used to relate features, since OSM allows the creation of complex objects formed by multipoints, multilines, and multipolygons: Multipoints - set of nodes, e.g., set of mine entrances in a mining area; Multilines - set of open ways (lines), e.g., set of lines of a very long watercourse; Multipolygons - set of closed ways and areas, e.g., buildings with one or more; central open areas (see https://wiki.openstreetmap.org/wiki/Roof_modelling for roof modelling and for 3D roof modelling; Mixed - mix more than one basic type of element; [email protected] IVIDES DATA® 5 de 7 Training sessions on Mapping with OpenStreetMap 2025 - Dr. Raquel Dezidério Souto •In relations, the members of the relation have distinct roles — outer (external) and inner (internal); •Functions Create Multip olygon and UpdateMultipolygon - allow you to easily create or update relations (see the next section of this document); •(*) In JOSM, we can only upload up to 2,000 nodes in a same changeset (one upload), including those that are part of open ways (lines) and closed ways (areas). For example, in the case of very long rivers, several lines can be used and a relation established to group them together. The same applies to other very large features such as conservation units and other areas with internal features, such as farms or settlements. 6 - A simple guide to create relations with JOSM Note: You must have the plugins indicated in section 3 of this document installed. •Before you begin, activate the "Relations" and "Selection" windows in the top menu >> Windows •To create a relation, draw the areas (and/or lines, points) that will make up the relation •Select all the features that will make up the relation (hold down SHIFT and click on the features); •Top menu >> Tools >> Create multipolygon •Fill in the relation tags (tags of all multipolygon) — in some cases, certain tags are common to all features, while in others, the labels may differ •Define the functions (“outer” or “inner”) of the members of the multipolygon and save •To edit a relation, click on it and in the relations panel, click on the pencil to edit the multipolygon; adjust the types (outer or inner) and/or the relation tags and save •In the top menu of the window >> Tools >> Update multipolygon 7 - Validation with JOSM and other programs For the following actions, we recommend some programs, almost all of which work directly in your Internet browser, with the exception of JOSM. For programming routines, recommend Osmium. [email protected] IVIDES DATA® 6 de 7 Training sessions on Mapping with OpenStreetMap 2025 - Dr. Raquel Dezidério Souto A - Checking the geometry of the features •JOSM B - Identification of duplicate data and checking of data integrity •JOSM and iD •OSMCha - https://wiki.openstreetmap.org/wiki/OSMCha | https://osmcha.org/ •Osmose - https://wiki.openstreetmap.org/wiki/Osmose https://osmose.openstreetmap.fr/en/map/#loc=10/-22.9295/-42.8568 •OSM Inspector - https://wiki.openstreetmap.org/wiki/OSM_Inspector https://tools.geofabrik.de/osmi/ C - Checking the tag attribution •OSMCha, Osmose, OSM Inspector Important tips •There is a limit of up to 2,000 nodes that can be sent per upload (per changeset), including ALL the nodes (as nodes belonging to ways). If you need to draw features with more than this limit, perform different uploads and create a relation to the feature •If the feature has an error in its geometry (as open polygons and others) or tagging (incomplete or other problems), the feature can not appear on the map on https://osm.org •The editor itself warns about mandatory corrections (errors) and warnings •Tagging errors are also reported by the validator of JOSM •Validation rules can be specific to certain countries or regions 8 - Conflict resolution with JOSM When importing bulk data or making minor edits, conflicts may arise between two versions for the same area due to corruption of the existing object schema. To resolve this, you can usually download the same area in JOSM and then use the conflation plugin to resolve the conflicts. How to cite: SOUTO, Raquel Dezidério. Guide - Training Session 2 - Mapping areas in OpenStreetMap with JOSM editor, and Training Session 3 - Validation with JOSM editor and other software. Training sessions on mapping with OpenStreetMap 2025. 4h. Online. Rio de Janeiro, Brasil: IVIDES DATA, Oct. 16. 2025. DOI: https://doi.org/10.5281/zenodo.17376081 [email protected] IVIDES DATA® 7 de 7 Translated with DeepL.com™ and with human review.