Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/data/_category_.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
{
"position": 2,
"label": "Bulk Data",
"label": "Data Access",
"collapsible": true,
"collapsed": true,
"link": {
"type": "generated-index",
"title": "Bulk Data"
"title": "Data Access"
}
}
10 changes: 10 additions & 0 deletions docs/data/bulk/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
{
"position": 3,
"label": "Bulk Data",
"collapsible": true,
"collapsed": true,
"link": {
"type": "doc",
"id": "data-bulk-overview"
}
}
37 changes: 37 additions & 0 deletions docs/data/bulk/daily.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
title: Daily Bulk Data | Data Access
sidebar_label: Daily Data
sidebar_position: 2
---

# Daily Data

This endpoint provides **one Parquet file per year**.

:::warning[Beta]
This interface is currently in beta. We are actively working on improving it and adding new features. The formats and data structures may change in the future. We recommend checking back regularly for updates and improvements.
:::

## Endpoints

Annual data dumps, including model data as a substitute for missing observations, are available here:

```
https://data.meteostat.net/daily/{year}.parquet
```

Please replace `{year}` with the desired year number.

## Structure

Parquet files use a columnar storage format. The columns correspond to the parameter codes described [here](/parameters?g=daily&d=1).

More information on the data formats and weather condition codes is available [here](/formats).

:::tip[Geographical Coordinates]
The Parquet files only contain the station ID, but not the geographical coordinates. To retrieve the coordinates, please download the [weather station database](/data/weather-stations) and join it based on the station ID.
:::

### Data Sources

Each data column has a corresponding source column with the `_source` suffix.
37 changes: 37 additions & 0 deletions docs/data/bulk/hourly.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
title: Hourly Bulk Data | Data Access
sidebar_label: Hourly Data
sidebar_position: 1
---

# Hourly Data

This endpoint provides **one Parquet file per year**. The provided data is aggregated from historical databases, METAR reports and SYNOP data.

:::warning[Beta]
This interface is currently in beta. We are actively working on improving it and adding new features. The formats and data structures may change in the future. We recommend checking back regularly for updates and improvements.
:::

## Endpoints

Annual data dumps, including model data as a substitute for missing observations, are available here:

```
https://data.meteostat.net/hourly/{year}.parquet
```

Please replace `{year}` with the desired year number.

## Structure

Parquet files use a columnar storage format. The columns correspond to the parameter codes described [here](/parameters?g=hourly&d=1).

More information on the data formats and weather condition codes is available [here](/formats).

:::tip[Geographical Coordinates]
The Parquet files only contain the station ID, but not the geographical coordinates. To retrieve the coordinates, please download the [weather station database](/data/weather-stations) and join it based on the station ID.
:::

### Data Sources

Each data column has a corresponding source column with the `_source` suffix.
35 changes: 35 additions & 0 deletions docs/data/bulk/monthly.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
title: Monthly Bulk Data | Data Access
sidebar_label: Monthly Data
sidebar_position: 3
---

# Monthly Data

This endpoint provides **a single Parquet file** containing historical monthly data for all weather stations.

:::warning[Beta]
This interface is currently in beta. We are actively working on improving it and adding new features. The formats and data structures may change in the future. We recommend checking back regularly for updates and improvements.
:::

## Endpoints

The historical monthly data, including model data as a substitute for missing observations, for all weather stations is available here:

```
https://data.meteostat.net/monthly.parquet
```

## Structure

Parquet files use a columnar storage format. The columns correspond to the parameter codes described [here](/parameters?g=monthly&d=1).

More information on the data formats and weather condition codes is available [here](/formats).

:::tip[Geographical Coordinates]
The Parquet files only contain the station ID, but not the geographical coordinates. To retrieve the coordinates, please download the [weather station database](/data/weather-stations) and join it based on the station ID.
:::

### Data Sources

Each data column has a corresponding source column with the `_source` suffix.
47 changes: 47 additions & 0 deletions docs/data/bulk/overview.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
---
title: Bulk Data | Data Access
sidebar_label: Overview
id: data-bulk-overview
slug: /data/bulk
sidebar_position: 1
---

import DocCardList from '@theme/DocCardList';

# Bulk Data

The Meteostat bulk data interface provides access to weather and climate data across **all** weather stations in **Parquet** format. It's especially useful for large-scale, spatial analysis. Users are **not required to sign up** for this service.

:::warning[Beta]
This interface is currently in beta. We are actively working on improving it and adding new features. The formats and data structures may change in the future. We recommend checking back regularly for updates and improvements.
:::

## 🔌 Access

This interface does not require an API key. However, when using this service you must comply with our [terms of service](/terms). Please make sure to cache data if possible and forbear from sending malicious calls to this service.

Data is available in three different granularities:

- [Hourly data](/data/bulk/hourly)
- [Daily data](/data/bulk/daily)
- [Monthly data](/data/bulk/monthly)

:::warning
Years without data will return an HTTP `404` status code.
:::

## 🚀 Quick Start

