geo.admin.ch

https://docs.geo.admin.ch/
Admin
geo.admin.ch is a comprehensive platform providing web services and components for developers to...
Tokens:138,213
Snippets:571
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### GetMap curl example

Source: https://docs.geo.admin.ch/visualize-data/wms.html

Example curl command to request a map image from the WMS service. Saves the output to demo.png.

```bash
curl -o demo.png "https://wms.geo.admin.ch/?\
SERVICE=WMS&REQUEST=GetMap&\
VERSION=1.3.0&\
LAYERS=ch.bafu.bundesinventare-bln&\
STYLES=default&\
CRS=EPSG:2056&\
BBOX=2550000,1060000,2660000,1140000&\
WIDTH=800&\
HEIGHT=582&\
FORMAT=image/png"
```

--------------------------------

### layer.json response example

Source: https://docs.geo.admin.ch/visualize-data/terrain-service.html

Example JSON metadata response showing fields like attribution, format, minzoom, and tile URL template.

```json
{
  "attribution": "Put something there",
  "available": [...],
  "bounds": [-180, -90, 180, 90],
  "description": "Nice terrains",
  "format": "quantized-mesh-1.0",
  "minzoom": 0,
  "projection": "EPSG:4326",
  "scheme": "tms",
  "tilejson": "2.1.0",
  "tiles": ["{z}/{x}/{y}.terrain?v={version}"],
  "version": "3924.0.0"
}
```

--------------------------------

### Find building example response

Source: https://docs.geo.admin.ch/access-data/find-features.html

Example JSON response from a find request for a building, showing the feature attributes.

```json
{
  "results": [
    {
      "layerBodId": "ch.bfs.gebaeude_wohnungs_register",
      "layerName": "RBD: building status",
      "featureId": "1231641_0",
      "id": "1231641_0",
      "attributes": {
        "egid": "1231641",
        "strname_deinr": "Beaulieustrasse 2",
        "plz_plz6": "3012/301200",
        "ggdename": "Bern",
        "ggdenr": 351,
        "gexpdat": "13.07.2025",
        "gdekt": "BE",
        "egrid": "CH251146763508",
        "lgbkr": 2,
        "lparz": "2091",
        "lparzsx": null,
        "ltyp": null,
        "gebnr": "",
        "gbez": "",
        "gkode": 2599407.817,
        "gkodn": 1200797.593,
        "gksce": 904,
        "gstat": 1004,
        "gkat": 1020,
        "gklas": 1122,
        "gbauj": null,
        "gbaum": null,
        "gbaup": 8012,
        "gabbj": null,
        "garea": 174,
        "gvol": null,
        "gvolnorm": null,
        "gvolsce": null,
        "gastw": 4,
        "ganzwhg": 10,
        "gazzi": null,
        "gschutzr": null,
        "gebf": null,
        "gwaerzh1": 7460,
        "genh1": 7580,
        "gwaersceh1": 865,
        "gwaerdath1": "11.02.2025",
        "gwaerzh2": 7400,
        "genh2": 7500,
        "gwaersceh2": 860,
        "gwaerdath2": "29.11.2001",
        "gwaerzw1": 7660,
        "genw1": 7580,
        "gwaerscew1": 865,
        "gwaerdatw1": "11.02.2025",
        "gwaerzw2": 7600,
        "genw2": 7500,
        "gwaerscew2": 860,
        "gwaerdatw2": "29.11.2001",
        "edid": "0",
        "egaid": 100774486,
        "deinr": "2",
        "esid": 10084832,
        "strname": ["Beaulieustrasse"],
        "strnamk": ["Beaulieustr."],
        "strindx": ["Bea"],
        "strsp": ["DE"],
        "stroffiziel": "1",
        "dplz4": 3012,
        "dplzz": 0,
        "dplzname": "Bern",
        "dkode": 2599409.699,
        "dkodn": 1200794.829,
        "doffadr": 1,
        "dexpdat": "13.07.2025",
        "ewid": ["2", "3", "4", "5", "6", "7", "8", "9", "10", "11"],
        "whgnr": [null, null, null, null, null, null, null, null, null, null],
        "wstwk": [3100, 3102, 3102, 3101, 3103, 3101, 3104, 3103, 3104, 3104],
        "wmehrg": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
        "weinr": [null, null, null, null, null, null, null, null, null, null],
        "wbez": [
          null,
          "Rechts",
          "Links",
          "Rechts",
          "Rechts",
          "Links",
          "Mitte",
          "Links",
          "Links",
          "Rechts"
        ],
        "wstat": [3004, 3004, 3004, 3004, 3004, 3004, 3004, 3004, 3004, 3004],
        "wexpdat": [
          "2025-07-13T00:00:00",
          "2025-07-13T00:00:00",
          "2025-07-13T00:00:00",
          "2025-07-13T00:00:00",
          "2025-07-13T00:00:00",
          "2025-07-13T00:00:00",
          "2025-07-13T00:00:00",
          "2025-07-13T00:00:00",
          "2025-07-13T00:00:00",
          "2025-07-13T00:00:00"
        ],
        "wbauj": [1999, 1999, 1999, 1999, 1999, 1999, 1999, 1999, 1999, 1999],
        "wabbj": [null, null, null, null, null, null, null, null, null, null],
        "warea": [95, 97, 65, 97, 97, 65, 48, 65, 20, 20],
        "wazim": [3, 4, 2, 4, 3, 2, 1, 5, 1, 1],
        "wkche": [1, 1, 1, 1, 1, 1, 1, 1, 1, 1],
        "label": "Beaulieustrasse 2"
      }
    }
  ]
}
```

