[[PageOutline(2-3,Table of Contents,inline,unnumbered)]] [[TranslatedPages]] = Welcome to the JOSM online help system = {{{ #!html

This help can be corrected at josm.openstreetmap.de/wiki/Help
Some information might be outdated, because JOSM is constantly enhanced with more features and tools. Recently implemented features may miss good illustrations, animations, examples and text explanation. Please help improving by adding them or your personal tips and experience - this is a wiki!

}}} == Getting Started == === Your first edits with JOSM === * [wiki:Introduction Introduction to JOSM] * Migration assist from [wiki:iD], [wiki:Potlatch2] or [wiki:Vespucci] === OSM-wiki resources === * [osmwiki:Get_help Where to get help?] - more general articles and resources (including [osmwiki:Map_Features Map features]) == Concepts == === OSM data model === * [wiki:Help/Concepts/Object Objects] - explains what '''node''', '''way''', '''relation''' and '''tag''' is * There [wiki:Help/Concepts/Object#Relations many types of relations], currently loaded relations can be selected via [wiki:Help/Dialog/RelationList Relation list] but there [wiki:Help/Dialog/RelationEditor single interface to edit them] === JOSM === * [=#hotkeys Hotkeys] or shortcuts. **EVERY** "button" and menu item may be assigned with hot-key (including menu items provided with [wiki:Plugins plugins]; popular [wiki:Presets presets] and [wiki:Help/Action/Search#SavesearchqueryinMaintoolbar saved search queries]). Some [wiki:Shortcuts default hotkeys] may surprise editors from iD and Poltrach. All shortcuts will be present under [Help/Preferences/Shortcuts "Hotkeys" tab in F12 menu] you can adjust and fine-tune them or reset at any moment. * [=#preferences Preferences] [wiki:Help/Preferences (complete reference)] - some of the settings [Help/Preferences/Advanced#Explanation are not accessible via settings menu] or just spread everywhere in the editor * [=#changeset Changeset] [wiki:Help/Action/Upload (upload changeset dialog)] - explains why you create a '''changeset''' and low level details when you upload data to the OSM server * [=#undoredo Undo/redo mechanism] - similar to other editors, ''for most operations'' JOSM supports can be [Help/Action/Undo undone] and [Help/Action/Redo redone], unless they are listed in [wiki:Help/List List of irreversible operations list of irreversible operations. Difference is that all changes can be displayed in [Help/Dialog/CommandStack command stack dialog]. These tools especially useful when learning new tools to you in JOSM. == Workflow examples == * [[Help/Downloading data]] - there many ways to load existing data in JOSM * [wiki:Help/AudioMapping Audio mapping:] playing voice notes and synchronizing them with your GPS tracks in JOSM * [wiki:Help/Preferences/Validator Validator messages] - will explain how to fix common mistakes and what do they mean * [wiki:HowTo How to create runabout from crossing ways] {{{ #!html }}} == JOSM tools == Search among all JOSM tools and menu items - Ctrl+Spacebar === Basic shape of objects === * [Help/Action/Select Select, move and rotate] tools - you only need subset of tools from this list * [Help/Action/DrawBuilding Draw a rectangular stub] - optionally aligned along by other objects * [Help/Action/FastDrawingMode FastDraw] - useful with natural objects; * [Help/Action/Extrude Extrude], [Help/Action/Draw#Anglesnapping Angle snapping], Spline or Bezier ''from commandline'' - mostly for man made objects * both [Help/Action/Draw Draw nodes mode] (A) and [Help/Action/ImproveWayAccuracy Improve Way Accuracy mode] (W) - have their followers and use cases === Selection === Current selection displayed in [wiki:/Help/Dialog/SelectionList Selection Dialog]. * [Help/Action/Select#Selecttool Select] (S) - contain many modifiers, including [Help/Action/LassoMode lasso mode] * [Help/Action/Search Search] (Ctrl+F) - a very powerful tool and a query language with [wiki:Help/Action/Search#Keywords over 28 keywords] and flexible operators to combine them in flexible manner. Not to mention regex and mapcss filters. * (Shift+F3) - search objects by preset * [[Help/Plugin/UtilsPlugin2#Selection]] - multiple selection focused tools ''from UtilsPlugin2'' * [Help/Action/SelectNonBranchingWaySequences Select non branching way sequences] (Shift+W) - useful when editing highways, railways, rivers, power networks and networks in general * [Help/Action/SelectAll Select all] (CTRL+A) is more useful after you download precise list of objects === Tags === Tags of currently selected objects displayed in [wiki:Help/Dialog/TagsMembership Tags/Memberships Dialog]. * [Help/Action/Copy Copy] (Ctrl+C) - copy selected objects to the buffer * [Help/Action/PasteTags PasteTags] (Ctrl+Shift+V) - paste previously copied tags * Tabular editor (Ctrl+T) from ([[Help/Plugin/UtilsPlugin2]]) * [Help/Action/Duplicate Duplicate] (Ctrl+D) not only tags but also their geometries * (Shift+R) (from [[Help/Plugin/UtilsPlugin2]]) copy tags from previous selection * Standard [Help/Dialog/AddValue Add value] (Alt+A) dialogue provides 5 shortcuts to 5 last used tags without closing this dialogue === Topology tools and changes === * [Help/Action/MergeNodes Merge] (M) two or more points * [Help/Action/UnGlue UnGlue] (G, opposite of above) explode single point into multiple * [Help/Action/MoveNodeWay Join point into a way segment] (N) * [Help/Action/DisconnectNodeWay DisconnectNodeWay] (Alt+J, opposite of above) disconnect a node from a way segment * [Help/Action/AddIntersections AddIntersections] (Shift+I) (from [[Help/Plugin/UtilsPlugin2]]) - will create nodes at places where current selections intersects (or self intersects) * [Help/Action/SplitObject Split geometry by selected line] (Alt+X) (from [[Help/Plugin/UtilsPlugin2]]) * [Help/Action/SplitWay Split way] (P) - split way by a node * [Help/Action/CombineWay Combine Way] (С) - combine several selected ways in one * [Help/Action/JoinAreas Join overlapping areas] (Shift+J) * [Help/Plugin/ContourMerge ContourMerge] mode can used to glue complex parts that would require too many ''Merges'' otherwise; it could also used to partially or full replace geometry of one object with partial or a complete geometry of other object === Geometry tools === ==== Precision in angles ==== * [Help/Action/Draw#Anglesnapping Anglesnapping] (A, twice) will ease drawing way segments in 30°, 45°, 60° and 90° degrees * [Help/Action/Extrude#Basicusage Extrude] (X, with modifiers) tool will ease drawing of strictly perpendicular segments ==== Alignment ==== * [Help/Action/AlignInLine Align in line] (L) will align selected nodes into a line * [Help/Action/DistributeNodes Distribute] (Shift+B) as above, but also place them at equal distances * [Help/Action/Parallel Parallel] (Shift+P), draw lines and curves parallel to each other, draw nested infrastructure quickly * "Copy" objects at precise anchor points ''from commandline'' * "Move" objects at custom vector ''from commandline'' * [Help/Action/AlignInCircle Align selected nodes in circle] (O) === Viewport control === * Explained at [Help/MapView MapView], [Help/Menu/View "View" menu] and [Help/Action/Zoom Zoom tool] * [Help/Action/JumpToPosition JumpToPosition] == JOSM interface == {{{ #!html }}} || [[Image(9229-en.png, 300px)]] || [[Image(9229-en-expert-false-Moscow Kremlin.png, 300px)]] || [[Image(9229-en-expert-true-Moscow Kremlin.png, 300px)]] || [[Image(9229-en-expert-true-Moscow Kremlin-terminology.png, 300px)]] || || Starting screen may be confusing for newcomers, you need to get data first using [Help/Action/Download Download menu] || Here is what you will see if you choose Moscow Kremlin || Additional and more complex tools may be activated with [Help/ExpertMode Expert mode] (pay attention to the left side of the screen) || [[wiki:JOSM interface]]: 1 - '''[wiki:Help/Menu main menu]''', 2 - [Help/MainToolbar main toolbar], 3 - [Help/EditToolbar edit toolbar], 4 - [Help/StatusBar status bar], 5 - ..., 6 - '''[Help/ToggleDialogs toggle dialogs]''', 7 - Search menu items, 8 - [Help/MapView map view]. See also [[Help/JOSM interface customization]] ||