MeteoSwiss Open Data

https://opendatadocs.meteoswiss.ch/
Admin
MeteoSwiss Open Data provides access to various meteorological and climatological datasets,...
Tokens:44,325
Snippets:489
Trust Score:9.5
Update:1 year ago
Show doc for...
Tokens:
Raw
### Untitled

No description

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

### Untitled

No description

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

### Metadata: Data Inventory

Source: https://opendatadocs.meteoswiss.ch/a-data-groundbased/a5-manual-precipitation-stations

Downloads a CSV file listing all stations and parameters with the start and end dates of their measurements.

```APIDOC
## GET /ogd-nime_meta_datainventory.csv

### Description
Provides an inventory of measurements for each station and parameter, indicating the start and end dates of data availability.

### Method
GET

### Endpoint
`https://data.geo.admin.ch/meteoschweiz/ogd-nime/ch.meteoschweiz.ogd-nime_meta_datainventory.csv`

### Response
#### Success Response (200)
Returns a CSV file with the following columns:
- **station_id**: Three-letter identifier for the station.
- **parameter_id**: Unique identifier for the parameter.
- **start_date**: The start date of measurements for the given station and parameter.
- **end_date**: The end date of measurements for the given station and parameter.

#### Response Example
```csv
station_id,parameter_id,start_date,end_date
AIG,rr24,2000-01-01,2023-10-26
AIG,snow_depth,2000-11-15,2023-04-30
...
```
```

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

### Untitled

No description

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

### Untitled

No description

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

### Untitled

No description

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

### Untitled

No description

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

### Untitled

No description

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

### Untitled

No description

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

### Untitled

No description

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

### Untitled

No description

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

### Untitled

No description

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

### Checking GRIB Information with ecCodes

Source: https://opendatadocs.meteoswiss.ch/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=browser

This command uses the ecCodes utility 'codes_info' to display detailed information about the GRIB data being processed. It helps in verifying the setup of GRIB definition paths and understanding the metadata contained within GRIB records.

```shell
codes_info  
```

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

### Untitled

No description

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

### Untitled

No description

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

### Check ecCodes Information

Source: https://opendatadocs.meteoswiss.ch/de/e-forecast-data/e2-e3-numerical-weather-forecasting-model

A command-line utility to check the details and configuration of the installed ecCodes library. This can be useful for verifying that the GRIB_DEFINITION_PATH has been set correctly and that ecCodes can access the necessary GRIB tables.

```bash
codes_info
```

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

### Untitled

No description

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

### Untitled

No description

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

### Retrieve Horizontal Constants using curl and wget

Source: https://opendatadocs.meteoswiss.ch/fr/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=pythonapi

Retrieves static horizontal grid information (longitude, latitude, land cover, surface height, soil type) for a specified forecast collection. It involves a GET request to fetch asset links and then downloading the constants file.

```bash
curl -X GET https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-forecasting-icon-ch1/assets
```

```bash
wget -O <desired_filename> "<pre-signed URL>"
```

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

### Request latest forecast data using Python API

Source: https://opendatadocs.meteoswiss.ch/fr/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=restapi

Demonstrates how to request the latest available forecast data using the `meteodatalab.ogd_api` Python library. By setting `ref_time='latest'`, the most recent forecast run is automatically selected.

```python
from meteodatalab import ogd_api

req = ogd_api.Request(
    collection="ogd-forecasting-icon-ch2",
    variable="TOT_PREC",
    ref_time="latest", # Select the most recent available run
    perturbed=False,
    lead_time="P0DT0H",
)

tot_prec = ogd_api.get_from_ogd(req)

```

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

### Untitled

No description

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

### Untitled

No description

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

### Untitled

No description

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

### Untitled

No description

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

### Untitled

No description

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

### Untitled

No description

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

### GET /api/stac/v1/collections/{collectionId}/assets - Access Static Grid Information

Source: https://opendatadocs.meteoswiss.ch/fr/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=restapi

Retrieve static horizontal and vertical grid parameter files for a given collection. These files are necessary for interpreting forecast data.

```APIDOC
## GET /api/stac/v1/collections/{collectionId}/assets

### Description
This endpoint retrieves static grid information, including horizontal and vertical constants, for a specified collection. This data is crucial for geolocating and interpreting forecast data.

### Method
GET

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