--------------------------------

### Map configuration JSON example

Source: https://docs.geo.admin.ch/explore-data/get-layer-metadata.html

Example JSON configuration for a map (topic) named 'api', showing layer attributes, spatial reference, extents, and capabilities. The 'layers' array contains layer objects with metadata such as 'layerBodId', 'idGeoCat', and 'name'.

```json
{
  "mapName": "api",
  "description": "Configuration for the map (topic) api",
  "copyrightUnicode": "Data api",
  "layers": [
    {
      "attributes": {
        "inspireAbstract": "Soil",
        "fullTextSearch": "Wetness potential in the agricultural land, vector | Das Feuchtflächenpotential wurde anhand der Prozesse Wasserakkumulation und Versickerung beurteilt. Aus dem Höhenmodell (Swissalti3d © swisstopo) wurden Reliefparameter berechnet und Ebenen und Mulden modelliert. Das Potential der Versickerung wurde von Bodenkarten abgeleitet. Wo keine detaillierten Bodenkarten vorhanden waren, wurden geologische Karten und andere Surrogate in einem Expertenmodell überlagert und gewichtet. Der Vektor-Datensatz ist auf die vorwiegend landwirtschaftlich genutzten Feldblöcke zugeschnitten.Versickerung: 4 Klassen; Wasserakkumulation: 5 Klassen. Zitat: Szerencsits, E., Prasuhn, V., Churko, G., Herzog, F., Utiger, C., Zihlmann, U. et al. (2018). Karte potenzieller Feucht-Acker-Flächen der Schweiz. Agroscope Science, 72, 67. https://www.feuchtacker.ch/ | swisstopo | Federal Office of Topography swisstopo | Agroscope",
        "inspireName": "Soil",
        "wmsContactAbbreviation": "swisstopo",
        "wmsContactName": "Federal Office of Topography swisstopo",
        "maps": "api,ech,inspire,service-wms",
        "wmsUrlResource": "https://wms.geo.admin.ch/?REQUEST=GetCapabilities&SERVICE=WMS&VERSION=1.3.0",
        "scaleLimit": "Min 1:5000 – Max 1:25000",
        "dataOwner": "Agroscope",
        "dataStatus": "20230725",
        "inspireUpperAbstract": "Environment, biology and geology",
        "abstract": "Das Feuchtflächenpotential"
      },
      "layerBodId": "ch.agroscope.feuchtflaechenpotential-kulturlandschaft",
      "idGeoCat": "5188235f-c5c3-4628-9173-055824b65539",
      "name": "Wetness potential agricultural land",
      "fullName": "Wetness potential in the agricultural land, vector"
    },
    (... more layers ...)
  ],
  "spatialReference": {
    "wkid": 21781
  },
  "tileInfo": {},
  "initialExtent": {
    "xmin": 458000,
    "ymin": 76375,
    "xmax": 839125,
    "ymax": 312500,
    "spatialReference": {
      "wkid": 21781
    }
  },
  "fullExtent": {
    "xmin": 420000,
    "ymin": 30000,
    "xmax": 900000,
    "ymax": 350000,
    "spatialReference": {
      "wkid": 21781
    }
  },
  "units": "esriMeters",
  "capabilities": "Map"
}
```