The download of annual data dumps is dead simple and doesn’t even require an API key:

```bash
curl "https://data.meteostat.net/hourly/2024.parquet" --output "2024.parquet"
```

## 🔄 Update Cycle

The dumps are updated regularly, depending on the granularity of records. Recent hourly data should be available after a maximum of 24 hours.

## 👀 Learn More {#learn-more}

<DocCardList />
32 changes: 3 additions & 29 deletions docs/data/overview.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Bulk Data
title: Data Access
sidebar_label: Overview
id: data-overview
slug: /data
Expand All @@ -8,35 +8,9 @@ sidebar_position: 1

import DocCardList from '@theme/DocCardList';

# Bulk Data
# Data Access

The Meteostat bulk data interface provides access to full data dumps of individual weather stations. The data is provided in CSV (weather data) and JSON (weather stations) format. Users are **not required to sign up** for this service.

## 🔌 Access

```
https://data.meteostat.net
```

:::warning
The dumps of weather stations which didn't report data for the requested frequency or data type will return an HTTP `404` status code.
:::

In contrast to our JSON API the Bulk Data interface does not require an API key. However, when using this service you must comply with our [terms of service](/terms). Please make sure to cache data if possible and forbear from sending malicious calls to this service.

## 🚀 Quick Start

The download of annual data dumps is dead simple and doesn’t even require an API key:

```bash
curl "https://data.meteostat.net/hourly/2024/10637.csv.gz" --output "10637-2024.csv.gz"
```

With our [Python library](/python/) we're providing a simple, yet powerful, wrapper for bulk data dumps. If you're into more complex analysis you should definitely have a look at it.

## 🔄 Update Cycle

To keep the load on our infrastructure as low as possible, Meteostat updates bulk data dumps individually for each weather station. The dumps are updated regularly, depending on the granularity of records. Recent hourly data should be available after a maximum of 24 hours.
Meteostat provides open and free access to historical weather and climate data. Users can download full [time series](/data/timeseries/) of individual weather stations provided in **CSV** format and [bulk data](/data/bulk/) in **Parquet** format. Weather station [meta data](/data/weather-stations) is provided in **JSON** and **SQL** formats. Users are **not required to sign up** for this service.

## 👀 Learn More

Expand Down
9 changes: 5 additions & 4 deletions docs/data/timeseries/daily.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: Daily Data | Bulk Data
title: Daily Data | Data Access
sidebar_label: Daily Data
sidebar_position: 2
---

# Daily Data

This endpoint provides one GZ compressed CSV file per weather station and year.
This endpoint provides one **gzip-compressed CSV file** per weather station and year.

## Endpoints

Expand All @@ -16,11 +16,12 @@ Annual data dumps, including model data as substitute for missing observations,
https://data.meteostat.net/daily/{year}/{station}.csv.gz
```

Please replace `{year}` with the desired year number and `{station}` with the ID of a weather station.
Please replace `{year}` with the desired year number and `{station}` with the ID of a [weather station](/data/weather-stations).

## Structure

CSV files provided through the Meteostat bulk data interface use commas as separators. Each file includes a header row containing the column names, which correspond to the parameter codes described [here](/formats#meteorological-parameters).
CSV files use commas as separators. Each file includes a header row containing the column names, which correspond to the parameter codes described [here](/parameters?g=daily&d=1).
The files **only contain the default set of parameters**. Additional parameters are not included in the data dumps, but can be retrieved through the [Python library](/python/).

More information on the data formats and weather condition codes is available [here](/formats).

Expand Down
9 changes: 5 additions & 4 deletions docs/data/timeseries/hourly.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: Hourly Data | Bulk Data
title: Hourly Data | Data Access
sidebar_label: Hourly Data
sidebar_position: 1
---

# Hourly Data

This endpoint provides one GZ compressed CSV file per weather station and year. The provided data is being aggregated from historical databases, METAR reports and SYNOP data.
This endpoint provides one **gzip-compressed CSV file** per weather station and year. The provided data is aggregated from historical databases, METAR reports and SYNOP data.

## Endpoints

Expand All @@ -16,11 +16,12 @@ Annual data dumps, including model data as substitute for missing observations,
https://data.meteostat.net/hourly/{year}/{station}.csv.gz
```

Please replace `{year}` with the desired year number and `{station}` with the ID of a weather station.
Please replace `{year}` with the desired year number and `{station}` with the ID of a [weather station](/data/weather-stations).

## Structure

