[[TranslatedPages(outdated=This page is incomplete. The "settings" and the "offset bookmark" tabs are not explained.)]]
= Preferences > Imagery =

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

[[TOC]]

== 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.

=== Add predefined imagery ===
[[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**
1. Click **OK** to close the preferences dialog


=== 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.png,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]].