open-meteo

Free Weather Forecast API for non-commercial use

https://github.com/open-meteo/open-meteo

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.4%) to scientific vocabulary

Keywords

weather weather-api weather-forecast

Keywords from Contributors

distribution interactive embedded hydrology mesh interpretability profiles sequences generic projection
Last synced: 6 months ago · JSON representation ·

Repository

Free Weather Forecast API for non-commercial use

Basic Info
  • Host: GitHub
  • Owner: open-meteo
  • License: agpl-3.0
  • Language: Swift
  • Default Branch: main
  • Homepage: https://open-meteo.com
  • Size: 11.8 MB
Statistics
  • Stars: 3,587
  • Watchers: 29
  • Forks: 241
  • Open Issues: 137
  • Releases: 23
Topics
weather weather-api weather-forecast
Created over 4 years ago · Last pushed 6 months ago
Metadata Files
Readme Funding License Citation

README.md

🌤 Open-Meteo Weather API

Test codebeat badge GitHub license license: CC BY 4.0 Twitter Mastodon DOI

Open-Meteo is an open-source weather API and offers free access for non-commercial use. No API key is required. You can use it immediately!

Head over to https://open-meteo.com! Stay up to date with our blog at https://openmeteo.substack.com.

Features

How does Open-Meteo work?

Open-Meteo utilizes open-data weather forecasts provided by national weather services. These services offer numerical weather predictions that are free to download. However, working with these models can be challenging, as it requires expertise in binary file formats, grid-systems, projections, and the fundamentals of weather predictions.

Like many other weather APIs, Open-Meteo integrates high-resolution local and global weather models. Over 2 TB of data are downloaded and processed daily from multiple national weather services. The collected data is then stored in local files using a customized file format and compression technique to enhance access to time-series data such as a 14-day temperature forecast.

In contrast to other weather APIs, Open-Meteo provides complete access to its source code, and all data sources are openly listed, crediting the national weather services for their work. With Docker or prebuilt Ubuntu packages, it is possible to launch your own weather API within minutes. By providing the source code, users can conduct detailed verifications of the weather data processing and even make modifications themselves. Contributions are highly encouraged and welcomed.

The API is available for non-commercial use at no cost. Despite being free of charge, the forecast accuracy is top-notch. The API utilizes a vast array of local weather models with rapid updates, ensuring that the most precise forecast is generated for any location globally.

Resources

  • All API documentation can be found on https://open-meteo.com. The source code for the website, documentation and API generator is available here: https://github.com/open-meteo/open-meteo-website
  • The free non-commerical API is hosted at https://api.open-meteo.com using to GeoDNS to servers in Europe and North America (HTTPS is optional). The API source code is in this current repository.
  • The geocoding API source code is available in a separate repository https://github.com/open-meteo/geocoding-api
  • Larger changes are announced in the Open-Meteo Blog
  • The Open-Meteo weather database is redistributed as part of an AWS Open-Data Sponsorship

Who is using Open-Meteo?

Apps: - Home Assistant A popular open source smart home platform. - Weather.io A simple Progressive Web App (PWA) for checking the weather. - WeatherGraph Apple Watch App - Slideshow Digital Signage app for Android - weewx-DWD Weather forecasts etc. for WeeWX - Cirrus Android Weather App - solXpect Android app which forecasts the output of your solar power plant - Raindrop Simple and intuitive weather app for the linux terminal. - Weatherian Multi-model meteogram (multi-platform) - WeatherAI WeatherAI offers an intuitive user experience that makes checking the weather a breeze. - Weather Free, open source, simple and complete weather app for Android - DroneWeather Weather forecasts, satellite count, and KP index for drone pilots. - Clima Beautiful, minimal, and fast weather app - SkyMuse Minimal, privacy-respecting weather app. Built with web technologies. - Weather Please Clean and minimal new tab replacement for browsers - QuickWeather Fast, free, and open source Android app - Rain Free, open source, beautiful, minimal and fast weather app - WetBulb A simple app that shows you the wetbulb temp 24h forecast and tells you if it is dangerous. - OSS Weather - Multi-model/multi-provider Open Source Android/iOS Weather app - The Weather A detailed, installable, progressive web application - Lively Weather Windows native weather app powered by DirectX12 animations. - PointWx Dash application with interactive plots (from beginner-friendly to weather-enthusiast level) easily deployable - MeteoHist A web app to create interactive temperature and precipitation graphs for places around the world - Emojiton Weather Get the local weather forecast for your location with fun emoji representations - Alpine Conditions Allows a user to compare multiple models at once & create ensemble forecasts for any location - Evaporative Cooler Forecaster Swamp cooler effectiveness forecast with cost & energy savings, Android/iOS app - LunaLink A site for hunters, fishermen and nature observers: It provides sun and moon values ​​(including moon brightness) as well as the weather for individual locations in Central Europe. - truthclimate Discover how weather and climate changed all around the world.

