openmeteo

An Open Meteo SDK for R

Note: openmeteo is no longer published on CRAN and is in light maintenance — it remains functional but is not actively developed. Install it from GitHub (see below).

openmeteo provides functions for accessing the Open-Meteo weather API, enabling the desired weather data or forecasts to be retrieved in a tidy data format. An API key is not required to access the Open-Meteo API.

Install from GitHub with:

# install.packages("remotes")
remotes::install_github("tpisel/openmeteo")
library(openmeteo)

Getting current weather for a location is as easy as: weather_now('tokyo')
Explore the documentation with ?openmeteo

Open-Meteo provides several API endpoints through the following functions:

Core Weather APIs

• weather_forecast() - retrieve weather forecasts for a location
• weather_history() - retrieve historical weather observations for a location
• weather_now() - simple function to return current weather for a location
• weather_variables() - retrieve a shortlist of valid forecast or historical weather variables provided

Other APIs

• geocode() - return the co-ordinates and other data for a location name
• ensemble_models() - return ensemble model forecasts for a location
• climate_forecast() - return long-range climate modelling for a location
• river_discharge() - return flow volumes for the nearest river
• marine_forecast() - return ocean conditions data for a location
• air_quality() - return air quality data for a location

Please review the API documentation at Open-Meteo.com for details regarding the data available, its types, units, and other caveats and considerations.

This package is maintained on a best-effort basis. Issues and pull requests are welcome, but may not receive a timely response.

Authentication (Optional)

Most Open-Meteo APIs can be accessed without an API key.

Users with a paid Open-Meteo subscription can authenticate by setting the OPENMETEO_API_KEY environment variable:

Sys.setenv(OPENMETEO_API_KEY = "your-api-key")

For persistent configuration, add the key to your .Renviron file:

OPENMETEO_API_KEY=your-api-key

When set, openmeteo will automatically include the API key in requests and switch to Open-Meteo commercial endpoints.

Please review Open-Meteo's Terms of Service and License for details regarding commercial and non-commercial use:

• https://open-meteo.com/en/terms
• https://open-meteo.com/en/licence