leaflet-tilelayer-swiss

Leaflet.TileLayer.Swiss

Leaflet.TileLayer.Swiss is a Leaflet plugin for displaying national maps of Switzerland using map tiles from Swisstopo. This plugin is not affiliated with or endorsed by Swisstopo.

Demo

Usage

Quick start

Check out the quick start documentation to get started.

Examples

• Quick start (preview, source html/js)
• Using multiple layers (preview, source html/js)

Options

Check out the list of all available map layers to see recommended combinations of options.

All available options are listed below together with their default values.

L.tileLayer.swiss({
  // Attribution. The required attribution to Swisstopo is added by default.
  attribution: '© <a href="https://www.swisstopo.ch/">Swisstopo</a>',
  // Coordinate reference system. EPSG2056 and EPSG21781 are available.
  crs: L.CRS.EPSG2056
  // Image format (jpeg or png). Only one format is available per layer.
  format: 'jpeg',
  // Layer name.
  layer: 'ch.swisstopo.pixelkarte-farbe',
  // Minimum zoom. Levels below 14 exist for technical reasons,
  // but you probably do not want to use them.
  minZoom: 14,
  // Maximum zoom. Availability of zoom levels depends on the layer.
  maxNativeZoom: 27,
  // Plugin attribution. Display a small Swiss flag with a link to this plugin. 🇨🇭
  // (Like the "🇺🇦 Leaflet" prefix, this is enabled by default but not required)
  pluginAttribution: true,
  // Timestamp. Most (but not all) layers have a 'current' timestamp.
  // Some layers have multiple versions with different timestamps.
  timestamp: 'current',
  // Map tile URL. Appropriate defaults are chosen based on the crs option.
  url: 'https://wmts{s}.geo.admin.ch/1.0.0/{layer}/default/{timestamp}/2056/{z}/{x}/{y}.{format}'
});

Coordinate reference systems (CRS)

Two CRS are commonly used in Switzerland:

• New (default): LV95 (EPSG:2056)
• Old: LV03 (EPSG:21781)

In order to use EPSG:21781, both map and layer CRS have to be adapted:

var map = L.map('map', { crs: L.CRS.EPSG21781 });
var swissLayer = L.tileLayer.swiss({ crs: L.CRS.EPSG21781 }).addTo(map);

map.setView(L.CRS.EPSG21781.unproject(L.point(600000, 200000)), 16);

Swisstopo tile service

Since 2021-03-01, Swisstopo maps are available as Open Government Data (OGD), and Swisstopo also provides a free tile service, for which no registration is required. In practice, this means that you can directly start using this plugin, and with the default configuration, the map will be loaded directly from Swisstopo servers.

Attribution

Swisstopo, like most map tile providers, requires that you display a copyright attribution below the map.

This plugin adds a map attribution which links to Swisstopo.

License

This plugin is licensed under the MIT license, see the LICENSE file.

Acknowledgements

Thanks to Swisstopo and the Geoinformation Act for providing excellent geodata.

Thanks to @procrastinatio whose blog post taught me how to use Swisstopo layers in Leaflet a few year ago.

See also

• Documentation and source of the official Swisstopo API based on OpenLayers 4