Repositories: - Captain Cold Simple Open-Meteo -> Discord integration - wthrr-the-weathercrab Weather companion for the terminal - Weather-Cli A CLI program written in golang that allows you to get weather information from the terminal - Homepage A highly customizable homepage (or startpage / application dashboard) with Docker and service API integrations. - Spots Guru Weather forecast for lazy, the best wind & wave spots around you. - WeatherReport.jl A simple weather app for the Julia REPL - DIY Arduino esp8266 weather station esp8266 weather station using Open-Meteo API, an embedded C++ implementation example - biome Bountiful Interface to Open Meteo for Emacs

Other: - Menubar Weather A Raycast extension that displays live weather information in your menu bar - MiniPavi Vintage French Minitel (a kind of BBS) weather forecast service (type "METEO" keyword on welcome Minitel screen) - OFM-InternetWeatherModule An OpenKNX module to provide data of weather services on KNX-bus (configurable via ETS)
- Contributions welcome!

Do you use Open-Meteo? Please open a pull request and add your repository or app to the list!

Client SDKs

  • Go https://github.com/HectorMalot/omgo
  • Python https://github.com/m0rp43us/openmeteopy
  • Kotlin https://github.com/open-meteo/open-meteo-api-kotlin
  • .Net / C# https://github.com/AlienDwarf/open-meteo-dotnet
  • dotnet 8 / C# https://github.com/colinnuk/open-meteo-dotnet-client-sdk
  • PHP Laravel https://github.com/michaelnabil230/laravel-weather
  • R https://github.com/tpisel/openmeteo
  • PHP Symfony 6.2 https://gitlab.com/flibidi67/open-meteo
  • PHP for Geocoding API: https://gitlab.com/flibidi67/open-meteo-geocoding
  • Android library for Geocoding API: https://github.com/woheller69/OmGeoDialog
  • Dart / Flutter: https://github.com/neursh/open-meteo-dart
  • Rust: https://github.com/angelodlfrtr/open-meteo-rs

Contributions welcome! Writing a SDK for Open-Meteo is more than welcome and a great way to help users.

Support

If you encounter bugs while using Open-Meteo APIs, please file a new issue ticket. For general ideas or Q&A please use the Discussion section on Github. Thanks!

For other enquiries please contact info@open-meteo.com

Run your own API

Instructions to use Docker to run your own weather API are available in the getting started guide.

Terms & Privacy

Open-Meteo APIs are free for open-source developer and non-commercial use. We do not restrict access, but ask for fair use.

If your application exceeds 10'000 requests per day, please contact us. We reserve the right to block applications and IP addresses that misuse our service.

For commercial use of Open-Meteo APIs, please contact us.

All data is provided as is without any warranty.

We do not collect any personal data. We do not share any personal information. We do not integrate any third party analytics, ads, beacons or plugins.

Data License

API data are offered under Attribution 4.0 International (CC BY 4.0)

You are free to share: copy and redistribute the material in any medium or format and adapt: remix, transform, and build upon the material.

Attribution: You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.

You must include a link next to any location, Open-Meteo data are displayed like:

Weather data by Open-Meteo.com

Source Code License

Open-Meteo is open-source under the GNU Affero General Public License Version 3 (AGPLv3) or any later version. You can find the license here. Exceptions are third party source-code with individual licensing in each file.

