| 360 | | Enter [/maps] as map source URL in JOSM to use this page (is default). |
| 361 | | |
| 362 | | This page can be used to define new URL's for the map background service in JOSM. Entries are separated by a semicolon: |
| 363 | | * default (true or false) - default items are automatically added to menu and thus should be common and worldwide available |
| 364 | | * Name |
| 365 | | * URL |
| 366 | | * EULA link (optional) |
| 367 | | * Bounds (optional) - 4 comma separated coordinates in order min. latitude, min. longitude, max. latitude, max. longitude |
| 368 | | * attribution text (optional) - text to display as data source attribution ('''osm''' can be used as shortcut for OSM data) |
| 369 | | * attribution url (optional) - URL to show for data source attribution ('''osm''' can be used as shortcut for OSM data) |
| 370 | | * terms of service url (optional) - URL to show for data source terms of service ('''osm''' can be used as shortcut for OSM data) |
| 371 | | * attribution image (optional) - Image to show for data source attribution |
| 372 | | |
| 373 | | Four types of imagery services are supported which are specified by URL following prefixes: 'wms:', 'html:', 'tms:' and 'bing:'. By default 'wms:' prefix is used. |
| 374 | | |
| 375 | | == WMS services == |
| 376 | | WMS services are specified by 'wms:' prefix (can be omitted). URL's of these services must be designed to append arguments directly behind. So the they should either end with ''?'' or ''&''. Following arguments are added |
| | 365 | == Documentation == |
| | 366 | |
| | 367 | General properties: ({{{name}}}, {{{type}}} and {{{url}}} are mandatory.) |
| | 368 | ||= '''Property''' =||= '''Description''' =|| |
| | 369 | || '''name''' || The name of the imagery source || |
| | 370 | || '''type''' || The type. Can be {{{tms}}}, {{{wms}}} and {{{html}}}. In addition, there are the special types {{{bing}}} and {{{scanex}}} with hardcoded behaviour. || |
| | 371 | || '''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 <![CDATA[...]]> section. || |
| | 372 | || '''bounds''' || The area of use, e.g. {{{<bounds min-lat='45.7' min-lon='5.9' max-lat='55.0' max-lon='17.3'/>}}} || |
| | 373 | || '''eula''' || A link to an EULA text that has to be accepted by the user, before the imagery source is added. || |
| | 374 | || '''attribution-text''' || The attribution text to be shown all the time on the map. || |
| | 375 | || '''attribution-url''' || A link that is opened, when the user clicks on the attribution text || |
| | 376 | || '''terms-of-use-url''' || A link that is opened, when the user clicks on the terms-of-use text || |
| | 377 | |
| | 378 | === Tile Map Services (TMS) === |
| | 379 | |
| | 380 | Properties specific to Tile Map Service: |
| | 381 | ||= '''Property''' =||= '''Description''' =|| |
| | 382 | || '''min-zoom''' || The minimum zoom level || |
| | 383 | || '''max-zoom''' || The maximum zoom level. For higher scales, the images of the maximum level is enlarged. || |
| | 384 | |
| | 385 | For TMS you can specify base URL or tile URL template. Following patterns are supported: |
| | 386 | * {zoom} is replaced by tile zoom level |
| | 387 | * {x} is replaced by X-coordinate of the tile |
| | 388 | * {y} is replaced by Y-coordinate of the tile |
| | 389 | * {!y} is replaced by 2^zoom^ - 1 - Y (Yahoo style Y coordinate) |
| | 390 | * {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} |
| | 391 | |
| | 392 | === Web Map Services (WMS) === |
| | 393 | |
| | 394 | URLs of these services must be designed to append arguments directly behind. So the they should either end with ''?'' or ''&''. Following arguments are added |
| 394 | | == TMS services == |
| 395 | | TMS services are specified by 'tms:' and 'bing:' prefixes. Bing service is currently hardcoded and everything after this prefix is ignored. |
| 396 | | |
| 397 | | For TMS you can specify base URL or tile URL template. Following patterns are supported: |
| 398 | | * {zoom} is replaced by tile zoom level |
| 399 | | * {x} is replaced by X-coordinate of the tile |
| 400 | | * {y} is replaced by Y-coordinate of the tile |
| 401 | | * {!y} is replaced by 2^zoom^ - 1 - Y (Yahoo style Y coordinate) |
| 402 | | * {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} (supported since JOSM 4194) |
| 403 | | |
| 404 | | By default, following pattern is used: /{zoom}/{x}/{y}.png |
| 405 | | |
| 406 | | TMS default zoom depth is 21. Not all services support this. Since version JOSM 4188 you can specify zoom level in specifier like this: |
| 407 | | * '''tms![18]:'''... - A TMS service which supports zoom levels up to level 18 |
| 408 | | * '''tms![5,16]:'''... - A TMS service which supports zoom levels from 5 up to level 16 |
| | 412 | === Other information === |
| | 413 | |
| | 414 | JOSM uses [/maps this] URL to fetch the imagery sources. The URL can be customized in the advanced preferences. |
