= 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
Open Aerial Map
wms
Bing Sat
bing
http://www.bing.com/maps/
true
Yahoo Sat
html
MapQuest Open Aerial
tms
true
OpenStreetMap (Mapnik)
tms
true
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
OpenStreetMap (Mapnik Black & White)
tms
true
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
OpenCycleMap
tms
17
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
TilesAtHome
tms
17
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
MapQuest OSM
tms
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
ODBL coverage
tms
5
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
ÖPNV
tms
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
EU
German Style
tms
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
EU
Streets NRW Geofabrik.de
wms
DE
Hike & Bike
tms
18
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
DE
Sorbische Karte
tms
17
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
DE
Deutsche Karte
tms
17
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
DE
OpenPT Map
tms
5
16
© OpenStreetMap contributors, CC-BY-SA
http://openstreetmap.org/
DE
Bayern (2m)
wms
DE
Geoimage.at
wms
AT
Geoimage.at (HighRes)
wms
geoimage.at
http://www.geoimage.at/geoimage/geodatendienste
AT
MSR Maps Topo
wms
US
MSR Maps Urban
wms
US
Czech CUZK:KM
wms
CZ
Czech UHUL:ORTOFOTO
wms
CZ
NPE Maps
wms
GB
NPE Maps (Tim)
wms
GB
7th Series (OS7)
wms
GB
MLIT Japan (ORTHO)
wms
JA
MLIT Japan (ORTHO01)
wms
JA
MLIT Japan (ORTHO02)
wms
JA
MLIT Japan (ORTHO03)
wms
JA
Lodi - Italy
wms
IT
Sicily - Italy
wms
IT
PCN 2006 - Italy
wms
IT
SPOTMaps (France)
wms
FR
PNOA Spain
wms
ES
Estonia Basemap (Maaamet)
wms
EE
Estonia Ortho (Maaamet)
wms
EE
Estonia Multi (Maaamet)
wms
EE
Fugro (Denmark)
tms
19
Fugro Aerial Mapping
http://wiki.openstreetmap.org/wiki/Fugro
http://wiki.openstreetmap.org/wiki/Fugro#Agreement_2
DK
Stevns (Denmark)
tms
20
Stevns Kommune
DK
Pangasinan (Phillipines HiRes)
tms
PH
ScanEx IRS
scanex
http://irs.gis-lab.info/
IRS
RU
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. {{{}}} ||
|| '''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 ||
|| '''terms-of-use-url''' || A link that is opened, when the user clicks on the terms-of-use text ||
|| '''country-code''' || The ISO 3166 country code ||
=== 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
* {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 - Y (Yahoo 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}
=== Web Map Services (WMS) ===
URLs of these services must be designed to append arguments directly behind. So the they should either end with ''?'' or ''&''. Following arguments are added
* width
* height
* bbox
* srs - projection method - is only added when no srs is given already (In this case the projection is checked and an error is issued when they mismatch).
If more specific URL design is needed, then patterns are supported as well. If patterns are found no other arguments are added:
* {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
=== 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}}}).
== Links ==
* List of imagery services for Potlatch 2: [http://git.openstreetmap.org/potlatch2.git/blob/HEAD:/resources/imagery.xml imagery.xml]