Owner

  • Name: Open-Meteo
  • Login: open-meteo
  • Kind: organization

Citation (CITATION.cff)

cff-version: 1.2.0
title: Open-Meteo.com Weather API
message: >-
  If you are using the Open-Meteo weather API, please cite
  using the following metadata
type: software
authors:
  - given-names: Patrick
    family-names: Zippenfenig
    email: patrick@zippenfenig.de
    affiliation: Open-Meteo.com
    orcid: "https://orcid.org/0009-0007-1128-7915"
identifiers:
  - type: doi
    value: 10.5281/zenodo.7970649
    description: Latest release of the Open-Meteo weather API
repository-code: 'https://github.com/open-meteo/open-meteo'
url: 'https://open-meteo.com/'
keywords:
  - weather api
  - weather forecast
  - historical weather data
  - air quality
  - ensemble prediction
  - open-data
  - IPCC climate models
  - Marine forecast
license: CC-BY-4.0
doi: 10.5281/zenodo.7970649

GitHub Events

Total
  • Create event: 128
  • Release event: 1
  • Issues event: 292
  • Watch event: 831
  • Delete event: 98
  • Member event: 1
  • Issue comment event: 450
  • Push event: 604
  • Pull request review event: 5
  • Pull request review comment event: 7
  • Pull request event: 238
  • Fork event: 65
Last Year
  • Create event: 128
  • Release event: 1
  • Issues event: 293
  • Watch event: 831
  • Delete event: 99
  • Member event: 1
  • Issue comment event: 451
  • Push event: 606
  • Pull request review event: 5
  • Pull request review comment event: 7
  • Pull request event: 240
  • Fork event: 65

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 2,155
  • Total Committers: 60
  • Avg Commits per committer: 35.917
  • Development Distribution Score (DDS): 0.094
Past Year
  • Commits: 306
  • Committers: 14
  • Avg Commits per committer: 21.857
  • Development Distribution Score (DDS): 0.114
Top Committers
Name Email Commits
patrick-zippenfenig p****k@z****e 1,953
dependabot[bot] 4****] 102
StackNeverFlow 5****w 17
woheller69 6****9 6
Terraputix t****x@m****g 5
kikocorreoso k****o 5
Will Pierce w****p@n****m 4
J-P j****r@a****m 3
Viet Dzung d****v 3
Johann Sebastian Schicho s****o@t****e 3
sokai s****i 2
KingFuWeatherAI 1****i 2
AlienDwarf 6****f 2
Alexander Bhalla x****a@g****m 2
Miguel Santos 8****e 1
Jan Kühn y****a@p****g 1
AlexeyMal 7****l 1
James Di Novo 4****o 1
Jakob Rössner j****r@o****e 1
Jacob Gillespie j****e@g****m 1
Jaap P. a****m@g****m 1
Ismael Carrea i****6@g****m 1
GustavLindberg99 9****9 1
Gus Gaidelevicius 6****s 1
Guido Cioni g****i@g****m 1
Davide Bassi 3****t 1
Daniel Glaser 7****e 1
Dani John r****r@g****m 1
Damian Soto s****o@g****m 1
Cédric Champeau c****u@g****m 1
and 30 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 617
  • Total pull requests: 819
  • Average time to close issues: about 1 month
  • Average time to close pull requests: 4 days
  • Total issue authors: 308
  • Total pull request authors: 65
  • Average comments per issue: 2.28
  • Average comments per pull request: 0.39
  • Merged pull requests: 559
  • Bot issues: 1
  • Bot pull requests: 341
Past Year
  • Issues: 212
  • Pull requests: 305
  • Average time to close issues: 6 days
  • Average time to close pull requests: 5 days
  • Issue authors: 133
  • Pull request authors: 17
  • Average comments per issue: 1.09
  • Average comments per pull request: 0.47
  • Merged pull requests: 169
  • Bot issues: 0
  • Bot pull requests: 109