### Parameters
#### Path Parameters
- **collectionId** (string) - Required - The identifier of the collection (e.g., `ch.meteoschweiz.ogd-forecasting-icon-ch1`).

### Request Example
```bash
curl -X GET https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-forecasting-icon-ch1/assets
```

### Response
#### Success Response (200)
- **assets** (object) - Contains metadata and links to static files.
  - **href** (string) - Pre-signed URL to download the static GRIB file (e.g., `horizontal_constants_icon-ch1-eps.grib2`).
```

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

### Untitled

No description

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

### Download Forecast Data

Source: https://opendatadocs.meteoswiss.ch/it/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=browser

Instructions on how to download the forecast GRIB file using a pre-signed URL obtained from the search response.

```APIDOC
## Download Forecast Data

### Description
Download the forecast GRIB file using a pre-signed URL obtained from the search response.

### Method
GET

### Endpoint
`<pre-signed URL>`

### Parameters
#### Path Parameters
- **`<pre-signed URL>`** (string) - Required - The URL provided in the `assets.href` field of the search response.

#### Query Parameters
None

#### Request Body
None

### Request Example
```bash
curl -X GET "<pre-signed URL>" -o <desired_filename>
```

### Response
#### Success Response (200)
- Binary data of the GRIB file.

#### Response Example
```bash
wget -O <desired_filename> "<pre-signed URL>"
```
```

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

### Untitled

No description

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

### GET /api/stac/v1/collections/{collectionId}/assets

Source: https://opendatadocs.meteoswiss.ch/fr/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=pythonapi

Retrieve static horizontal and vertical grid information for a specified collection. This is necessary for interpreting forecast data.

```APIDOC
## GET /api/stac/v1/collections/{collectionId}/assets

### Description
Retrieve static horizontal and vertical grid information for a specified collection. This is necessary for interpreting forecast data.

### Method
GET

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

### Parameters
#### Path Parameters
- **collectionId** (string) - Required - The identifier of the collection (e.g., `ch.meteoschweiz.ogd-forecasting-icon-ch1`).

### Request Example
```bash
curl -X GET https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-forecasting-icon-ch1/assets
```

### Response
#### Success Response (200)
- **assets** (object) - Dictionary containing metadata, including pre-signed URLs for static files (e.g., `horizontal_constants_icon-ch1-eps.grib2`) under the `href` field.

#### Response Example
(Response body contains metadata including asset URLs for static files)
```

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

### Untitled

No description

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

### GET /api/stac/v1/collections/{collectionId}/assets

Source: https://opendatadocs.meteoswiss.ch/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=pythonapi

Retrieve static horizontal constant files for a specified collection. These files contain grid information necessary for interpreting forecast data.

```APIDOC
## GET /api/stac/v1/collections/{collectionId}/assets

### Description
Retrieves static horizontal and vertical constant files for a specified collection. These files contain crucial grid and surface information needed to interpret forecast data.

### Method
GET

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

### Parameters
#### Path Parameters
- **collectionId** (string) - Required - The identifier of the collection to retrieve static files from (e.g., `ch.meteoschweiz.ogd-forecasting-icon-ch1`).

### Request Example
```bash
curl -X GET https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-forecasting-icon-ch1/assets
```

### Response
#### Success Response (200)
- **assets** (object) - A dictionary containing metadata and pre-signed URLs for static files, including `horizontal_constants_icon-ch1-eps.grib2` and potentially vertical constants.

#### Response Example
```json
{
  "assets": {
    "horizontal_constants_icon-ch1-eps.grib2": {
      "href": "<pre-signed URL for horizontal constants>"
    }
  }
}
```
```

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

### Untitled

No description

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

### Download Forecast Data

Source: https://opendatadocs.meteoswiss.ch/e-forecast-data/e2-e3-numerical-weather-forecasting-model

Instructions for downloading the forecast data using a pre-signed URL obtained from the search endpoint.

```APIDOC
## Download Forecast Data

### Description
Downloads the forecast data using a pre-signed URL.

### Method
GET

### Endpoint
<pre-signed URL provided in the search response>

### Command Example
```bash
wget -O <desired_filename> "<pre-signed URL>"
```
```

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

### Untitled

No description

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

### Untitled

No description

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

### GET /api/stac/v1/collections/{collectionId}/assets - Access Static Grid Information

Source: https://opendatadocs.meteoswiss.ch/it/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=restapi

Retrieves static horizontal and vertical grid parameter files for a given collection, which are necessary for interpreting forecast data.

```APIDOC
## GET /api/stac/v1/collections/{collectionId}/assets

