PB-1907: change url paths

.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,46 +152,46 @@ 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' },
             ],
         },
     ]
 }
 
 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',
         },
     ]
 }

docs/find-features.md → 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: <span class="title-ref">{ "\<layerId\>" : "\<layerDef1\>"}</span>                                                                        |
+| **layerDefs (optional)**      | Filter features with an expression (see [identify features](/access-data/identify-features##layerdefs-syntax)) Syntax: <span class="title-ref">{ "\<layerId\>" : "\<layerDef1\>"}</span>                                                                 |
 | **callback (optional)**       | The name of the callback function.                                                                                                                                                                                                                       |
 
 ## Examples

docs/identify-features.md → access-data/identify-features.md

@@ -67,7 +67,7 @@ Regarding the format of the `layerDefs` parameter:
 
 - Use a JSON-like format: `{"<layername>":"<filter_expression>"}`.
 - The `<filter_expression` is defined in the form `<attribute><operator><value>` where
-  - `<attribute>` must be one of the queryable attributes listed by the [layer attribute endpoint](/docs/get-layer-attributes).
+  - `<attribute>` must be one of the queryable attributes listed by the [layer attribute endpoint](/explore-data/get-layer-attributes).
   - `<operator>` must be one of the following options:
 
   | **Operator** | **Operators**                                                                 | **Examples**                                                                    |

docs/stac-api/asset-upload.md → 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
 

docs/stac-api/compression.md → 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.

docs/stac-api/overview.md → 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).
 :::

docs/get-layer-attributes.md → 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).
 
 <ApiCodeBlock url="https://api3.geo.admin.ch/rest/services/api/MapServer/{layerBodId}" method="GET" />
 

docs/overview.md → 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.
 

index.md

@@ -11,32 +11,32 @@ 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
 
 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
 ---
 
 <script setup>

docs/javascript-api.md → map-viewer/javascript-api.md

@@ -8,7 +8,7 @@ For more details, see [the GeoAdmin JS API specs](https://geoadmin.github.io/ol3
 
 The GeoAdmin JS API is about to be decommissioned and is not updated anymore.
 The default version is based on OpenLayers 3.6.0 from 2015.
-We strongly recommend using a different web mapping framework implementing the OGC WMTS, like Leaflet or plain OpenLayers as in [these examples for the XYZ service](/docs/xyz#openlayers).
+We strongly recommend using a different web mapping framework implementing the OGC WMTS, like Leaflet or plain OpenLayers as in [these examples for the XYZ service](/visualize-data/xyz#openlayers).
 :::
 
 ## Available Versions