openmeteopy

Openmeteopy provides access to 14 different Open-Meteo APIs. Each API is accessed through a specific set of classes categorized by their temporal resolution (Hourly, Daily, etc.) and an Options class for configuration.

Note: This project is archived and no longer maintained. For official SDKs, visit open-meteo.com.

| API | Options Class | Hourly Class | Daily Class | 15 Minutes Class |
|-----|---------------|--------------|-------------|------------------|
| Weather forecast | `ForecastOptions()` | `HourlyForecast()` | `DailyForecast()` | - |
| Historical Weather | `HistoricalOptions()` | `HourlyHistorical()` | `DailyHistorical()` | - |
| ECMWF Weather Forecast | `EcmwfOptions()` | `HourlyEcmwf()` | - | - |
| GFS & HRRR Forecast | `GfsOptions()` | `HourlyGfs()` | `DailyGfs()` | - |
| MeteoFrance | `MeteoFranceOptions()` | `HourlyMeteoFrance()` | `DailyMeteoFrance()` | - |
| DWD ICON | `DwdOptions()` | `HourlyDwd()` | `DailyDwd()` | `FifteenMinutesDwd()` |
| JMA | `JmaOptions()` | `HourlyJma()` | `DailyJma()` | - |
| MET Norway | `MetnoOptions()` | `HourlyMetno()` | - | - |
| GEM | `GemOptions()` | `HourlyGem()` | `DailyGem()` | - |
| Marine Weather | `MarineOptions()` | `HourlyMarine()` | `DailyMarine()` | - |
| Air Quality | `AirQualityOptions()` | `HourlyAirQuality()` | - | - |
| Geocoding | `GeocodingOptions()` | - | - | - |
| Elevation | `ElevationOptions()` | - | - | - |
| Global Flood | `FloodOptions()` | - | `DailyForecast()` | - |

The openmeteopy.options package provides specialized option modules for various meteorological data sources, services, and environmental parameters. Developers can use these modules to configure requests or parameters specific to different providers and data types.

Available modules include:

• Air Quality: openmeteopy.options.air_quality
• Data Providers/Models:
  • openmeteopy.options.dwd (Deutscher Wetterdienst)
  • openmeteopy.options.ecmwf (European Centre for Medium-Range Weather Forecasts)
  • openmeteopy.options.gfs (Global Forecast System)
  • openmeteopy.options.jma (Japan Meteorological Agency)
  • openmeteopy.options.meteo_france
  • openmeteopy.options.metno (Norwegian Meteorological Institute)
• Environmental/Specialized Data:
  • openmeteopy.options.elevation
  • openmeteopy.options.flood
  • openmeteopy.options.gem
  • openmeteopy.options.geocoding
  • openmeteopy.options.marine
• Temporal/Forecast Types:
  • openmeteopy.options.forecast
  • openmeteopy.options.historical

You can request atmospheric variables at specific pressure levels. To do this, use a method name following the pattern: {variable}_{pressure_level}().

For example, to get temperature at 1015 hPa, use temperature_1015hpa().

Supported Pressure Levels (hPa): 10, 20, 30, 50, 100, 150, 175, 200, 225, 250, 275, 300, 350, 400, 450, 500, 550, 600, 650, 700, 750, 800, 850, 875, 900, 925, 950, 970, 985, 1000, 1015.

Available Pressure Level Variables:

• weathercode (WMO code)
• temperature_{level} (°C/°F)
• relativehumidity_{level} (%)
• dewpoint_{level} (°C/°F)
• cloudcover_{level} (%)
• windspeed_{level} (km/h, mph, m/s, knots)
• winddirection_{level} (°)
• geopotential_height_{level} (meters)

# Example: Requesting geopotential height at 600hPa
from openmeteopy import OpenMeteo
from openmeteopy.hourly import HourlyJma
from openmeteopy.options import JmaOptions

longitude = 139.817413
latitude =  35.672855

hourly = HourlyJma()
options = JmaOptions(latitude, longitude)

# Use the specific pressure level method
mgr = OpenMeteo(options, hourly.geopotential_height_600hpa())

meteo = mgr.get_pandas()
print(meteo)

To retrieve weather data, you need to define your location using ForecastOptions, select specific weather variables from HourlyForecast or DailyForecast, and then use the OpenMeteo manager to fetch the data. The manager can return the data as a Pandas DataFrame via the .get_pandas() method.

Workflow:

1. Define latitude and longitude.
2. Initialize ForecastOptions with the coordinates.
3. Instantiate HourlyForecast and DailyForecast to select desired variables.
4. Create an OpenMeteo instance passing the options and the selected variables.
5. Call .get_pandas() to download the data.

from openmeteopy import OpenMeteo
from openmeteopy.hourly import HourlyForecast
from openmeteopy.daily import DailyForecast
from openmeteopy.options import ForecastOptions

# Latitude, Longitude 
longitude = 33.89
latitude =  -6.31

hourly = HourlyForecast()
daily = DailyForecast()

options = ForecastOptions(latitude, longitude)

# Select variables (e.g., shortwave radiation for both hourly and daily)
mgr = OpenMeteo(options, hourly.shortwave_radiation(), daily.shortwave_radiation_sum())

# Download data as a Pandas DataFrame
meteo = mgr.get_pandas()

print(meteo)