### Description
Accesses static grid information, including horizontal and vertical constants, for a specified forecast collection. These files are essential for interpreting the forecast data.

### Method
GET

### Endpoint
`https://data.geo.admin.ch/api/stac/v1/collections/{collectionId}/assets`

_Replace `{collectionId}` with the ID of the desired collection (e.g., `ch.meteoschweiz.ogd-forecasting-icon-ch1`)._

### Parameters
#### Path Parameters
- **collectionId** (string) - Required - The ID of the forecast collection (e.g., `ch.meteoschweiz.ogd-forecasting-icon-ch1`).

### Request Example
```bash
curl -X GET https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-forecasting-icon-ch1/assets
```

### Response
#### Success Response (200)
- **assets** (object) - Contains metadata for static files. Look for `horizontal_constants_icon-ch1-eps.grib2` (or similar) and its `href` field for the pre-signed URL.

**Note:** Before using the constants, verify that the `uuidOfHGrid` GRIB key matches the one in your forecast data for consistency.
```

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

### Metadata: Parameters

Source: https://opendatadocs.meteoswiss.ch/a-data-groundbased/a5-manual-precipitation-stations

Downloads a CSV file containing information about all available precipitation parameters, including their identifiers, descriptions, time intervals, and units.

```APIDOC
## GET /ogd-nime_meta_parameters.csv

### Description
Provides a list of all parameters measured by MeteoSwiss manual precipitation stations. Each parameter has a unique identifier dependent on the time resolution.

### Method
GET

### Endpoint
`https://data.geo.admin.ch/meteoschweiz/ogd-nime/ch.meteoschweiz.ogd-nime_meta_parameters.csv`

### Response
#### Success Response (200)
Returns a CSV file with the following columns:
- **parameter_id**: Unique identifier for the parameter.
- **description**: Explanation of the parameter.
- **time_interval**: The time resolution of the measurements (e.g., daily, monthly).
- **decimal_places**: Number of decimal places for the measurement.
- **data_type**: The data type of the parameter.
- **unit**: The unit of measurement.

#### Response Example
```csv
parameter_id,description,time_interval,decimal_places,data_type,unit
rr24,24-hour precipitation sum,d,1,float,mm
snow_depth,Snow depth,d,1,float,cm
...
```
```

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

### GET /api/stac/v1/collections/{collectionId}/assets - Access Static Grid Information

Source: https://opendatadocs.meteoswiss.ch/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=restapi

Retrieve static horizontal and vertical grid constant files for a given collection. These files are necessary for interpreting forecast data.

```APIDOC
## GET /api/stac/v1/collections/{collectionId}/assets

### Description
Retrieves static grid information, including horizontal and vertical constants, for a specified collection. This data is essential for geolocating and interpreting forecast data.

### Method
GET

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

### Parameters
#### Path Parameters
- **collectionId** (string) - Required - The identifier of the collection to retrieve static files from (e.g., `ch.meteoschweiz.ogd-forecasting-icon-ch1`).

### Request Example
```bash
curl -X GET https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-forecasting-icon-ch1/assets
```

### Response
#### Success Response (200)
- **assets** (object) - A dictionary containing metadata about static files, including `href` fields with pre-signed URLs for files like `horizontal_constants_icon-ch1-eps.grib2`.

#### Response Example
```json
{
  "horizontal_constants_icon-ch1-eps.grib2": {
    "href": "<pre-signed URL for horizontal constants file>",
    "type": "application/grib2",
    "title": "Horizontal constants"
  },
  "vertical_constants_icon-ch1-eps.grib2": {
    "href": "<pre-signed URL for vertical constants file>",
    "type": "application/grib2",
    "title": "Vertical constants"
  }
}
```
```

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

### Untitled

No description

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

### GET /api/stac/v1/collections/{collectionId}/assets

Source: https://opendatadocs.meteoswiss.ch/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=browser

Retrieve static horizontal constants files for a given collection. These files contain longitude, latitude, land cover, surface height, and soil type information.

```APIDOC
## GET /api/stac/v1/collections/{collectionId}/assets

### Description
This endpoint retrieves static horizontal grid parameter files for a specified forecast collection.

### Method
GET

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

