Skip to content

Terrain Service

This service delivers multi-resolution 3D terrain data as quantized mesh tiles, fully compliant with the Cesium Quantized Mesh 1.0 specification. Tiles are organized and served following the Tile Map Service (TMS) specification using a global-geodetic profile (latitude/longitude coordinates),

https://3d.geo.admin.ch/ch.swisstopo.terrain.3d/<Version>/<Time>/<Zoom>/<X>/<Y>.terrain

Use the following parameters to define your request:

ParameterExampleDescription
ServerName3d.geo.admin.ch
Versionv1v1 means terrain tiles generated with cesium tiles
Time20250101Date of tile generation in ISO-8601 (YYYYMMDD).
Zoom12Zoom level
X4309The longitude index
Y3111The latitude index

An example of a terrain tile request:

http
curl -o demo.terrain https://3d.geo.admin.ch/ch.swisstopo.terrain.3d/v1/20250101/11/2130/1550.terrain?v=1.43646.0

Metadata

The layer.json file provides metadata that describes the availability and structure of the terrain tiles at a given timestamp.

https://3d.geo.admin.ch/ch.swisstopo.terrain.3d/v1/<Time>/layer.json

If you always want the most rectent terrain tiles, you can leave /<Time> away in the path towards layer.json.

ParameterExampleDescription
Time (optional)Date of tile generation in ISO-8601 (YYYYMMDD). If no date is provided, it returns the metadata for the most recent terrain tiles.

Example of a metadata request for the date 20250101:

Request
Response
sh
curl --compressed https://3d.geo.admin.ch/ch.swisstopo.terrain.3d/v1/20250101/layer.json

Example: Cesium

An example of a Cesium application using terrain tiles, 3D buildings and a WMTS layer.