--------------------------------

### OpenLayers 10 example: Simple XYZ in LV95

Source: https://docs.geo.admin.ch/visualize-data/xyz.html

CodeSandbox example showing the Base Map layer as XYZ tiles in LV95 projection. Uses OpenLayers 10.7.0, proj4 2.20.2, and @swissgeo/coordinates 1.0.2.

```javascript
// CodeSandbox example: Simple XYZ in LV95
// Used on https://docs.geo.admin.ch/visualize-data/xyz.html
// Files: index.js, styles.css, index.html, package.json
// Dependencies: ol@10.7.0, proj4@2.20.2, @swissgeo/coordinates@1.0.2
```

--------------------------------

### Example query string with URL parameters

Source: https://docs.geo.admin.ch/map-viewer/url-parameters.html

Shows the structure of the query string in a map viewer URL, composed of key-value pairs like lang, center, z, topic, layers, and bgLayer.

```txt
https://map.geo.admin.ch/#/map?
   lang=en&
   center=2660000,1190000&
   z=1&
   topic=ech&
   layers=ch.swisstopo.swisstlm3d-wanderwege&
   bgLayer=ch.swisstopo.pixelkarte-farbe
```

--------------------------------

### Get Features Response - GeoJSON

Source: https://docs.geo.admin.ch/access-data/get-features.html

Example response from the /get-features endpoint, returned as a GeoJSON FeatureCollection with two features. Includes expected fields such as featureId, layerBodId, geometry, and properties.

```json
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "featureId": "RIG",
      "bbox": [8.46333, 47.06741, 8.46333, 47.06741],
      "layerBodId": "ch.bafu.nabelstationen",
      "layerName": "Monitoring stations air quality",
      "id": "RIG",
      "geometry": {
        "type": "Point",
        "coordinates": [8.46333, 47.06741]
      },
      "properties": {
        "name": "Rigi-Seebodenalp",
        "url_de": "https://www.bafu.admin.ch/bafu/de/home/themen/luft/zustand/daten/datenabfrage-nabel.html",
        "url_fr": "https://www.bafu.admin.ch/bafu/de/home/themen/luft/zustand/daten/datenabfrage-nabel.html",
        "url_it": "https://www.bafu.admin.ch/bafu/de/home/themen/luft/zustand/daten/datenabfrage-nabel.html",
        "url_en": "https://www.bafu.admin.ch/bafu/de/home/themen/luft/zustand/daten/datenabfrage-nabel.html",
        "label": "Rigi-Seebodenalp"
      }
    },
    {
      "type": "Feature",
      "featureId": "LAU",
      "bbox": [6.639701, 46.522018, 6.639701, 46.522018],
      "layerBodId": "ch.bafu.nabelstationen",
      "layerName": "Monitoring stations air quality",
      "id": "LAU",
      "geometry": {
        "type": "Point",
        "coordinates": [6.639701, 46.522018]
      },
      "properties": {
        "name": "Lausanne",
        "url_de": "https://www.bafu.admin.ch/bafu/de/home/themen/luft/zustand/daten/datenabfrage-nabel.html",
        "url_fr": "https://www.bafu.admin.ch/bafu/de/home/themen/luft/zustand/daten/datenabfrage-nabel.html",
        "url_it": "https://www.bafu.admin.ch/bafu/de/home/themen/luft/zustand/daten/datenabfrage-nabel.html",
        "url_en": "https://www.bafu.admin.ch/bafu/de/home/themen/luft/zustand/daten/datenabfrage-nabel.html",
        "label": "Lausanne"
      }
    }
  ]
}
```