Top Authors
Issue Authors
  • patrick-zippenfenig (85)
  • guidocioni (30)
  • drmrbrewer (26)
  • woheller69 (15)
  • dzungpv (9)
  • PavelSyomin (8)
  • jortaca (8)
  • leneon314 (7)
  • mafalda-dev (6)
  • owibi (5)
  • papjul (5)
  • libertykite (5)
  • daanaerts (5)
  • schicho (5)
  • farfromrefug (5)
Pull Request Authors
  • patrick-zippenfenig (352)
  • dependabot[bot] (341)
  • terraputix (23)
  • willp (7)
  • woheller69 (5)
  • schicho (5)
  • MathNerd28 (4)
  • dzungpv (4)
  • mgeramb (2)
  • RamiAwar (2)
  • sotoplatero (2)
  • ra1nb0w (2)
  • rocksdanister (2)
  • guidocioni (2)
  • 1Maxnet1 (2)
Top Labels
Issue Labels
enhancement (63) bug (34) question (7) documentation (4) dependencies (1) swift_package_manager (1)
Pull Request Labels
dependencies (341) swift_package_manager (325) github_actions (16)

Packages

  • Total packages: 1
  • Total downloads: unknown
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 270
swiftpackageindex.com: github.com/open-meteo/open-meteo

Free Weather Forecast API for non-commercial use

  • Versions: 270
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Stargazers count: 7.0%
Forks count: 11.4%
Average: 14.6%
Dependent packages count: 15.3%
Dependent repos count: 24.8%
Last synced: 6 months ago

Dependencies

.github/workflows/docker.yml actions
  • actions/checkout v2 composite
  • docker/build-push-action v4 composite
  • docker/login-action v2 composite
  • docker/metadata-action v4 composite
  • docker/setup-buildx-action v2 composite
  • docker/setup-qemu-action v2 composite
.github/workflows/release.yml actions
  • SamKirkland/FTP-Deploy-Action 4.3.0 composite
  • actions/cache v3 composite
  • actions/checkout v2 composite
  • gravitl/github-action-fpm master composite
  • ncipollo/release-action v1 composite
  • patrick-zippenfenig/apt-repo-action master composite
.github/workflows/test.yml actions
  • actions/cache v2 composite
  • actions/checkout v3 composite
Dockerfile docker
  • ghcr.io/open-meteo/docker-container-build latest build
  • ghcr.io/open-meteo/docker-container-run latest build
docker-compose.yml docker
Package.resolved swiftpm
  • github.com/apple/swift-algorithms 1.0.0
  • github.com/apple/swift-atomics 1.0.2
  • github.com/apple/swift-collections 1.0.3
  • github.com/apple/swift-crypto 2.2.1
  • github.com/apple/swift-log 1.4.4
  • github.com/apple/swift-metrics 2.3.2
  • github.com/apple/swift-nio 2.45.0
  • github.com/apple/swift-nio-extras 1.15.0
  • github.com/apple/swift-nio-http2 1.23.1
  • github.com/apple/swift-nio-ssl 2.23.0
  • github.com/apple/swift-nio-transport-services 1.15.0
  • github.com/apple/swift-numerics 1.0.2
  • github.com/google/flatbuffers 23.5.26
  • github.com/patrick-zippenfenig/SwiftEccodes 0.1.5
  • github.com/patrick-zippenfenig/SwiftNetCDF 1.1.1
  • github.com/patrick-zippenfenig/SwiftTimeZoneLookup 1.0.1
  • github.com/swift-server/async-http-client 1.13.1
  • github.com/swift-server/swift-backtrace 1.3.3
  • github.com/vapor/async-kit 1.14.0
  • github.com/vapor/console-kit 4.5.0
  • github.com/vapor/multipart-kit 4.5.2
  • github.com/vapor/routing-kit 4.6.0
  • github.com/vapor/vapor 4.67.4
  • github.com/vapor/websocket-kit 2.6.1
Package.swift swiftpm
.github/workflows/build_ubuntu.yml actions
  • actions/cache v3 composite
  • actions/checkout v4 composite
  • actions/upload-artifact v4 composite
  • gravitl/github-action-fpm master composite