CSV files provided through the Meteostat bulk data interface use commas as separators. Each file includes a header row containing the column names, which correspond to the parameter codes described [here](/formats#meteorological-parameters).
CSV files use commas as separators. Each file includes a header row containing the column names, which correspond to the parameter codes described [here](/parameters?g=hourly&d=1).
The files **only contain the default set of parameters**. Additional parameters are not included in the data dumps, but can be retrieved through the [Python library](/python/).

More information on the data formats and weather condition codes is available [here](/formats).

Expand Down
9 changes: 5 additions & 4 deletions docs/data/timeseries/monthly.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: Monthly Data | Bulk Data
title: Monthly Data | Data Access
sidebar_label: Monthly Data
sidebar_position: 3
---

# Monthly Data

This endpoint provides one GZ compressed CSV file per weather station.
This endpoint provides one **gzip-compressed CSV file** per weather station.

## Endpoints

Expand All @@ -16,11 +16,12 @@ Data dumps, including model data as substitute for missing observations, are ava
https://data.meteostat.net/monthly/{station}.csv.gz
```

Please replace `{station}` with the ID of a weather station.
Please replace `{station}` with the ID of a [weather station](/data/weather-stations).

## Structure

CSV files provided through the Meteostat bulk data interface use commas as separators. Each file includes a header row containing the column names, which correspond to the parameter codes described [here](/formats#meteorological-parameters).
CSV files use commas as separators. Each file includes a header row containing the column names, which correspond to the parameter codes described [here](/parameters?g=monthly&d=1).
The files **only contain the default set of parameters**. Additional parameters are not included in the data dumps, but can be retrieved through the [Python library](/python/).

More information on the data formats and weather condition codes is available [here](/formats).

Expand Down
32 changes: 30 additions & 2 deletions docs/data/timeseries/overview.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Time Series | Bulk Data
title: Time Series | Data Access
sidebar_label: Overview
id: data-timeseries-overview
slug: /data/timeseries
Expand All @@ -10,7 +10,35 @@ import DocCardList from '@theme/DocCardList';

# Time Series

The Meteostat bulk data interface provides access to full time series data dumps of individual weather stations. The data is provided in CSV format. Users are **not required to sign up** for this service.
Meteostat provides access to full time series data dumps of individual weather stations. The data is provided in CSV format. Users are **not required to sign up** for this service.

## 🔌 Access

This interface does not require an API key. However, when using this service you must comply with our [terms of service](/terms). Please make sure to cache data if possible and forbear from sending malicious calls to this service.

Data is available in three different granularities:

- [Hourly data](/data/timeseries/hourly)
- [Daily data](/data/timeseries/daily)
- [Monthly data](/data/timeseries/monthly)

:::warning
The dumps of weather stations which didn't report data for the requested granularity or data type will return an HTTP `404` status code.
:::

## 🚀 Quick Start

The download of annual data dumps is dead simple and doesn’t even require an API key:

```bash
curl "https://data.meteostat.net/hourly/2024/10637.csv.gz" --output "10637-2024.csv.gz"
```

With our [Python library](/python/) we're providing a simple, yet powerful, wrapper for data dumps. If you're into more complex analysis you should definitely have a look at it.

## 🔄 Update Cycle

To keep the load on our infrastructure as low as possible, Meteostat updates data dumps individually for each weather station. The dumps are updated regularly, depending on the granularity of records. Recent hourly data should be available after a maximum of 24 hours.

## 👀 Learn More {#learn-more}

Expand Down
2 changes: 1 addition & 1 deletion docs/data/weather-stations.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Weather Stations | Bulk Data
title: Weather Stations | Data Access
sidebar_label: Weather Stations
sidebar_position: 4
---
Expand Down
2 changes: 1 addition & 1 deletion docs/formats.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ sidebar_position: 2

# Formats & Units

Meteostat uses the metric system. Both the JSON API and the Bulk Data interface use the formats and units listed below.
Meteostat uses the metric system. All interfaces use the formats and units listed below.

## Time Format

Expand Down
3 changes: 2 additions & 1 deletion docs/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,8 @@ Meteostat provides several interfaces for retrieving weather and climate data. C

- [JSON API](/api/): Simple, fast access to Meteostat data in JSON format.
- [Python Library](/python/): Analyze historical weather data for thousands of stations with Pandas.
- [Bulk Data](/data/): Download full data dumps for individual weather stations.
- [Command Line Interface](/cli/): Access Meteostat data directly from your terminal.
- [Data Access](/data/): Download full data dumps for individual weather stations or access data in bulk.

## About Meteostat

Expand Down
2 changes: 1 addition & 1 deletion docs/python/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ import DocCardList from '@theme/DocCardList';

# Meteostat Python

The Meteostat Python library offers an easy and efficient way to access open weather and climate data through Pandas. It retrieves historical observations and statistics from Meteostat’s [bulk data interface](/data), which aggregates information from various public sources — primarily governmental agencies. Among Meteostat’s data providers are national weather services such as the **National Oceanic and Atmospheric Administration (NOAA)** and **Germany’s Meteorological Service (DWD)**.
The Meteostat Python library offers an easy and efficient way to access open weather and climate data through Pandas. It retrieves historical observations and statistics from Meteostat’s [data access interface](/data), which aggregates information from various public sources — primarily governmental agencies. Among Meteostat’s data providers are national weather services such as the **National Oceanic and Atmospheric Administration (NOAA)** and **Germany’s Meteorological Service (DWD)**.

## 📚 Installation

Expand Down
Loading
Loading