--------------------------------

### GET /collections/{collectionId}/items/{featureId}/assets/{assetId}/uploads

Source: https://docs.geo.admin.ch/download-data/stac-api/asset-upload.html

Lists uploads in progress for a given asset. This is used to check for existing uploads before starting a new one.

```APIDOC
## GET /collections/{collectionId}/items/{featureId}/assets/{assetId}/uploads

### Description
Lists uploads in progress for a given asset. This is used to check for existing uploads before starting a new one.

### Method
GET

### Endpoint
https://data.geo.admin.ch/api/stac/v1/collections/{collectionId}/items/{featureId}/assets/{assetId}/uploads

### Parameters
#### Path Parameters
- **collectionId** (string) - Required - The collection ID.
- **featureId** (string) - Required - The item ID.
- **assetId** (string) - Required - The asset ID.

### Response
#### Success Response (200)
- **uploads** (array) - List of upload sessions in progress.

#### Response Example
{
  "uploads": [
    {
      "upload_id": "12345",
      "status": "in_progress"
    }
  ]
}
```

--------------------------------

### Start a new upload (POST request)

Source: https://docs.geo.admin.ch/download-data/stac-api/asset-upload.html

Sends a POST request to initiate an upload session for an asset. Returns a list of presigned URLs for uploading file parts.

```HTTP
POST
https://data.geo.admin.ch/api/stac/v1/collections/{collection}/items/{item}/assets/{asset}/uploads

```

--------------------------------

### Multipart upload example in Python

Source: https://docs.geo.admin.ch/download-data/stac-api/asset-upload.html

A Python implementation of the multipart upload steps. Imports required modules and uses the requests and multihash libraries.

```python
import os
import hashlib
from base64 import b64encode

import requests
import multihash

```

--------------------------------

### List uploads in progress (GET request)

Source: https://docs.geo.admin.ch/download-data/stac-api/asset-upload.html

Checks for uploads in progress for a given asset, which can help determine if it is necessary to abort or complete an existing upload before starting a new one.

```HTTP
GET
https://data.geo.admin.ch/api/stac/v1/collections/{collectionId}/items/{featureId}/assets/{assetId}/uploads

```

--------------------------------

### Format files with make format

Source: https://docs.geo.admin.ch/README.html

Formats files using the prettier package. Run from the project root.

```sh
make format
```

--------------------------------

### Download and verify script (main function)

Source: https://docs.geo.admin.ch/download-data/stac-api/large-assets.html

The main function of the download script. It probes the asset, downloads it in chunks, verifies the download size, and verifies the SHA-256 checksum if provided.

```python
print()
download_loop(args.url, args.output, total_size, chunk_size)
print()
verify_download(args.output, total_size)
verify_checksum(args.output, sha256)
```

--------------------------------

### GetLegendGraphic curl example

Source: https://docs.geo.admin.ch/visualize-data/wms.html

Example curl command to request a legend graphic from the WMS service. Saves the output to demo.png.