### Parameters
#### Path Parameters
- **collectionId** (string) - Required - The identifier of the forecast collection (e.g., `ch.meteoschweiz.ogd-forecasting-icon-ch1`).

#### Query Parameters
None

### Request Example
```bash
curl -X GET https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-forecasting-icon-ch1/assets
```

### Response
#### Success Response (200)
- **assets** (object) - A dictionary containing metadata about the static files, including the `href` for the horizontal constants file.

#### Response Example
```json
{
  "links": [...],
  "stac_version": "1.0.0",
  "id": "ch.meteoschweiz.ogd-forecasting-icon-ch1",
  "title": "ICON-CH1-EPS",
  "description": "...",
  "extent": {
    "spatial": {
      "bbox": [[...]]
    },
    "temporal": {
      "interval": [[...]]
    }
  },
  "item_assets": {
    "vertical_constants_icon-ch1-eps.grib2": {
      "href": "<pre-signed URL for vertical constants file>",
      "roles": ["data"],
      "type": "application/grib2"
    },
    "horizontal_constants_icon-ch1-eps.grib2": {
      "href": "<pre-signed URL for horizontal constants file>",
      "roles": ["data"],
      "type": "application/grib2"
    }
  }
}
```
```

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

### GET /api/stac/v1/collections/{collectionId}/assets

Source: https://opendatadocs.meteoswiss.ch/de/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=restapi

Retrieves static horizontal constants for a specified collection. These files contain geolocation and interpretation data for the forecast grid.

```APIDOC
## GET /api/stac/v1/collections/{collectionId}/assets

### Description
Retrieves static horizontal constants for a specified collection. These files contain geolocation and interpretation data for the forecast grid.

### Method
GET

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

### Parameters
#### Path Parameters
- **collectionId** (string) - Required - The identifier of the collection to retrieve static files from (e.g., `ch.meteoschweiz.ogd-forecasting-icon-ch1`).

#### Query Parameters
None

#### Request Body
None

### Request Example
```bash
curl -X GET https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-forecasting-icon-ch1/assets
```

### Response
#### Success Response (200)
- **assets** (object) - A dictionary containing metadata, including a pre-signed URL for the `horizontal_constants_icon-ch1-eps.grib2` file under the `href` field.

#### Response Example
```json
{
  "assets": {
    "horizontal_constants_icon-ch1-eps.grib2": {
      "href": "<pre-signed URL>"
    }
  }
}
```
```

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

### GET /api/stac/v1/collections/{collectionId}/assets - Access Static Grid Information

Source: https://opendatadocs.meteoswiss.ch/fr/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=browser

This endpoint allows you to retrieve static horizontal and vertical grid parameters for a specified collection. These files are necessary for interpreting forecast data.

```APIDOC
## GET /api/stac/v1/collections/{collectionId}/assets

### Description
This endpoint allows you to retrieve static horizontal and vertical grid parameters for a specified collection. These files are necessary for interpreting forecast data.

### Method
GET

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

### Parameters
#### Path Parameters
- **collectionId** (string) - Required - The ID of the collection to retrieve static files from (e.g., `ch.meteoschweiz.ogd-forecasting-icon-ch1`).

### Request Example
```bash
curl -X GET https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-forecasting-icon-ch1/assets
```

### Response
#### Success Response (200)
- **assets** (object) - A dictionary containing metadata, including `href` fields for static files like `horizontal_constants_icon-ch1-eps.grib2`.

#### Response Example
```json
{
  "stac_version": "1.0.0",
  "type": "Collection",
  "id": "ch.meteoschweiz.ogd-forecasting-icon-ch1",
  "links": [...],
  "assets": {
    "horizontal_constants_icon-ch1-eps": {
      "href": "<pre-signed URL for horizontal constants>",
      "title": "Horizontal constants for ICON-CH1-EPS",
      "type": "application/grib2",
      "roles": ["metadata"]
    },
    "vertical_constants_icon-ch1-eps": {
      "href": "<pre-signed URL for vertical constants>",
      "title": "Vertical constants for ICON-CH1-EPS",
      "type": "application/grib2",
      "roles": ["metadata"]
    }
  }
}
```
```

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

### STAC API - Get Collection Metadata

Source: https://opendatadocs.meteoswiss.ch/general/download

Fetch detailed metadata for a specific data collection. This endpoint provides comprehensive information about a particular dataset, such as its description, spatial and temporal coverage, and available assets.

```APIDOC
## GET /getCollections

