Open-Meteo Python Library

Warnings

• breaking The `.close()` method was removed from client objects in `v1.7.0`.
  Fix: Remove any explicit calls to `.close()` on `openmeteo_requests.Client` instances. The client automatically manages sessions or does not require explicit closing.
• gotcha Data from the FlatBuffers response objects must be accessed using function calls (e.g., `response.Latitude()`) rather than direct attribute access (e.g., `response.Latitude`).
  Fix: Always use parentheses `()` when accessing properties on response objects (e.g., `response.Attribute()`, `hourly_data.Value()`). This is due to the FlatBuffers format and is necessary for dynamic data retrieval without expensive parsing. Consult the examples for correct usage.
• gotcha The `openmeteo-requests` library works with `openmeteo-sdk`. You need to install `openmeteo-sdk` separately to properly work with `Variable` enums and fully process the FlatBuffers responses.
  Fix: Ensure `pip install openmeteo-sdk` is run alongside `pip install openmeteo-requests`. Import `Variable` from `openmeteo_sdk.Variable` as shown in the quickstart.

Install

• pip install openmeteo-requests Install latest version

Imports

• Client
  wrong:

  from openmeteo_requests import Client

  correct:

  import openmeteo_requests
  om = openmeteo_requests.Client()

  The primary client class is typically accessed via the top-level package import.
• Variable

  from openmeteo_sdk.Variable import Variable

  The Variable enum is part of the `openmeteo-sdk` package, not `openmeteo-requests` directly. It is used for filtering and identifying specific weather variables in the FlatBuffers response.

Quickstart

This quickstart initializes the Open-Meteo client, defines weather parameters for a specific location (Berlin), and fetches current and hourly forecast data. It then demonstrates how to access the FlatBuffers-encoded data, specifically extracting current temperature and relative humidity. Note that Open-Meteo's API generally does not require an API key for non-commercial use.

import openmeteo_requests
from openmeteo_sdk.Variable import Variable

# Initialize the Open-Meteo API client
om = openmeteo_requests.Client()

# Define parameters for the weather request
params = {
    "latitude": 52.52,
    "longitude": 13.41,
    "hourly": ["temperature_2m", "precipitation", "wind_speed_10m"],
    "current": ["temperature_2m", "relative_humidity_2m"],
    "timezone": "Europe/Berlin"
}

# Make the API call
url = "https://api.open-meteo.com/v1/forecast"
responses = om.weather_api(url, params=params)

# Process the first location's response (assuming single location for brevity)
response = responses[0]

print(f"Coordinates: {response.Latitude()}°N {response.Longitude()}°E")
print(f"Elevation: {response.Elevation()} m asl")
print(f"Timezone: {response.Timezone()} {response.TimezoneAbbreviation()}")
print(f"Timezone difference to GMT+0: {response.UtcOffsetSeconds()} s")

# Access current weather data
current = response.Current()
current_variables = list(map(lambda i: current.Variables(i), range(0, current.VariablesLength())))

current_temperature_2m = next(filter(lambda x: x.Variable() == Variable.temperature and x.Altitude() == 2, current_variables))
current_relative_humidity_2m = next(filter(lambda x: x.Variable() == Variable.relative_humidity and x.Altitude() == 2, current_variables))

print(f"Current time: {current.Time()}")
print(f"Current temperature_2m: {current_temperature_2m.Value()} °C")
print(f"Current relative_humidity_2m: {current_relative_humidity_2m.Value()} %")