[[TranslatedPages(outdated=This page is incomplete and heavily outdated. The "settings" and "offset bookmark" tabs are not explained. The screenshots are outdated. WMTS is missing. Changes from #16249 and #16301 are missing.)]]
= Preferences > Imagery =

[[Image(source:trunk/images/preferences/imagery.png)]] **Adding or deleting predefined/custom WMS/TMS/WMTS imagery sources,** general imagery settings and offset bookmarks.

To display an imagery in the MapView use the main menu [Help/Menu/Imagery Imagery].

[[PageOutline]]

== Imagery providers ==
This is the place to modify the list of imagery providers that is presented in the imagery menu and from which you can activate the imagery layers.

=== Activate more items in Imagery menu ===

[[Image(predefined-imagery.png,400px)]]
1. Select one or more imagery provider of interest in the **Available default entries** table on the left
1. Optional: verify bounds on the map on the right
1. Click **Activate** (Activated default entries are highlighted green in both lists.)
1. Click **OK** to close the preferences dialog

=== Custom imagery URL ===

==== Add custom WMS imagery ====
1. Click [[Image(source:trunk/images/dialogs/add.png,18)]] just to the right of the **Selected entries** table on the bottom half of this tab
[[Image(wms.png,400px)]]
1. Insert **Menu Name**
1. Paste **Service URL** (Mac users: paste is ctrl-v in josm)
1. Click **Get Layers**
1. Select one or more layers
1. Click **OK** to close the window
1. Click **OK** to close the preferences dialog


==== Troubleshooting ====
If the WMS layer list cannot be loaded, a warning dialog is shown:

[[Image(wms-error.png)]]

To trace the problem, copy the URL from most recent line from the console (e.g., `GET http://vogis.cnv.at/mapserver/mapserv?...`) and open it in your browser.


==== Add custom TMS imagery ====
[[Image(tms.png,400px)]]
1. Click [[Image(source:trunk/images/dialogs/add.png,18)]] just to the right of the **Selected entries** table on the bottom half of this tab
1. Click **TMS**!
1. Insert **Menu Name**
1. Paste **TMS URL**, replace `x`, `y`, `zoom` parameter in the URL by `{x}`, `{y}`, `{zoom}`, respectively. Use for instance `{switch:a,b,c}` or `{switch:1,2,3,4}` for a random selection of the subdomain. Example: `http://{switch:a,b,c}.www.toolserver.org/tiles/bw-mapnik/{zoom}/{x}/{y}.png`. See [[Maps#TileMapServicesTMS]] for more options.
1. Optional: insert the zoom range in **Zoom**
1. Click **OK** to close the preferences dialog


=== Delete entry from imagery list ===
1. Select one or more entries in the **Selected entries** table on the bottom half of this tab
1. Click [[Image(source:trunk/images/dialogs/delete.svg,18)]] to delete selected entries
1. Click **OK** to close the preferences dialog

=== Advanced: Add entry to list of predefined imagery ===
Read the [[Maps#Documentation|Documentation]] and edit [[Maps]].

=== Notes ===
==== Meaning of green and white rows ====
In upper table:
  Green means item is also listed in lower table. (This is called "activated".)

In lower table:
  Green means item is also listed in upper table.

In both tables if an item is white, it will only be found in one table,
not both.

Neither green nor white lines have any relation to the state / health of the
servers they mention, nor the validity of the URLs they contain.

== Cache contents ==
[[Image(scr_imagery_prefs_cache.png,400px)]]

You can use the "clear" button in each line to delete the cached images for each source. May need a JOSM restart to take effect in the view.

A possibly existing "Mapnik" line [[ticket:17054|stems from]] using the [[Help/Action/Download#Slippymap|slippy map shown by the JOSM download dialogue]] in a JOSM version before version 14495 (Dec. 2018). You can safely delete it.