### Description
Retrieves detailed metadata for a specific data collection. This endpoint provides comprehensive information about a particular dataset.

### Method
GET

### Endpoint
`https://data.geo.admin.ch/api/stac/v1/collections/{collectionId}`

### Parameters
#### Path Parameters
- **collectionId** (string) - Required - The unique identifier of the collection for which to retrieve metadata.

### Request Example
None

### Response
#### Success Response (200)
- **id** (string) - The unique identifier of the collection.
- **title** (string) - The human-readable title of the collection.
- **description** (string) - A detailed description of the dataset within the collection.
- **extent** (object) - Information about the spatial and temporal extent of the data.
- **links** (array) - Links to related resources, including assets.

#### Response Example
```json
{
  "id": "ch.meteoschweiz.ogd-smn",
  "title": "Automatic weather stations",
  "description": "...",
  "extent": { ... },
  "links": [
    { "rel": "self", "href": "..." },
    { "rel": "items", "href": ".../items" }
    // ... more links
  ]
}
```
```

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

### Untitled

No description

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

### GET /api/stac/v1/collections/{collectionId}/assets - Retrieve Static Horizontal Constants

Source: https://opendatadocs.meteoswiss.ch/it/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=pythonapi

Retrieves static horizontal constants for a given collection. This includes longitude, latitude, land cover, surface height, and soil type information.

```APIDOC
## GET /api/stac/v1/collections/{collectionId}/assets

### Description
Retrieves static horizontal constants for a specified collection. This includes parameters like longitude (CLON), latitude (CLAT), land cover (FR_LAND), surface height (HSURF), and soil type (SOILTYPE).

### Method
GET

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

### Parameters
#### Path Parameters
- **collectionId** (string) - Required - The identifier of the collection (e.g., `ch.meteoschweiz.ogd-forecasting-icon-ch1`).

### Request Example
```bash
curl -X GET https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-forecasting-icon-ch1/assets
```

### Response
#### Success Response (200)
- **assets** (object) - Contains metadata including pre-signed URLs for static files, such as `horizontal_constants_icon-ch1-eps.grib2`.
```

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

### Untitled

No description

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

### Untitled

No description

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

### GET /api/stac/v1/collections/{collectionId}/assets

Source: https://opendatadocs.meteoswiss.ch/de/e-forecast-data/e2-e3-numerical-weather-forecasting-model_download-options=pythonapi

Retrieve static horizontal and vertical grid parameter files for a given collection. These files contain essential information for interpreting forecast data.

```APIDOC
## GET /api/stac/v1/collections/{collectionId}/assets

### Description
Retrieves static grid information, including horizontal and vertical constants, for a specified forecast collection. This data is necessary for interpreting the geolocational and vertical aspects of the forecast GRIB files.

### Method
GET

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

### Parameters
#### Path Parameters
- **collectionId** (string) - Required - The identifier of the collection for which to retrieve static files (e.g., `ch.meteoschweiz.ogd-forecasting-icon-ch1`).

### Request Example
```bash
curl -X GET https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-forecasting-icon-ch1/assets
```

### Response
#### Success Response (200)
- **assets** (object) - Contains metadata and pre-signed URLs for static files such as `horizontal_constants_icon-ch1-eps.grib2`.

#### Response Example
```json
{
  "stac_version": "1.0.0",
  "type": "Collection",
  "id": "ch.meteoschweiz.ogd-forecasting-icon-ch1",
  "title": "ICON-CH1-EPS forecast data",
  "description": "Forecast data from the ICON-CH1-EPS model.",
  "links": [
    {
      "rel": "self",
      "href": "https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-forecasting-icon-ch1",
      "type": "application/json",
      "method": "GET"
    }
  ],
  "assets": {
    "horizontal_constants_icon-ch1-eps.grib2": {
      "href": "<pre-signed URL for horizontal constants file>",
      "title": "Horizontal constants for ICON-CH1-EPS",
      "type": "application/grib",
      "roles": ["metadata"]
    },
    "vertical_constants_icon-ch1-eps.grib2": {
      "href": "<pre-signed URL for vertical constants file>",
      "title": "Vertical constants for ICON-CH1-EPS",
      "type": "application/grib",
      "roles": ["metadata"]
    }
  }
}
```
```

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

### Untitled

No description
Tokens:
Raw