diff --git a/.vitepress/config.mts b/.vitepress/config.mts
index 490d0e9..1ce2090 100644
--- a/.vitepress/config.mts
+++ b/.vitepress/config.mts
@@ -44,7 +44,7 @@ export default defineConfig({
{
text: 'Get Started',
collapsed: false,
- items: [{ text: 'Overview', link: '/docs/overview' }],
+ items: [{ text: 'Overview', link: '/get-started/overview' }],
},
{
text: 'Explore Data',
@@ -138,10 +138,10 @@ function loadReleasesSidebarData() {
function exploreDataItems(): DefaultTheme.SidebarItem[] {
return [
- { text: 'Get Layer Metadata', link: '/docs/get-layer-metadata' },
- { text: 'Get Layer Attributes', link: '/docs/get-layer-attributes' },
- { text: 'Get Layer Attribute Values', link: '/docs/get-layer-attribute-values' },
- { text: 'Get Layer Legend', link: '/docs/get-layer-legend' },
+ { text: 'Get Layer Metadata', link: '/explore-data/get-layer-metadata' },
+ { text: 'Get Layer Attributes', link: '/explore-data/get-layer-attributes' },
+ { text: 'Get Layer Attribute Values', link: '/explore-data/get-layer-attribute-values' },
+ { text: 'Get Layer Legend', link: '/explore-data/get-layer-legend' },
]
}
@@ -152,25 +152,25 @@ function accessDataItems(): DefaultTheme.SidebarItem[] {
items: [
{
text: 'Identify Features',
- link: '/docs/identify-features',
+ link: '/access-data/identify-features',
},
- { text: 'Find Features', link: '/docs/find-features' },
- { text: 'Get Features', link: '/docs/get-features' },
+ { text: 'Find Features', link: '/access-data/find-features' },
+ { text: 'Get Features', link: '/access-data/get-features' },
{
text: 'Get HTML Popup',
- link: '/docs/get-html-popup',
+ link: '/access-data/get-html-popup',
},
],
},
{
text: 'Search',
- link: '/docs/search',
+ link: '/access-data/search',
},
{
text: 'Elevation Data',
items: [
- { text: 'Get Point Height', link: '/docs/get-point-height' },
- { text: 'Get Elevation Profile', link: '/docs/get-elevation-profile' },
+ { text: 'Get Point Height', link: '/access-data/get-point-height' },
+ { text: 'Get Elevation Profile', link: '/access-data/get-elevation-profile' },
],
},
]
@@ -178,20 +178,20 @@ function accessDataItems(): DefaultTheme.SidebarItem[] {
function visualizeDataItems(): DefaultTheme.SidebarItem[] {
return [
- { text: 'WMS', link: '/docs/wms' },
- { text: 'WMTS', link: '/docs/wmts' },
- { text: 'XYZ', link: '/docs/xyz' },
+ { text: 'WMS', link: '/visualize-data/wms' },
+ { text: 'WMTS', link: '/visualize-data/wmts' },
+ { text: 'XYZ', link: '/visualize-data/xyz' },
{
text: 'Vector Tiles',
- link: '/docs/vector-tiles',
+ link: '/visualize-data/vector-tiles',
},
{
text: 'Terrain Service',
- link: '/docs/terrain-service',
+ link: '/visualize-data/terrain-service',
},
{
text: '3D Tiles',
- link: '/docs/3d-tiles',
+ link: '/visualize-data/3d-tiles',
},
]
}
@@ -201,17 +201,17 @@ function downloadDataItems(): DefaultTheme.SidebarItem[] {
{
text: 'STAC API',
items: [
- { text: 'Overview', link: '/docs/stac-api/overview' },
- { text: 'Authentication', link: '/docs/stac-api/authentication' },
- { text: 'Asset Upload', link: '/docs/stac-api/asset-upload' },
- { text: 'Compression', link: '/docs/stac-api/compression' },
+ { text: 'Overview', link: '/download-data/stac-api/overview' },
+ { text: 'Authentication', link: '/download-data/stac-api/authentication' },
+ { text: 'Asset Upload', link: '/download-data/stac-api/asset-upload' },
+ { text: 'Compression', link: '/download-data/stac-api/compression' },
{
text: 'Supported Media Types',
- link: '/docs/stac-api/supported-media',
+ link: '/download-data/stac-api/supported-media',
},
- { text: 'Caching', link: '/docs/stac-api/caching' },
- { text: 'Item Expiration', link: '/docs/stac-api/item-expiration' },
- { text: 'Migrate v0.9 to v1', link: '/docs/stac-api/migrate09-10' },
+ { text: 'Caching', link: '/download-data/stac-api/caching' },
+ { text: 'Item Expiration', link: '/download-data/stac-api/item-expiration' },
+ { text: 'Migrate v0.9 to v1', link: '/download-data/stac-api/migrate09-10' },
{
text: 'API Specs',
link: 'https://data.geo.admin.ch/api/stac/static/spec/v1/api.html',
@@ -223,11 +223,11 @@ function downloadDataItems(): DefaultTheme.SidebarItem[] {
function mapViewerItems(): DefaultTheme.SidebarItem[] {
return [
- { text: 'Embed in an iframe', link: '/docs/embed-in-an-iframe' },
- { text: 'URL Parameters', link: '/docs/url-parameters' },
+ { text: 'Embed in an iframe', link: '/map-viewer/embed-in-an-iframe' },
+ { text: 'URL Parameters', link: '/map-viewer/url-parameters' },
{
text: 'Javascript API',
- link: '/docs/javascript-api',
+ link: '/map-viewer/javascript-api',
},
]
}
diff --git a/docs/find-features.md b/access-data/find-features.md
similarity index 98%
rename from docs/find-features.md
rename to access-data/find-features.md
index 1a23e58..6b96b0a 100644
--- a/docs/find-features.md
+++ b/access-data/find-features.md
@@ -21,7 +21,7 @@ This endpoint only has query parameters that modify the behavior of the request,
| **returnGeometry (optional)** | This parameter defines whether the geometry is returned or not. Default to "true". |
| **sr (optional)** | The spatial reference. Supported values: 21781 (LV03), 2056 (LV95), 4326 (WGS84) and 3857 (Web Pseudo-Mercator). Defaults to "21781". |
| **lang (optional)** | The language. Supported values: de, fr, it , rm, en. Defaults to "de". |
-| **layerDefs (optional)** | Filter features with an expression (see [identify features](/docs/identify-features##layerdefs-syntax)) Syntax: { "\" : "\"} |
+| **layerDefs (optional)** | Filter features with an expression (see [identify features](/access-data/identify-features##layerdefs-syntax)) Syntax: { "\" : "\"} |
| **callback (optional)** | The name of the callback function. |
## Examples
diff --git a/docs/get-elevation-profile.md b/access-data/get-elevation-profile.md
similarity index 100%
rename from docs/get-elevation-profile.md
rename to access-data/get-elevation-profile.md
diff --git a/docs/get-features.md b/access-data/get-features.md
similarity index 100%
rename from docs/get-features.md
rename to access-data/get-features.md
diff --git a/docs/get-html-popup.md b/access-data/get-html-popup.md
similarity index 100%
rename from docs/get-html-popup.md
rename to access-data/get-html-popup.md
diff --git a/docs/get-point-height.md b/access-data/get-point-height.md
similarity index 100%
rename from docs/get-point-height.md
rename to access-data/get-point-height.md
diff --git a/docs/identify-features.md b/access-data/identify-features.md
similarity index 99%
rename from docs/identify-features.md
rename to access-data/identify-features.md
index 7c29e0d..d6ac5a0 100644
--- a/docs/identify-features.md
+++ b/access-data/identify-features.md
@@ -67,7 +67,7 @@ Regarding the format of the `layerDefs` parameter:
- Use a JSON-like format: `{"":""}`.
- The `` where
- - `` must be one of the queryable attributes listed by the [layer attribute endpoint](/docs/get-layer-attributes).
+ - `` must be one of the queryable attributes listed by the [layer attribute endpoint](/explore-data/get-layer-attributes).
- `` must be one of the following options:
| **Operator** | **Operators** | **Examples** |
diff --git a/docs/search.md b/access-data/search.md
similarity index 100%
rename from docs/search.md
rename to access-data/search.md
diff --git a/docs/stac-api/asset-upload.md b/download-data/stac-api/asset-upload.md
similarity index 98%
rename from docs/stac-api/asset-upload.md
rename to download-data/stac-api/asset-upload.md
index caca232..ebdc288 100644
--- a/docs/stac-api/asset-upload.md
+++ b/download-data/stac-api/asset-upload.md
@@ -14,7 +14,7 @@ The following sections describe each step in detail, including how to set up a r
:::tip IMPORTANT NOTES
-- POST/PUT requests require [authentication](/docs/stac-api/authentication).
+- POST/PUT requests require [authentication](/download-data/stac-api/authentication).
:::
## File Splitting
@@ -23,7 +23,7 @@ Files smaller than 5 GB can be uploaded as a single part; however, you must stil
If the file exceeds 5 GB, it must be split into multiple parts. Each part must be at least 5 MB in size - except for the final part- and no part can be larger than 5 GB. Uploads that do not follow these size constraints will fail.
-Additionally, files larger than 10 MB should be compressed before uploading; see [Compression](/docs/stac-api/compression) for guidance.
+Additionally, files larger than 10 MB should be compressed before uploading; see [Compression](/download-data/stac-api/compression) for guidance.
## Basic Steps
diff --git a/docs/stac-api/authentication.md b/download-data/stac-api/authentication.md
similarity index 100%
rename from docs/stac-api/authentication.md
rename to download-data/stac-api/authentication.md
diff --git a/docs/stac-api/caching.md b/download-data/stac-api/caching.md
similarity index 100%
rename from docs/stac-api/caching.md
rename to download-data/stac-api/caching.md
diff --git a/docs/stac-api/compression.md b/download-data/stac-api/compression.md
similarity index 96%
rename from docs/stac-api/compression.md
rename to download-data/stac-api/compression.md
index 7c987f6..a8ea07a 100644
--- a/docs/stac-api/compression.md
+++ b/download-data/stac-api/compression.md
@@ -15,7 +15,7 @@ For details, refer to the CloudFront documentation on [serving compressed files]
## Compression Before Upload
-For files larger than 10 MB, we recommended to use a [compressed media type](/docs/stac-api/supported-media).
+For files larger than 10 MB, we recommended to use a [compressed media type](/download-data/stac-api/supported-media).
If you cannot use a compressed media type, compress the file yourself with `gzip` or `br`.
To have the file delivered later in its compressed form, set the `content_encoding` parameter in the [multipart upload request](https://data.geo.admin.ch/api/stac/static/spec/v1/apitransactional.html#tag/Asset-Upload-Management/operation/createAssetUpload) accordingly.
diff --git a/docs/stac-api/item-expiration.md b/download-data/stac-api/item-expiration.md
similarity index 100%
rename from docs/stac-api/item-expiration.md
rename to download-data/stac-api/item-expiration.md
diff --git a/docs/stac-api/migrate09-10.md b/download-data/stac-api/migrate09-10.md
similarity index 100%
rename from docs/stac-api/migrate09-10.md
rename to download-data/stac-api/migrate09-10.md
diff --git a/docs/stac-api/overview.md b/download-data/stac-api/overview.md
similarity index 94%
rename from docs/stac-api/overview.md
rename to download-data/stac-api/overview.md
index 3bc6b0e..5a26618 100644
--- a/docs/stac-api/overview.md
+++ b/download-data/stac-api/overview.md
@@ -13,5 +13,5 @@ This implementation conforms to the core [STAC API specification](https://github
The underlying data model follows the STAC schema and is extended by the [forecast extension](https://github.com/stac-extensions/forecast) to support weather forecast data.
::: warning
-STAC API `v0.9` is being deprecated and will be turned off on 31.3.2026. [Learn more...](/docs/stac-api/migrate09-10.md).
+STAC API `v0.9` is being deprecated and will be turned off on 31.3.2026. [Learn more...](/download-data/stac-api/migrate09-10.md).
:::
diff --git a/docs/stac-api/supported-media.md b/download-data/stac-api/supported-media.md
similarity index 100%
rename from docs/stac-api/supported-media.md
rename to download-data/stac-api/supported-media.md
diff --git a/docs/get-layer-attribute-values.md b/explore-data/get-layer-attribute-values.md
similarity index 100%
rename from docs/get-layer-attribute-values.md
rename to explore-data/get-layer-attribute-values.md
diff --git a/docs/get-layer-attributes.md b/explore-data/get-layer-attributes.md
similarity index 97%
rename from docs/get-layer-attributes.md
rename to explore-data/get-layer-attributes.md
index 1f45ac4..0ed8489 100644
--- a/docs/get-layer-attributes.md
+++ b/explore-data/get-layer-attributes.md
@@ -1,6 +1,6 @@
# Get Layer Attributes
-The endpoint returns attribute metadata for a specified layer. Use this endpoint if you want to list all available attributes of a layer or if you need details about a particular attribute. The endpoint is also useful for querying the [Find endpoint](/docs/find-features).
+The endpoint returns attribute metadata for a specified layer. Use this endpoint if you want to list all available attributes of a layer or if you need details about a particular attribute. The endpoint is also useful for querying the [Find endpoint](/access-data/find-features).
diff --git a/docs/get-layer-legend.md b/explore-data/get-layer-legend.md
similarity index 100%
rename from docs/get-layer-legend.md
rename to explore-data/get-layer-legend.md
diff --git a/docs/get-layer-metadata.md b/explore-data/get-layer-metadata.md
similarity index 100%
rename from docs/get-layer-metadata.md
rename to explore-data/get-layer-metadata.md
diff --git a/docs/overview.md b/get-started/overview.md
similarity index 54%
rename from docs/overview.md
rename to get-started/overview.md
index d914ef1..70c6cf0 100644
--- a/docs/overview.md
+++ b/get-started/overview.md
@@ -4,11 +4,11 @@ Discover how to access geospatial data provided by the Swiss Confederation throu
We provide tutorials on how to interact with these services:
-- [Explore Data](/docs/get-layer-metadata): Browse additional information about layers, including attributes and other metadata.
-- [Access Data](/docs/identify-features): Retrieve location-based features such as geometries, addresses and elevation.
-- [Visualize Data](/docs/wmts): Access map data (2D and 3D) for visualization in your application.
-- [Download Data](/docs/stac-api/overview): Download entire datasets for exploration and analysis.
-- [Map Viewer](/docs/embed-in-an-iframe): Embed the [map viewer](https://map.geo.admin.ch/) in your webpage.
+- [Explore Data](/explore-data/get-layer-metadata): Browse additional information about layers, including attributes and other metadata.
+- [Access Data](/access-data/identify-features): Retrieve location-based features such as geometries, addresses and elevation.
+- [Visualize Data](/visualize-data/wms): Access map data (2D and 3D) for visualization in your application.
+- [Download Data](/download-data/stac-api/overview): Download entire datasets for exploration and analysis.
+- [Map Viewer](/map-viewer/embed-in-an-iframe): Embed the [map viewer](https://map.geo.admin.ch/) in your webpage.
The tutorials are written for a tech-savvy audience like geoinformaticians, data scientists, GIS specialists and web developers.
diff --git a/index.md b/index.md
index 71f75ba..e9257bf 100644
--- a/index.md
+++ b/index.md
@@ -11,7 +11,7 @@ hero:
alt: Geoportal
actions:
- text: Get started
- link: /docs/overview
+ link: /get-started/overview
- theme: alt
text: Getting help
link: http://groups.google.com/group/geoadmin-api
@@ -19,24 +19,24 @@ hero:
features:
- title: Explore Data
details: Browse additional information about layers, including attributes and other metadata.
- link: /docs/get-layer-metadata
+ link: /explore-data/get-layer-metadata
icon: 🧭
- title: Access Data
details: Retrieve location-based features such as geometries, addresses and elevation.
- link: /docs/identify-features
+ link: /access-data/identify-features
icon: 🔎
- title: Visualize Data
details: Access map data (2D and 3D) for visualization in your application.
icon: 👁
- link: /docs/wms
+ link: /visualize-data/wms
- title: Download Data
details: Download entire datasets for exploration and analysis.
icon: ⬇️
- link: /docs/stac-api/overview
+ link: /download-data/stac-api/overview
- title: Map Viewer
details: Integrate and customize map.geo.admin.ch as an interactive map in your webpage.
icon: 🗺️
- link: /docs/embed-in-an-iframe
+ link: /map-viewer/embed-in-an-iframe
---