### 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 "" ``` -------------------------------- ### 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 `` ### Parameters #### Path Parameters - **``** (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 "" -o ``` ### Response #### Success Response (200) - Binary data of the GRIB file. #### Response Example ```bash wget -O "" ``` ``` -------------------------------- ### 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": "" } } } ``` ``` -------------------------------- ### 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 ### Command Example ```bash wget -O "" ``` ``` -------------------------------- ### 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": "", "type": "application/grib2", "title": "Horizontal constants" }, "vertical_constants_icon-ch1-eps.grib2": { "href": "", "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": "", "roles": ["data"], "type": "application/grib2" }, "horizontal_constants_icon-ch1-eps.grib2": { "href": "", "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": "" } } } ``` ``` -------------------------------- ### 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": "", "title": "Horizontal constants for ICON-CH1-EPS", "type": "application/grib2", "roles": ["metadata"] }, "vertical_constants_icon-ch1-eps": { "href": "", "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": "", "title": "Horizontal constants for ICON-CH1-EPS", "type": "application/grib", "roles": ["metadata"] }, "vertical_constants_icon-ch1-eps.grib2": { "href": "", "title": "Vertical constants for ICON-CH1-EPS", "type": "application/grib", "roles": ["metadata"] } } } ``` ``` -------------------------------- ### Untitled No description