---
url: https://docs.geo.admin.ch/visualize-data/3d-tiles.md
---
# 3D Tiles

This service provides 3D tiles through a RESTful API, implementing the [Cesium 3D Tiles specification](https://github.com/CesiumGS/3d-tiles).

Start with the `tileset.json` file for a dataset. The manifest contains the content URLs
and the hierarchy that a 3D Tiles client requires. The content format depends on the
dataset.

The following direct B3DM request applies to datasets that publish B3DM content:

Use the following parameters to define your request:

| Parameter       | Example                          | Description                                                                                                      |
| --------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| layerName       | ch.swisstopo.swissbuildings3d.3d | The technical name of the 3D layer                                                                               |
| Version         | v1                               | The API version                                                                                                  |
| Time (optional) | 20250501                         | Date of tileset generation in ISO-8601 (YYYYMMDD). If you omit this parameter, the most recent tile is returned. |
| Z               | 7                                | Zoom level                                                                                                       |
| X               | 54                               | Tile column index                                                                                                |
| Y               | 21                               | Tile row index                                                                                                   |

A 3D tile request for swissBUILDINGS3D dataset:

```http
curl -o demo.b3dm https://3d.geo.admin.ch/ch.swisstopo.swissbuildings3d.3d/v1/20250501/11/799/503.b3dm
```

## Metadata

The `tileset.json` file describes the available set of tiles.
It can be used directly by [CesiumJS](https://github.com/CesiumGS/cesium).

| Parameter       | Example                          | Description                                                                                                                                                                             |
| --------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Time (optional) | 20250728                         | Date of tile generation in ISO-8601 (YYYYMMDD). If you omit this parameter, the most recent tile is returned.                                                                           |
| layerName       | ch.swisstopo.swissbuildings3d.3d | The technical name of the 3D layer. Possible values are: `ch.swisstopo.swissbuildings3d.3d`, `ch.swisstopo.swisstlm3d.3d`, `ch.swisstopo.swissnames3d.3d`, `ch.swisstopo.vegetation.3d` |

### Metadata requests to get the most recent datasets

You can always get the most recent version of the dataset simply by omitting the *Time*. On updates of the data, this metadata will be updated as well:

* Vegetation&#xA;
* Buildings&#xA;
* Other buildings such as bridges and cablecars&#xA;
* Names&#xA;

### Metadata requests to get a specific publication of a dataset

When you want to stick to a specific publication of a dataset, you have to specify the *Time* you want to fix.
F.ex. Buildings published the 20th June 2026:

Here a list of publication dates of the 3D Tiles datasets:

| Dataset         | Version | LayerName                        | Available timestamps                   |
| --------------- | ------- | -------------------------------- | -------------------------------------- |
| Vegetation      | v1      | ch.swisstopo.vegetation.3d       | 20240412, 20250728                     |
| Buildings       | v1      | ch.swisstopo.swissbuildings3d.3d | 20260520, 20251121, 20240918, 20230303 |
| Other buildings | v1      | ch.swisstopo.swisstlm3d.3d       | 20260520, 20250501, 20240224, 20230303 |
| Names           | v2      | ch.swisstopo.swissnames3d.3d     | 20260817                               |

## swissNAMES3D labels

The swissNAMES3D label dataset uses 3D Tiles 1.1. Use its stable manifest URL:

Use the timestamped manifest URL to select revision `20260817`:

The manifest references revisioned GLB content. Resolve each content URL from the
manifest. Do not construct GLB URLs directly.

The GLB content exposes these feature metadata properties:

* `text`, `type`, `sourceId`, and `tier`
* `fontSize`, `heightOffset`, and `maxDistance`
* `longitude`, `latitude`, `groundHeight`, and `labelHeight`

## Example: Cesium

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