```bash
curl -o demo.png https://wms.geo.admin.ch/?SERVICE=WMS&REQUEST=GetLegendGraphic&VERSION=1.3.0&LAYERS=ch.bafu.bundesinventare-bln&STYLES=default&LANG=en&CRS=EPSG:2056&BBOX=2550000,1060000,2660000,1140000&WIDTH=800&HEIGHT=582&FORMAT=image/png
```

--------------------------------

### Check formatting with make format-check

Source: https://docs.geo.admin.ch/README.html

Checks code formatting using the prettier package. Run from the project root.

```sh
make format-check
```

--------------------------------

### Example asset JSON (v0.9)

Source: https://docs.geo.admin.ch/download-data/stac-api/migrate09-10.html

Shows a STAC asset in v0.9 format, including custom geoadmin fields, projection, and links. Use for migration to v1.

```json
{
  "id": "smr50-263-2016-2056-kgrs-2.5.tiff",
  "title": "Thumbnail",
  "description": "string",
  "type": "image/tiff; application=geotiff",
  "href": "http://data.geo.admin.ch/ch.swisstopo.swissimage/collections/cs/items/CS3-20160503_132130_04/thumb.png",
  "file:checksum": "90e402107a7f2588a85362b9beea2a12d4514d45",
  "roles": ["thumbnail"],
  "geoadmin:variant": "komb",
  "geoadmin:lang": "de",
  "proj:epsg": 2056,
  "gsd": 2.5,
  "created": "2018-02-12T23:20:50Z",
  "updated": "2018-02-12T23:20:50Z",
  "links": [
    {
      "href": "https://data.geo.admin.ch/api/stac/v0.9/collections/ch.swisstopo.pixelkarte-farbe-pk50.noscale/items/smr200-200-4-2019/assets/smr50-263-2016-2056-kgrs-2.5.tiff",
      "rel": "self",
      "hreflang": "de"
    },
    {
      "href": "https://data.geo.admin.ch/api/stac/v0.9/",
      "rel": "root"
    }
  ]
}
```

--------------------------------

### GET request URL for Layer Attributes

Source: https://docs.geo.admin.ch/explore-data/get-layer-attributes.html

The base URL for the Get Layer Attributes endpoint. Replace {layerBodId} with the technical layer ID.

```http
https://api3.geo.admin.ch/rest/services/ech/MapServer/{layerBodId}
```

--------------------------------

### GetFeatureInfo curl example with response

Source: https://docs.geo.admin.ch/visualize-data/wms.html

Example curl command for a GetFeatureInfo request and its text/plain response. The response shows feature attributes for the queried point.

```sh
curl https://wms.geo.admin.ch/?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetFeatureInfo&FORMAT=image%2Fpng&TRANSPARENT=true&QUERY_LAYERS=ch.bafu.bundesinventare-bln&LAYERS=ch.bafu.bundesinventare-bln&FEATURE_COUNT=10&INFO_FORMAT=text%2Fplain&LANG=en&I=50&J=50&CRS=EPSG%3A2056&STYLES=&WIDTH=101&HEIGHT=101&BBOX=2609000%2C1123050%2C2614050%2C1128100
```

```txt
GetFeatureInfo results:
Layer 'ch.bafu.bundesinventare-bln'
  Feature 1362: 
    No. = '1716'
    Name = 'Pfynwald – Illgraben'
    Area_ha = '5064.29'
    Objectsheet = 'https://data.geo.admin.ch/ch.bafu.bundesinventare-bln/objectsheets/2017revision/nr1716.pdf'
    Subarea-No. = '0'
    Subarea = ''
```

--------------------------------

### Usage examples for range_download.py

Source: https://docs.geo.admin.ch/download-data/stac-api/large-assets.html

Command-line usage for the range_download.py script. Basic usage auto-detects size and checksum via range probe. Options: --chunk-size (MB, default 20 GB) and --total-size (bytes) to skip probe.

