[[TranslatedPages]]

= Migrating From iD to JOSM =
== What is different ==
=== JOSM uses ''right mouse drag'' to '''pan a map''' ===
Unlike osm.org, most other editors and software, you have to hold ''right mouse click'' to navigate [Help/MapView the main view in JOSM].

=== Searching in presets ===

Text search accessible via {{{F3}}} key, [Help/Action/TaggingPresetSearch Search presets].

=== You have to read OSM wiki to look up tag definitions ===

JOSM doesn't show translated definitions from wiki, so you have to know tags and their definitions.

You can open page of the tag:
1. select a tag(s) (in [wiki:Help/Dialog/TagsMembership Tags/Memberships Dialog]) then press {{{F1}}}
2. link "More information of this feature" displayed within each [Help/Menu/Presets preset], but you have to open respective preset first. NOTE: you cannot lookup tags of minor tag from a preset(s) (e.g. lit=* definition from ''a motorway preset'' is inaccessible, but pressing {{{F1}}} at lit=* tag in Tags/Memberships dialogue is still lead you to a respective wiki page)

=== In JOSM, you can modify multiple objects simultaneously ===

* In iD, you cannot set tags to 1000 untagged nodes even after you selected them. Search in presets and "tage" menu will disappear. In JOSM, you can apply presets and tags at any second.
* iD will also prevent you from editing '''single tag''' of ''multiple objects at once'' because of it's "simple UI". You can add/correct/update tags to 10 or 1000 objects at once after you selected them (using one of dozens tools).
* You can replace and correct geometry of multiple objects at once (there a {{{Q}}} tool, but you should look for geometry replacement tools in plugins).
* In iD, you have to apply all geometry tools one by one (in most cases). In JOSM, often you can apply single geometry tool to multiple objects.

