[[TranslatedPages]]

= Migrating From iD to JOSM =
== What is different ==
=== JOSM uses ''right mouse drag'' to '''pan a map''' ===

In JOSM, [wiki:Help/MapView#Movemap you drag with the right mouse button to pan around]. This is unlike osm.org and most other editors.

=== You have to download OSM data manually ===

It is necessary to get data first: [wiki:Introduction#Downloading].

There is continuosDownload plugin, but you still have to download area at least once (and then continuosDownload will automatically fetch data for you). 

To prevent "loading" progress bars, refer to preferences menu or simply set [Help/Preferences/Advanced Advanced preferences] {{{plugin.continuos_download.quiet_download}}} to true

=== Imagery won't be enabled automatically ===

There is black background in JOSM by default. It will be so until you add an imagery layer.

if you rely on imagery, not on GPX data, not on previous OSM data, you need to select at least one imagery: [wiki:Introduction#EnableAerialimagery "Enable aerial imagery" in Introduction].

=== Searching in presets ===

Text search accessible via {{{F3}}} key, [Help/Action/TaggingPresetSearch Search presets]. [wiki:Introduction#Presets "Presets" in Introduction].

=== Complete preset view ===

Presets are always collapsed, you need to click them each time, [wiki:Introduction#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview it was explained in Introduction].

=== Tags/Memberships Dialog is less suggestive than fields in iD ===

[[Image(source:trunk/images/dialogs/propertiesdialog.svg,nolink,20px,middle)]] [Help/Dialog/TagsMembership Tags/Memberships dialog]

11 "fields" from iD + name=* tag always suggested when an object is selected: 

[[Image(11-fields-are-displayed-in-iD-1.9.2.gif​,unlink)]]

JOSM will show only relevant presets for main tags:

[[Image(one-preset-displayed-in-JOSM-9979.gif,unlink)]]

As alternative:
* N most recent tags are suggested in "[Help/Dialog/AddValue Add value dialog]"
* latest used presets will displayed in [Help/Action/TaggingPresetSearch Presets search (F3) dialog] 

=== 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 [Help/Dialog/TagsMembership Tags/Memberships Dialog]) then press {{{F1}}}
1. 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 dialog is still lead you to a respective wiki page)

=== By default, JOSM has limited support for turn restrictions ===

You can install '''turnrestrictions''' that fixes situation. But some JOSM users still consider iD tool as more ergonomic and intuitive to use.

=== 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 is {{{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 are [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]
* "Custom" URL in JOSM was described at: [Help/Preferences/Imagery#CustomimageryURL Imagery tab in settings]

=== Locator overlay ===

Named "[wiki:Maps#LocatorOverlay Locator Overlay]" in JOSM. Can be [Help/Preferences/Imagery Installed as any background].

=== OpenStreetMap traces ===

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

=== Minimap ===

[Help/Dialog/Minimap minimap] is a [Help/ToggleDialogs window] in JOSM.

=== Fix alignment ===

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


== 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,middle)]] ''Keyboard shortcut:'' '''{{{Ctrl+W}}}''' to toggle between wireframe and mappaint mode
1. Partial fill: [[Help/MapView#Appearance|enabled by default]].
1. No Fill (Wireframe): use [[Image(source:trunk/images/dialogs/mappaint/wireframe_small.svg,20,middle)]] ''Keyboard shortcut:'' '''{{{Ctrl+W}}}''' to toggle between wireframe and mappaint mode

=== Map features ===

There is no direct analogue, but functionality could be emulated using '''Filter dialog''' [[Image(source:/trunk/images/dialogs/filter.png,middle)]] ''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 || {{{M}}} [Help/Action/MergeNodes Merge]. 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] ||
|| move node over existing way || differ || exact analogue || {{{N}}} [Help/Action/MoveNodeWay Join point into a way segment] ||
|| 1, "add point" || differ || exact analogue || {{{A+Shift}}}, [[Help/Action/Draw#Shiftmodifier]] || 
|| Panel with presets and search || differ || exact analogue || {{{F3}}} [Help/Action/TaggingPresetSearch will search in the presets], [wiki:Introduction#Presets Presets were covered in the Introduction] ||
|| 2, "add line" || differ || exact analogue || {{{A}}} [[Help/Action/Draw]] || 
|| 2, "add line", snapping to nodes and lines disabled when you hold "Alt" || differ || exact analogue || {{{A}}} while holding Ctrl [[Help/Action/Draw#Ctrlmodifier]] || 
|| 2, "add line", hold {{{Spacebar}}} || differ || exact analogue || {{{Shift+F}}} [Help/Action/FastDrawingMode Fast Draw mode] ||
|| 3, "add area" || differ || similar tools || {{{A}}} [[Help/Action/Draw]] (in most cases, draw a closed way) or {{{Ctrl+B}}} [Help/Action/CreateMultipolygon Create a multi-polygon] out of multiple ways || 
|| 3, "add area", hold {{{Spacebar}}} || differ || exact analogue || {{{Shift+F}}} [Help/Action/FastDrawingMode Fast Draw mode] ||
|| 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 selected objects (two nodes) || differ || exact analogue || [Help/Action/MergeNodes Merge Nodes] {{{M}}} || 
|| C, combines selected objects (one node and a line) ||  ||  || No analogue: tags from a node will be appended using ";" if there are district values) || 
|| C, combines selected objects (two lines with a common node) || same || exact analogue || [Help/Action/CombineWay Combine Ways] {{{C}}} || 
|| C, combines selected objects, other cases || differ || similar tools || {{{Ctrl+B}}} [wiki:Help/Action/CreateMultipolygon Create a multi-polygon] || 
|| D, unjoins the associated lines || differ || similar tools || {{{G}}} [Help/Action/UnGlue Unglue ways], there is 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 are [wiki:Shortcuts#Viewport more tools] ||
|| -, zoom out || same || exact analogue || {{{-}}} [Help/Action/ZoomOut Zoom out], but there are [wiki:Shortcuts#Viewport more tools] ||
|| {{{←}}}, {{{↑}}}, {{{→}}}, {{{↓}}} pan map || differ || similar tools || {{{Ctrl+←}}}, {{{Ctrl+↑}}}, {{{Ctrl+→}}}, {{{Ctrl+↓}}} move [Help/MapView viewport] ||
|| pan one screen at time: [[br]] {{{Ctrl+←}}}, {{{Ctrl+↑}}}, {{{Ctrl+→}}}, {{{Ctrl+↓}}} or [[br]] {{{Shift+←}}}, {{{Shift+↑}}}, {{{Shift+→}}}, {{{Shift+↓}}}  ||  || || ||
|| switch between backgrounds {{{Ctrl+B}}}   || differ || similar tools || JOSM is more complex but also more flexible: [wiki:Shortcuts#Toggleandswitchbetweenfirst10layersofLayerListDialog Toggle and switch between first/last 10 layers] of [Help/Dialog/LayerList Layers window] ||

== Relations ==

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

=== Multipolygon relations ===

One day you will encounter [osmwiki:Relation:multipolygon multipolygons]. Please don't be afraid of this big page, there is [osmwiki: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 Comman]dline options
* [Help/Preferences/Advanced#Explanation Advanced preferences] and predefined configs ([Help/Preferences#preferences.xml preferences.xml])