breezy-weather/docs/SOURCES.md

10 KiB
Raw Blame History

Weather sources

This is a user-end guide to weather sources available in Breezy Weather. If you are a developer looking to add a new source in Breezy Weather, have a look at contribute.

AccuWeather is the most complete source, although you may not need so much completeness (not many people care about ceiling, for example).

Open-Meteo is the only free and open source weather source on this list, and probably also the most privacy-friendly. It is nearly as complete as AccuWeather, however lacks major features (short-term forecast accuracy, alerts, realtime precipitations and reverse geocoding).

Accuracy

When deciding about which source you want to use, accuracy of data is probably the most important criteria.

Here are some suggestions based on various criteria or testimonies (you can suggest others in GitHub discussions):

Country/Continent Main source Air quality Pollen Minutely Alerts
Europe Open-Meteo
United States Forecast Advisor
France Météo-France Open-Meteo Météo-France Météo-France
Norway MET Norway MET Norway Open-Meteo MET Norway

Status

Sources Open-Meteo AccuWeather MET Norway OpenWeather Pirate Weather Météo-France China³
API key None Optional None Rate-limited¹ Rate-limited¹ Optional None
Countries Worldwide² Worldwide² Worldwide² Worldwide² Worldwide² Worldwide² China

Additional sources are available to configure but requires an API key. You can find them at the bottom of this page.

  • ¹ Bundled API key is often rate-limited. You can configure your own API key, however OpenWeather asks for credit card information even if you only want to use the free-tier.
  • ² Some features may not be available everywhere.
  • ³ Aggregated data from Beijing Meteorological Service, ColorfulClouds (Caiyun) and CNEMC

Main features

Sources Open-Meteo AccuWeather MET Norway OpenWeather Pirate Weather Météo-France China
Daily (days) 15 15 ~10 7 or 8 8 14 15
Hourly (days) 16 10 ~10 2 2 15 1
Weather
Temperature
Precipitation (RSI) (RS) (RS) (RS)
Precipitation probability (TRSI) (T) (RSI) Daily
Wind
UV
Sun & Moon & Moon phase

Note that no forecast above 7 days is reliable, so you should not decide based on the highest number of days available.

Features that can be added from other sources

The following features, if not available from your selected source, can be added from another source, starting from v4.5.0.

Sources Open-Meteo AccuWeather MET Norway OpenWeather Pirate Weather Météo-France China
Air quality Norway France (AURA) Current
Allergens Europe North America
Precipitations in next hour Nordic area France
Alerts In progress ¹

Legend:

Letter Meaning
R Rain
T Thunderstorm
S Snow
I Ice

Other weather data

Sources Open-Meteo AccuWeather MET Norway OpenWeather Pirate Weather Météo-France China
Humidity Current
Dew point Current
Pressure Current
Cloud cover
Visibility Current Current
Ceiling
Precipitation duration (RSI)
Hours of sun
Yesterday temperature

Location

Sources Open-Meteo AccuWeather MET Norway OpenWeather Pirate Weather Météo-France China
Search Default Default Default Default ³
Reverse geocoding ² ² ² ² ² ³
  • ¹ Default means it will use the configured location search source in settings. By default, it is Open-Meteo.
  • ² TimeZone is assumed to be the same as device
  • ³ TimeZone is assumed to be China

Additional sources with mandatory API key

Main features

Sources HERE
Daily (days) 6
Hourly (days) 6
Weather
Temperature
Precipitation
Precipitation probability
Wind
UV
Sun & Moon & Moon phase

Features that can be added from other sources

Sources HERE
Air quality
Allergens
Precipitations in next hour
Alerts US (NWS)

Other weather data

Sources HERE
Humidity
Dew point
Pressure
Cloud cover
Visibility
Ceiling
Precipitation duration
Hours of sun
Yesterday temperature
Search
Reverse geocoding

Combinable sources

From v4.5.0, you can combine your main weather source with other sources:

Sources Open-Meteo AccuWeather MET Norway OpenWeather Pirate Weather Météo-France ATMO AURA
Air quality Norway France (AURA)
Allergens ²
Alerts France
Minutely Nordic area France

means that its either not supported or doesnt support longitude/latitude.

  • ¹ Only supports NWS alerts, but has many duplicate issues, so not worth implementing
  • ² Not restricted but currently only works in Europe