=== JOSM is also an offline editor ===
In simplest case, it is possible to {{{Ctrl+O}}} [Help/Action/Open Open file] and {{{Ctrl+S}}} [Help/Action/Save Save file] with temporary edits. But there [wiki:Shortcuts#Workflow many more tools].

=== You can undelete "removed" objects and (partially) revert a changeset(s) ===

Yes, JOSM has many more features in general, but these two are unavoidable to correct [osmwiki:JOSM/Plugins/Reverter erroneous changesets].

== Background menu (B) ==

=== Background transparency ===

[Help/Dialog/LayerList#VisibilityLayer You can set a opacity per each imagery layer] using "Visibility" button.

=== Aerial imagery ===
* you have to enable Aerial imagery using [Help/Menu/Imagery Imagery menu] 
* additional sources can be installed via [Help/Preferences/Imagery Imagery tab in settings]

=== Fix alignment ===

Simplest alternative is to use [Help/Action/ImageryAdjust] or install a dedicated plugin for imagery offsets.

=== OpenStreetMap traces ===

Can be downloaded using [[Image(source:trunk/images/download.png,middle,link=)]] [wiki:Help/Action/Download from OSM] ''Keyboard shortcut:'' **{{{Ctrl+Shift+↓}}}**

== Map data menu (F) ==

=== Mapillary images and traffic signs ===

Images can be accesses via Mapillary plugin. (TODO: explain and add link here)

=== Local GPX file ===

Can be opened:
1. using "File > Open" (GPX file or its archived version)
2. simply drag and drop GPX file over running JOSM

=== Fill areas ===

1. Full fill: use [[Image(source:trunk/images/dialogs/mappaint/wireframe_small.svg,20,link=)]] ''Keyboard shortcut:'' '''{{{Ctrl+W}}}''' to toggle between wireframe and mappaint mode
2. Partial fill: no analogue?..
3. No Fill (Wireframe): use [[Image(source:trunk/images/dialogs/mappaint/wireframe_small.svg,20,link=)]] ''Keyboard shortcut:'' '''{{{Ctrl+W}}}''' to toggle between wireframe and mappaint mode

=== Map features ===

There no direct analogue, but functionality could be emulated using '''Filter dialog''' [[Image(source:/trunk/images/dialogs/filter.png)]] ''Keyboard shortcut:''''' {{{Alt+Shift+F}}}'''

[https://github.com/openstreetmap/iD/blob/c4fbacd6250c0245139207c183b3114dcefe2abd/js/id/renderer/features.js Relevant part of iD source code]. TODO: create a config for simpler re-use.

== Shortcuts ==

Unfortunately, [wiki:Shortcuts JOSM shortcuts] are different from [http://wiki.openstreetmap.org/wiki/ID/Shortcuts iD]. Here is some details:

|| '''Topic or iD function or a shortcut''' || '''Activation''' || '''comment''' || '''JOSM material''' ||
|| move one node over another (iD will merge two nodes and glues tag values using ";") || differ || exact analogue || To merge two nodes you can use {{{M}}}. In JOSM terms, iD will automatically select "all" [Help/Action/MergeNodes#Mergeconflict during conflict with "Merge" tool] alternative activation is to hold "Ctrl" when [Help/Action/Select#Move simply moving objects] ||
|| 1, "add point" || differ || exact analogue || {{{A+Shift}}}, [[Help/Action/Draw#Shiftmodifier]] || 
|| 1, "add point" || differ || similar tools || {{{Ctrl+D}}} [Help/Action/Duplicate Duplicate selected objects], {{{F3}}} [Help/Action/TaggingPresetSearch Search presets] || 
|| 2, "add line" || differ || exact analogue || {{{A}}} [[Help/Action/Draw]] || 
|| 3, "add area" || differ || similar tools || {{{A}}} [[Help/Action/Draw]] (in most cases, draw a closed way) or {{{Ctrl+B}}} [Action/CreateMultipolygon Create a multi-polygon] out of multiple ways || 
|| A, continue drawing a line at the selected node || same || exact analogue || {{{A}}} [[Help/Action/Draw#StandardMode]] || 
|| B (background layer switcher) || differ || exact analogue || [[Help/Menu/Imagery]] menu, and be configured in [[Help/Preferences/Imagery]] || 
|| C, combines the selected objects || differ || similar tools || [Help/Action/MergeNodes Merge Nodes] {{{M}}}, [Help/Action/CombineWay Combine Ways] {{{C}}}, [Help/Action/JoinNodeWay Join Node to Way] {{{J}}}, {{{Ctrl+B}}} [Action/CreateMultipolygon Create a multi-polygon] || 
|| D, unjoins the associated lines || differ || similar tools || {{{G}}} [Help/Action/UnGlue Unglue ways], there also tool for relations ||
|| Ctrl+C, copy the selected object || same || exact analogue || {{{Ctrl+C}}} [Help/Action/Copy copy the selected object] ||
|| Ctrl+V, paste a previously copied object || same || exact analogue || {{{Ctrl+V}}} [Help/Action/Paste Paste from buffer] ||
|| M, move objects || differ || exact analogue || {{{Shift+←}}}, {{{Shift+↑}}}, {{{Shift+→}}}, {{{Shift+↓}}} or simply [Help/Action/Select#Move using mouse drag] ||
|| O, circle || same || exact analogue || {{{O}}} [Help/Action/AlignInCircle Align nodes in circle] ||
|| R, rotate object || differ || exact analogue || {{{Shift+Ctrl+}}} mouse move to [Help/Action/Select#Rotate rotate objects] ||
|| S, straighten the selected line, or square the corners || differ || similar tools || {{{Q}}} [Help/Action/OrthogonalizeShape Orthogonalize Shape], {{{L}}} [Help/Action/AlignInLine Align nodes into a straight line], {{{X}}} [Help/Action/Extrude#Basicusage extrude tool], {{{A A}}} [Help/Action/Draw#Anglesnapping angle snapping mode] and [wiki:Help#JOSMtools several others] ||
|| H, show help || differ || exact analogue || {{{F1}}} [wiki:Help show help menu] ||
|| V, reverse ways || differ || exact analogue || {{{R}}} [Help/Action/ReverseWays Reverse Way] ||
|| W, toggle wireframe mode || differ || exact analogue || {{{Ctrl+W}}} [Help/Action/WireframeToggle Toggle between wireframe and mappaint mode] ||
|| Ctrl+Z || same || exact analogue || {{{Ctrl+Z}}} [Help/Action/Undo Undo] ||
|| Ctrl+Y || same || exact analogue || {{{Ctrl+Y}}} [Help/Action/Redo Redo] ||
|| Ctrl+S || differ || exact analogue || {{{Ctrl+Shift+↑}}} [Help/Action/Upload Upload] to main server ||
|| X, split line || differ || similar tools || {{{P}}} [Help/Action/SplitWay Split Way] is more restrictive, requires more actions ||
|| Ctrl + {{{+}}} || differ || similar tools || {{{Ctrl+J}}} [Help/Action/JumpToPosition Opens the Jump To Position dialog] or {{{Ctrl+L}}} [Help/Action/OpenLocation Open location] ||
|| Ctrl + {{{-}}} || differ || similar tools || {{{1}}} [Help/Action/ZoomToData Zoom to data], {{{2}}} [Help/Action/ZoomToLayer Zoom to layer], {{{3}}} [Help/Action/ZoomToSelection Zoom to selection] and [wiki:Shortcuts#Viewport others] ||
|| Ctrl+Delete or Ctrl+Backspace || differ || exact analogue || {{{Delete}}} [Help/Action/EditDelete Delete] ||
|| Alt+Mouse click || differ || exact analogue || {{{A+Ctrl}}} [Help/Action/Draw#Ctrlmodifier place node without connecting to existing object] ||
|| Shift+Mouse click at each object || same || exact analogue || {{{Shift}}}+mouse click to [Help/Action/Select#Selectingmultipleobjects select multiple objects] ||
|| Shift+Draw a loop around objects || differ || exact analogue || Simply draw a loop using mouse: [Help/Action/LassoMode lasso tool] ||
|| Escape stop drawing of a line or area || same || exact analogue || {{{Escape}}} also [Help/Action/UnselectAll unselect all] selected elements || 
|| /, toggle minimap || differ || exact analogue || [Help/Dialog/Minimap minimap] ||
|| +, zoom in || same || exact analogue || {{{+}}} [Help/Action/ZoomIn Zoom in], but there [wiki:Shortcuts#Viewport more tools] ||
|| -, zoom out || same || exact analogue || {{{-}}} [Help/Action/ZoomOut Zoom out], but there [wiki:Shortcuts#Viewport more tools] ||
|| {{{←}}}, {{{↑}}}, {{{→}}}, {{{↓}}} pan map || differ || similar tools || {{{Ctrl+←}}}, {{{Ctrl+↑}}}, {{{Ctrl+→}}}, {{{Ctrl+↓}}} move [Help/MapView viewport] ||
|| pan one screen at time: {{{Ctrl+←}}}, {{{Ctrl+↑}}}, {{{Ctrl+→}}}, {{{Ctrl+↓}}} or {{{Shift+←}}}, {{{Shift+↑}}}, {{{Shift+→}}}, {{{Shift+↓}}}  ||  || || ||

== Relations ==

=== Tools to edit relations ===
* [Action/CreateMultipolygon Create a multi-polygon] {{{Ctrl+B}}}
* [Help/Dialog/RelationList Relation List] toggle dialogue
* [Help/Dialog/RelationEditor Relation Editor] - main interface when editing a relation
* [http://wiki.openstreetmap.org/wiki/JOSM/Plugins/Relation_Toolbox relation toolbox plugin] (optional)

=== Multipolygon relations ===

One day you will encounter [http://wiki.openstreetmap.org/wiki/Relation:multipolygon multipolygons]. Please don't be afraid of this big page, there [http://wiki.openstreetmap.org/wiki/Multipolygon_Examples slightly outdated guide (ignore tagging) with decent illustrations].

== URL parameters ==

https://github.com/openstreetmap/iD/blob/master/API.md#url-parameters 

Excluding other regular JOSM tools:
* via [Help/Preferences/RemoteControl Remote control plugin]
* Help/CommandLineOptions
* [Help/Preferences/Advanced#Explanation Advanced preferences] and predefined configs ([Help/Preferences#preferences.xml preferences.xml])