Vector Tiles
This service delivers vector map tiles and styles through a RESTful API, implementing the Mapbox Vector Tiles specification.
TIP
The corresponding page on geo.admin.ch lists the available datasets and styles.
GetStyle
To get the style of certain layer:
https://vectortiles.geo.admin.ch/styles/{layerName}/style.json| Parameter | Description |
|---|---|
| layerName | Layer to perform the request |
A GetStyle request for the Light Base Map dataset:
curl https://vectortiles.geo.admin.ch/styles/ch.swisstopo.lightbasemap.vt/style.json{
"version": 8,
"id": "0197406a-5d2f-7168-bee5-f191641499b7",
"name": "lightbasemap_v1.19.0",
"sources": {
"relief_v1.0.0": {
"url": "https://vectortiles.geo.admin.ch/tiles/ch.swisstopo.relief.vt/v1.0.0/tiles.json",
"type": "vector"
},
"base_v1.0.0": {
"url": "https://vectortiles.geo.admin.ch/tiles/ch.swisstopo.base.vt/v1.0.0/tiles.json",
"type": "vector"
}
},
"layers": [...],
"metadata": {...},
"glyphs": "https://vectortiles.geo.admin.ch/fonts/{fontstack}/{range}.pbf",
"sprite": "https://vectortiles.geo.admin.ch/styles/ch.swisstopo.lightbasemap.vt/sprite/sprite",
"bearing": 0,
"pitch": 0,
"center": [8.349961425056108, 46.81133904939108],
"zoom": 7.2512975045452235,
"transition": {...}
}GetTile
A tile request is in the following form:
https://vectortiles.geo.admin.ch/tiles/{layerName}/{version}/{zoomLevel}/{x}/{y}.pbf| Parameter | Example | Description |
|---|---|---|
| layerName | ch.swisstopo.base.vt | The technical name of the vector tile layer |
| version | v1.0.0 | Version of the tileset |
| zoomLevel | 7 | Zoom level (integer) |
| x | 67 | Tile column (X coordinate in the tile grid) |
| y | 44 | Tile row (Y coordinate in the tile grid) |
A GetTile request for one .pbf tile in the Relief dataset:
curl -o demo.pbf https://vectortiles.geo.admin.ch/tiles/ch.swisstopo.relief.vt/v1.0.0/7/67/44.pbfGetTileSets
MBTiles are used for storing tiled map data in SQLite databases for immediate or offline usage and for efficient transfer.
WARNING
The file that is being downloaded in the example below is approximately 900MB in size.
A MBTileSet request is in the following form:
https://vectortiles.geo.admin.ch/tiles/{layerName}/{version}/{layerName}.mbtiles| Parameter | Example | Description |
|---|---|---|
| layerName | ch.swisstopo.base.vt | The technical name of the vector tile layer |
| version | v1.0.0 | Version of the tileset |
A GetTileSet request for a .mbtiles file in the Base Map dataset:
curl -o demo.mbtiles https://vectortiles.geo.admin.ch/tiles/ch.swisstopo.base.vt/v1.0.0/ch.swisstopo.base.vt.mbtilesMetadata
Each tileset has a corresponding metadata json file that describes the available set of tiles. The URL of the metadata file is:
https://vectortiles.geo.admin.ch/tiles/{layerName}/{version}/tiles.json| Parameter | Example | Description |
|---|---|---|
| layerName | ch.swisstopo.base.vt | The technical name of the vector tile layer |
| version | v1.0.0 | Version of the tileset |
A Metadata request for the Base Map dataset:
curl --compressed https://vectortiles.geo.admin.ch/tiles/ch.swisstopo.base.vt/v1.0.0/tiles.json{
"basename": "tiles/ch.swisstopo.base.vt/v1.0.0",
"name": "Basiskarte_v1.0.0",
"description": "A tileset showcasing all SwissTopo layers.",
"attribution": "© swisstopo",
"version": "v1.0.0",
"format": "pbf",
"minzoom": 0,
"maxzoom": 14,
"scale": 1,
"vector_layers": [...],
"profile": "mercator",
"scheme": "xyz",
"bounds": [...],
"center": [...],
"tilejson": "2.0.0",
"tiles": [
"https://vectortiles0.geo.admin.ch/tiles/ch.swisstopo.base.vt/v1.0.0/{z}/{x}/{y}.pbf",
"https://vectortiles1.geo.admin.ch/tiles/ch.swisstopo.base.vt/v1.0.0/{z}/{x}/{y}.pbf",
"https://vectortiles2.geo.admin.ch/tiles/ch.swisstopo.base.vt/v1.0.0/{z}/{x}/{y}.pbf",
"https://vectortiles3.geo.admin.ch/tiles/ch.swisstopo.base.vt/v1.0.0/{z}/{x}/{y}.pbf",
"https://vectortiles4.geo.admin.ch/tiles/ch.swisstopo.base.vt/v1.0.0/{z}/{x}/{y}.pbf"
]
}
Example: MapLibre
An example using MapLibre to display the Light Base Map: