Skip to content

PB-1969 Feedback to 3D from ltrea #patch #52

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Oct 22, 2025
Merged

PB-1969 Feedback to 3D from ltrea #patch #52

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
efc3640
Feedback to 3D from ltrea
rebert Oct 8, 2025
eb9a2f5
Proposition @asteiner-swistopo about <time> param
rebert Oct 22, 2025
a33e53f
whitespace
rebert Oct 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions docs/3d-tiles.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,15 +10,15 @@ Use the following parameters to define your request:
| --------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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` |
| Version | v1 | API version. `v1` means tiles generated with 3D Tiles |
| Time | 20240501 | Date of tileset generation in (ISO-8601, e.g. YYYYMMDD) |
| 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/20240501/7/54/21.b3dm
curl -o demo.b3dm https://3d.geo.admin.ch/ch.swisstopo.swissbuildings3d.3d/v1/20250501/11/799/503.b3dm
```

## Metadata
Expand All @@ -28,9 +28,10 @@ It can be used directly by [CesiumJS](https://github.com/CesiumGS/cesium).

<ApiCodeBlock url="https://3d.geo.admin.ch/<LayerName>/<Version>/<Time>/tileset.json" method="GET" />


| Parameter | Example | Description |
| --------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Time (optional) | 20201203 | Date of tile generation in (ISO-8601). |
| Time (optional) | 20250728 | Date of tilegeneration in ISO-8601(YYYYMMDD). If you omit this parameter, the most recent tile is returned. |
Copy link
Contributor

@asteiner-swisstopo asteiner-swisstopo Oct 22, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nitpick: Has some wrong white spaces.

Should be:

Date of tile generation in ISO-8601 (YYYYMMDD).

| 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` |

A metadata request for the Vegetation dataset:
Expand Down
26 changes: 14 additions & 12 deletions docs/terrain-service.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,19 +7,19 @@ Tiles are organized and served following the [Tile Map Service (TMS) specificati

Use the following parameters to define your request:

| Parameter | Example | Description |
| ---------- | --------------- | -------------------------------------------------- |
| ServerName | 3d.geo.admin.ch | |
| Version | v1 | v1 means terrain tiles generated with cesium tiles |
| Time | 20201203 | Date of tile generation in (ISO-8601). |
| Zoom | 12 | Zoom level |
| X | 4309 | The longitude index |
| Y | 3111 | The latitude index |
| Parameter | Example | Description |
| ----------------| --------------- | -------------------------------------------------- |
| ServerName | 3d.geo.admin.ch | |
| Version | v1 | v1 means terrain tiles generated with cesium tiles |
| Time (optional) | 20250101 | Date of tile generation in ISO-8601 (YYYYMMDD). If you omit this parameter, the most recent tile is returned. |
| Zoom | 12 | Zoom level |
| X | 4309 | The longitude index |
| Y | 3111 | The latitude index |

An example of a terrain tile request:

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

## Metadata
Expand All @@ -28,14 +28,16 @@ The `layer.json` file provides metadata that describes the availability and stru

<ApiCodeBlock url="https://3d.geo.admin.ch/ch.swisstopo.terrain.3d/v1/<Time>/layer.json" method="GET" />



| Parameter | Example | Description |
| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| Time (optional) | 20201203 | Date of tile generation in (ISO-8601). If no date is provided, it returns the metadata for the most recent terrain tiles. |
| Time (optional) | 20250101 | Date of tile generation in ISO-8601 (YYYYMMDD). If you omit this parameter, the most recent metadata is returned. |

Example of a metadata request for the date `20201203`:
Example of a metadata request for the date `20250101`:

<ExampleCodeBlock
request="curl --compressed https://3d.geo.admin.ch/ch.swisstopo.terrain.3d/v1/20201203/layer.json"
request="curl --compressed https://3d.geo.admin.ch/ch.swisstopo.terrain.3d/v1/20250101/layer.json"
example='{
"attribution": "Put something there",
"available": [...],
Expand Down
Loading