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 for storing tiled map data in SQLite databases for immediate or offline usage and for efficient transfer. 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 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: