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