```bash
# Basic usage (auto-detects size and checksum via range probe)
python3 range_download.py "https://data.geo.admin.ch/.../file.tar" /path/to/file.tar

# Custom chunk size 2GB (in MB, default is 20 GB)
python3 range_download.py "https://..." /path/to/file.tar --chunk-size 2048

# Skip the probe if you already know the total size
python3 range_download.py "https://..." /path/to/file.tar --total-size 102265118720
```

--------------------------------

### Reverse Geocoding Response Example

Source: https://docs.geo.admin.ch/access-data/identify-features.html

Example JSON response from a reverse geocoding request, showing the structure with a results array and detailed attributes for a matched feature.

```json
{
  "results": [
    {
      "layerBodId": "ch.bfs.gebaeude_wohnungs_register",
      "layerName": "RBD: building status",
      "featureId": "1272199_0",
      "id": "1272199_0",
      "attributes": {
        "egid": "1272199",
        "strname_deinr": "Seftigenstrasse 264",
        "plz_plz6": "3084/308400",
        "ggdename": "Köniz",
        "ggdenr": 355,
        "gexpdat": "12.07.2025",
        "gdekt": "BE",
        "egrid": "CH669746359158",
        "lgbkr": 0,
        "lparz": "212",
        "lparzsx": null,
        "ltyp": null,
        "gebnr": "",
        "gbez": "",
        "gkode": 2600983.546,
        "gkodn": 1197396.177,
        "gksce": 901,
        "gstat": 1004,
        "gkat": 1060,
        "gklas": null,
        "gbauj": null,
        "gbaum": null,
        "gbaup": 8011,
        "gabbj": null,
        "garea": 3143,
        "gvol": null,
        "gvolnorm": null,
        "gvolsce": null,
        "gastw": 4,
        "ganzwhg": null,
        "gazzi": null,
        "gschutzr": null,
        "gebf": null,
        "gwaerzh1": 7430,
        "genh1": 7542,
        "gwaersceh1": 865,
        "gwaerdath1": "14.03.2023",
        "gwaerzh2": null,
        "genh2": null,
        "gwaersceh2": null,
        "gwaerdath2": "-",
        "gwaerzw1": 7630,
        "genw1": 7530,
        "gwaerscew1": 869,
        "gwaerdatw1": "29.11.2001",
        "gwaerzw2": null,
        "genw2": null,
        "gwaerscew2": null,
        "gwaerdatw2": "-",
        "edid": "0",
        "egaid": 100718281,
        "deinr": "264",
        "esid": 10006665,
        "strname": ["Seftigenstrasse"],
        "strnamk": ["Seftigenstr."],
        "strindx": ["Sef"],
        "strsp": ["DE"],
        "stroffiziel": "1",
        "dplz4": 3084,
        "dplzz": 0,
        "dplzname": "Wabern",
        "dkode": 2600968.668,
        "dkodn": 1197426.954,
        "doffadr": 1,
        "dexpdat": "12.07.2025",
        "ewid": null,
        "whgnr": null,
        "wstwk": null,
        "wmehrg": null,
        "weinr": null,
        "wbez": null,
        "wstat": null,
        "wexpdat": null,
        "wbauj": null,
        "wabbj": null,
        "warea": null,
        "wazim": null,
        "wkche": null,
        "label": "Seftigenstrasse 264"
      }
    }
  ]
}
```

--------------------------------

### OpenLayers 10 example: Simple XYZ in WebMercator

Source: https://docs.geo.admin.ch/visualize-data/xyz.html

CodeSandbox example showing the SWISSIMAGE layer as XYZ tiles in WebMercator projection. Uses OpenLayers 10.7.0.

```javascript
// CodeSandbox example: Simple XYZ in WebMercator
// Used on https://docs.geo.admin.ch/visualize-data/xyz.html
// Files: index.js, styles.css, index.html, package.json
// Dependencies: ol@10.7.0
```
Tokens:
Raw