= Imagery sources =
This wiki page provides imagery sources for JOSM. You can add more WMS and TMS servers to the list below, but make sure, they can be used for OpenStreetMap.
== List of services (editable) ==
{{{
#!maps
Landsat
wms
true
NASA:4326
EPSG:32641
EPSG:3857
EPSG:3785
EPSG:32642
EPSG:32640
EPSG:4326
EPSG:900913
EPSG:3395
EPSG:32639
EPSG:32638
EPSG:32637
EPSG:32636
EPSG:32635
Yahoo Sat
html
Bing Sat
bing
true
http://www.bing.com/maps/
MapQuest Open Aerial
tms
true
http://oatile{switch:1,2,3,4}.mqcdn.com/tiles/1.0.0/sat/{zoom}/{x}/{y}.png
OpenStreetMap (Mapnik)
tms
true
http://tile.openstreetmap.org/{zoom}/{x}/{y}.png
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
OpenStreetMap (Mapnik Black & White)
tms
true
http://{switch:a,b,c}.www.toolserver.org/tiles/bw-mapnik/{zoom}/{x}/{y}.png
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
OpenCycleMap
tms
http://tile.opencyclemap.org/cycle/{zoom}/{x}/{y}.png
17
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
OpenStreetMap (TilesAtHome)
tms
http://tah.openstreetmap.org/Tiles/tile/{zoom}/{x}/{y}.png
17
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
MapQuest OSM
tms
http://otile{switch:1,2,3,4}.mqcdn.com/tiles/1.0.0/osm/{zoom}/{x}/{y}.png
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
ODBL coverage
tms
http://osm.informatik.uni-leipzig.de/osm_tiles2/{zoom}/{x}/{y}.png
5
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
Public Transport (ÖPNV)
tms
http://tile.memomaps.de/tilegen/{zoom}/{x}/{y}.png
18
© OpenStreetMap contributors, CC-BY-SA
http://öpnvkarte.de/
OpenStreetMap (German Style)
tms
http://{switch:a,b,c,d}.tile.openstreetmap.de/tiles/osmde/{zoom}/{x}/{y}.png
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
EU
Streets NRW Geofabrik.de
wms
EPSG:4326
EPSG:900913
DE
Hike & Bike
tms
http://toolserver.org/tiles/hikebike/{zoom}/{x}/{y}.png
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
DE
OpenStreetMap (Sorbian Language)
tms
http://toolserver.org/tiles/osm-locale-hsb/{zoom}/{x}/{y}.png
17
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
DE
OpenStreetMap (German Language)
tms
http://toolserver.org/tiles/osm-locale-de/{zoom}/{x}/{y}.png
17
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
DE
OpenPT Map
tms
http://openptmap.de/tiles/{zoom}/{x}/{y}.png
5
16
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
DE
Bavaria (2 m)
wms
EPSG:31467
EPSG:31468
EPSG:25832
EPSG:25833
EPSG:4258
EPSG:4326
DE
Geoimage.at MaxRes
wms
EPSG:3857
EPSG:900913
EPSG:31287
EPSG:3034
EPSG:3035
EPSG:3044
EPSG:3045
EPSG:31254
EPSG:31255
EPSG:31256
EPSG:31257
EPSG:31258
EPSG:31259
EPSG:32632
EPSG:32633
EPSG:3416
EPSG:4258
EPSG:4326
CRS:84
geoimage.at
http://www.geoimage.at/geoimage/geodatendienste
AT
Tiris: DGM (Terrain model)
wms
EPSG:4326
EPSG:31254
tiris.tirol.gv.at
AT
Tiris: DOM (Surface model)
wms
EPSG:4326
EPSG:31254
tiris.tirol.gv.at
AT
MSR Maps Topo
wms
EPSG:26904
EPSG:26905
EPSG:26906
EPSG:26907
EPSG:26908
EPSG:26909
EPSG:26910
EPSG:26911
EPSG:26913
EPSG:26914
EPSG:26915
EPSG:26916
EPSG:26917
EPSG:26918
EPSG:26919
EPSG:26920
EPSG:4326
USDA:ALBERS-US
USDA:ALBERS-AK
US
MSR Maps Urban
wms
EPSG:26904
EPSG:26905
EPSG:26906
EPSG:26907
EPSG:26908
EPSG:26909
EPSG:26910
EPSG:26911
EPSG:26913
EPSG:26914
EPSG:26915
EPSG:26916
EPSG:26917
EPSG:26918
EPSG:26919
EPSG:26920
EPSG:4326
USDA:ALBERS-US
USDA:ALBERS-AK
US
Czech CUZK:KM
wms
EPSG:102067
EPSG:32633
EPSG:32634
EPSG:28403
EPSG:28404
EPSG:5221
EPSG:5224
EPSG:5225
EPSG:4326
EPSG:4258
EPSG:3035
EPSG:2065
CZ
Czech UHUL:ORTOFOTO
wms
EPSG:2065
EPSG:4326
EPSG:28403
EPSG:28404
EPSG:32633
EPSG:32634
EPSG:102067
CZ
7th Series (OS7)
wms
GB
Ireland British War Office One-Inch 1941-43 GSGS 4136
IE
tms
http://geo.nls.uk/maps/ireland/gsgs4136/{zoom}/{x}/{-y}.png
http://nls.tileserver.com/nls70-nq8.png
http://www.nls.uk/
5
15
National Library of Scotland Historic Maps
http://geo.nls.uk/maps/
Ireland Bartholomew Quarter-Inch 1940
IE
tms
http://geo.nls.uk/maps/ireland/bartholomew/{zoom}/{x}/{-y}.png
http://nls.tileserver.com/nls70-nq8.png
http://www.nls.uk/
5
13
National Library of Scotland Historic Maps
http://geo.nls.uk/maps/
Ireland EEA GMES Urban Atlas
IE
tms
http://a.tile.openstreetmap.ie/tiles/urbanatlas/{zoom}/{x}/{y}.png
http://www.eea.europa.eu/about-us/documents/logos/eps_logos/eea_mini.png
http://www.eea.europa.eu/
5
17
EEA GMES Urban Atlas
http://www.eea.europa.eu/data-and-maps/data/urban-atlas
Ireland EEA CORINE 2006
IE
tms
http://a.tile.openstreetmap.ie/tiles/corine/{zoom}/{x}/{y}.png
http://www.eea.europa.eu/about-us/documents/logos/eps_logos/eea_mini.png
http://www.eea.europa.eu/
5
16
EEA Corine 2006
http://www.eea.europa.eu/data-and-maps/data/clc-2006-vector-data-version-1
Lodi - Italy
wms
EPSG:32632
EPSG:4326
IT
Sicily - Italy
wms
CRS:84
EPSG:4326
EPSG:32633
IT
PCN 2006 - Italy
wms
EPSG:4326
IT
PCN 2008 - IT Lazio+Umbria
wms
EPSG:4326
IT
CRAIG - Auvergne 2009/2010 - 30 cm
wms
EPSG:2154
EPSG:4326
EPSG:900913
EPSG:4171
Orthophotographie CRAIG/TopoGEODIS 2009-2010
http://wiki.openstreetmap.org/wiki/WikiProject_France/CRAIG
FR
CRAIG - Moulins 2009 - 15 cm
wms
Orthophotographie CRAIG/TopoGEODIS 2009
http://wiki.openstreetmap.org/wiki/WikiProject_France/CRAIG
FR
CRAIG - Montluçon 2009 - 15 cm
wms
Orthophotographie CRAIG/TopoGEODIS 2009
http://wiki.openstreetmap.org/wiki/WikiProject_France/CRAIG
FR
CRAIG - Vichy 2009 - 15 cm
wms
Orthophotographie CRAIG/TopoGEODIS 2009
http://wiki.openstreetmap.org/wiki/WikiProject_France/CRAIG
FR
CRAIG - Le Puy 2010 - 15 cm
wms
Orthophotographie CRAIG/TopoGEODIS 2010
http://wiki.openstreetmap.org/wiki/WikiProject_France/CRAIG
FR
Géobretagne - Brest 2010 - 10 cm
wms
FR
Géobretagne - Morbihan 2010
wms
FR
Géolittoral - Orthophotos 2000
wms
Ortho littorale 2000
http://wiki.openstreetmap.org/wiki/WikiProject_France/G%C3%A9oLittoral
FR
Géolittoral - Sentiers
wms
Ortho littorale 2000
http://wiki.openstreetmap.org/wiki/WikiProject_France/G%C3%A9oLittoral
FR
Tours - Orthophotos 2008
tms
Orthophoto Tour(s) Plus 2008
http://wiki.openstreetmap.org/wiki/Tours/Orthophoto
FR
PNOA Spain
wms
PNOA
ES
SIGPAC Spain
wms
SIGPAC
ES
GRAFCAN - Canary Islands
wms
GRAFCAN OrtoExpress Urbana 2009
ES
ITACyL - Castile and León
wms
ITACyL
ES
IDEIB - Balearic Islands
wms
ideib.cat
ES
Estonia Basemap (Maaamet)
wms
EE
Estonia Ortho (Maaamet)
wms
EE
Estonia Multi (Maaamet)
wms
EE
Fugro (Denmark)
tms
http://{switch:a,b,c}.tile.openstreetmap.dk/fugro2005/{zoom}/{x}/{y}.png
19
Fugro Aerial Mapping
http://wiki.openstreetmap.org/wiki/Fugro
http://wiki.openstreetmap.org/wiki/Fugro#Agreement_2
DK
Stevns (Denmark)
tms
http://{switch:a,b,c}.tile.openstreetmap.dk/stevns/2009/{zoom}/{x}/{y}.png
20
Stevns Kommune
DK
Pangasinán/Bulacan (Phillipines HiRes)
tms
http://gravitystorm.dev.openstreetmap.org/imagery/philippines/{zoom}/{x}/{y}.png
12
19
PH
ScanEx IRS
scanex
IRS
http://irs.gis-lab.info/
IRS
RU
ScanEx SPOT
scanex
SPOT
http://irs.gis-lab.info/
IRS
RU
Cambodia, Laos, Thailand, Vietnam bilingual
tms
http://{switch:a,b,c,d}.tile.osm-tools.org/osm_then/{zoom}/{x}/{y}.png
19
© osm-tools.org & OpenStreetMap contributors, CC-BY-SA
http://www.osm-tools.org/
TH
South Africa Topo (OOC)
tms
http://grant.dev.openstreetmap.org/za-ooc-slippy/{zoom}/{x}/{y}.png
3
15
ZA
}}}
== Documentation ==
General properties: ({{{name}}}, {{{type}}} and {{{url}}} are mandatory.)
||= '''Property''' =||= '''Description''' =||
|| '''name''' || The name of the imagery source ||
|| '''type''' || The type. Can be {{{tms}}}, {{{wms}}} and {{{html}}}. In addition, there are the special types {{{bing}}} and {{{scanex}}} with hardcoded behaviour. ||
|| '''url''' || The URL of the service. Can contain templates, e.g.{{{ {zoom} }}} will be replaced by the current zoom level (see below). The list of services is a XML document, so the '&' character is represented by '&'. Alternatively, the URL can be wrapped in a section. ||
|| '''bounds''' || The area of use, e.g. {{{}}} ||
|| '''shape''' || A non-rectangular area of use inside the {{{bounds}}}, defined by an ordered list of {{{point}}}s. This allows a more precise display in [[Help/Preferences/Imagery]]. ||
|| '''point''' || A lat/lon point, part of its parent {{{shape}}}, e.g {{{}}} ||
|| '''eula''' || A link to an EULA text that has to be accepted by the user, before the imagery source is added. ||
|| '''attribution-text''' || The attribution text to be shown all the time on the map. ||
|| '''attribution-url''' || A link that is opened, when the user clicks on the attribution text ||
|| '''logo-image''' || A URL for an image, that is displayed on the map for attribution ||
|| '''logo-url''' || A link that is opened, when the user clicks on the attribution image ||
|| '''terms-of-use-url''' || A link that is opened, when the user clicks on the terms-of-use text ||
|| '''terms-of-use-text''' || Customized text for the terms of use link (default is "Background Terms of Use") ||
|| '''country-code''' || The ISO 3166 country code ||
|| '''projections'' || A list of supported projections (inside {{{}}} tags) ||
|| **code** || A projection name, part of its parent {{{projections}}}, e.g {{{EPSG:4326
}}} ||
=== Tile Map Services (TMS) ===
Properties specific to Tile Map Service:
||= '''Property''' =||= '''Description''' =||
|| '''min-zoom''' || The minimum zoom level ||
|| '''max-zoom''' || The maximum zoom level. For higher scales, the images of the maximum level is enlarged. ||
For TMS you can specify tile URL template. Following patterns are supported:
* {zoom} is replaced by tile zoom level, also supported:
* offsets to the zoom level: {zoom+1} or {zoom-1})
* reversed zoom level: {19-zoom}
* {x} is replaced by X-coordinate of the tile
* {y} is replaced by Y-coordinate of the tile
* {!y} is replaced by 2^zoom-1^ - 1 - Y (Yahoo style Y coordinate)
* {-y} is replaced by 2^zoom^ - 1 - Y (OSGeo Tile Map Service Specification style Y coordinate)
* {switch:...} is replaced by a random selection from the given comma separated list, f.e. {switch:a,b,c} or {switch:1,2,3,4}
* When {header(''header'',''value'')} is included in URL, this part is stripped and send as HTTP header to to server
=== Web Map Services (WMS) ===
For WMS you can specify tile URL template. Following patterns are supported:
* {proj} is replaced by projection. Also {proj('''...''')} is supported, where '''...''' is a list of comma separated EPSG codes to allow checking valid projections.
* {bbox} is replaced by bounding box using projected coordinates
* {width} is requested display width
* {height} is requested display height
* {w},{s},{n},{e} are replaced by corresponding coordinates
* When {header(''header'',''value'')} is included in URL, this part is stripped and send as HTTP header to to server
For compatibility the old format is still supported. It is used when no patterns are found:
* URLs of these services must be designed to append arguments directly behind. So the they should either end with ''?'' or ''&''
* The pattern WIDTH={width}&HEIGHT={height}&BBOX={bbox} is appended.
* When no SRS= is found inside the URL also SRS={srs} is added.
* If SRS parameter is found the projection is checked and an error is issued when they mismatch.
* NOTE: Support of old format will be dropped in future.
=== Pseudo-WMS services ===
Pseudo-WMS service are specified by 'html:' prefix. Essentially they are equal to WMS services, but instead of a real WMS a HTML script does the
image creation. The resulting file is then downloaded by an image grabber. This method was mainly developed to support Yahoo which requires usage of the Yahoo API for image retrieval.
=== Other information ===
* JOSM uses [/maps this] URL to fetch the imagery sources. The URL can be customized in the advanced preferences (key {{{imagery.layers.sites}}}).
* Normally JOSM ignores any elements that it does not recognize. However, it will skip the entire imagery entry, when one of the unsupported tags has the attribute {{{mandatory='true'}}}. This is only relevant, when essential new features are added, but old versions of JOSM are still in use.
== Links ==
* List of imagery services for Potlatch 2: [http://git.openstreetmap.org/potlatch2.git/blob/HEAD:/resources/imagery.xml imagery.xml]