From 9946d5741bf0d85fcc590a3dee130cf84875e2be Mon Sep 17 00:00:00 2001 From: Raphael Antonietti Date: Wed, 12 Aug 2026 15:53:06 +0200 Subject: [PATCH 1/2] PB-2246: document Swissnames 3D Tiles --- visualize-data/3d-tiles.md | 37 +++++++++++++++++++++++++++++-------- 1 file changed, 29 insertions(+), 8 deletions(-) diff --git a/visualize-data/3d-tiles.md b/visualize-data/3d-tiles.md index d7358ae..29a1205 100644 --- a/visualize-data/3d-tiles.md +++ b/visualize-data/3d-tiles.md @@ -2,18 +2,24 @@ 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. Possible values are: `ch.swisstopo.swissbuildings3d.3d`, `ch.swisstopo.swisstlm3d.3d`, `ch.swisstopo.swissnames3d.3d`, `ch.swisstopo.vegetation.3d` | -| 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 | +| Parameter | Example | Description | +| --------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------- | +| layerName | ch.swisstopo.swissbuildings3d.3d | The technical name of a 3D layer that publishes B3DM content | +| 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: @@ -62,6 +68,21 @@ example='{ }' /> +## swissNAMES3D labels + +The swissNAMES3D label dataset uses 3D Tiles 1.1. Use its stable manifest URL: + + + +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. From ce6ea01f01a4a6fef607498657635c514d5c1215 Mon Sep 17 00:00:00 2001 From: Raphael Antonietti Date: Thu, 13 Aug 2026 09:48:16 +0200 Subject: [PATCH 2/2] PB-2246: address 3D Tiles documentation review --- visualize-data/3d-tiles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/visualize-data/3d-tiles.md b/visualize-data/3d-tiles.md index 29a1205..cf2f4e3 100644 --- a/visualize-data/3d-tiles.md +++ b/visualize-data/3d-tiles.md @@ -14,7 +14,7 @@ Use the following parameters to define your request: | Parameter | Example | Description | | --------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------- | -| layerName | ch.swisstopo.swissbuildings3d.3d | The technical name of a 3D layer that publishes B3DM content | +| 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 |