breezy-weather/docs/SOURCES.md

204 lines
14 KiB
Markdown
Raw Normal View 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](../CONTRIBUTE.md).
2024-03-02 15:08:02 +01:00
By default, when you add a location manually, Breezy Weather will auto-suggest your national weather source if we have support for it, and combine it with other secondary weather sources for missing features.
2024-03-02 15:08:02 +01:00
When we dont have support for your national weather source, we suggest **Open-Meteo** which 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**, and usually more accurate for many countries, however still lacks a few features (station observations, alerts, reverse geocoding), which is why AccuWeather is also suggested for alerts and normals for some countries.
2024-03-02 15:08:02 +01:00
Below, you can find details about the support and implementation status for features on each weather source.
2023-07-31 22:21:41 +02:00
## Status
2024-02-09 23:02:53 +01:00
| Sources | Open-Meteo | AccuWeather | MET Norway | OpenWeather | Pirate Weather | Météo-France | DMI |
|---------------|------------|-------------|------------|---------------|----------------|--------------|-----------|
| **API key** | None | Optional | None | Rate-limited¹ | Rate-limited¹ | Optional | None |
| **Countries** | Worldwide² | Worldwide² | Worldwide² | Worldwide² | Worldwide² | Worldwide² | Worldwide |
| Sources | China³ | NWS | Bright Sky | ECCC | SMHI | MET Éireann |
|---------------|--------|------|------------|--------|--------|-------------|
| **API key** | None | None | None | None | None | None |
| **Countries** | China | USA | Germany | Canada | Sweden | Ireland |
2023-07-31 22:21:41 +02:00
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 supported by each source
2024-02-09 23:02:53 +01:00
| Sources | Open-Meteo | AccuWeather | MET Norway | OpenWeather | Météo-France | DMI |
|-------------------------------|------------|-------------|------------|-------------|--------------|-----|
| **Daily (days)** | 15 | 15 | ~10 | 7 or 8 | 14 | 10 |
| **Hourly (days)** | 16 | 10 | ~10 | 2 | 15 | 10 |
| **Weather** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Temperature** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Precipitation** | ✅ | ✅ (RSI) | ✅ | ✅ (RS) | ✅ (RS) | ✅ |
| **Precipitation probability** | ✅ | ✅ (TRSI) | ✅ (T) | ✅ | ✅ (RSI) | ❌ |
| **Wind** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **UV** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| **Sun & Moon & Moon phase** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
2024-02-12 18:11:54 +01:00
| Sources | China | NWS | Bright Sky | ECCC | SMHI | MET Éireann |
|-------------------------------|-------|--------|------------|------|------|-------------|
| **Daily (days)** | 15 | 7 | 10 | 6 | 15 | 7 |
| **Hourly (days)** | 1 | 7 | 10 | 1 | 15 | 7 |
| **Weather** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Temperature** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Precipitation** | ❌ | ✅ (SI) | ✅ | ❌ | ✅ | ✅ |
| **Precipitation probability** | Daily | ✅ (T) | ✅ | ✅ | T | ❌ |
| **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
2023-08-25 18:53:26 +02:00
The following features, if not available from your selected source, can be added from another source.
2024-02-09 23:24:37 +01:00
| Sources | Open-Meteo | AccuWeather | MET Norway | OpenWeather | Météo-France | DMI |
|------------------------------------|------------|---------------|---------------|-------------|--------------|---------|
| **Air quality** | ✅ | ✅ | Norway | ✅ | ❌ | ❌ |
| **Pollen** | ✅ | North America | ❌ | ❌ | ❌ | ❌ |
2024-02-09 23:24:37 +01:00
| **Precipitation in the next hour** | ✅² | ✅ | Nordic area | ✅ | France | ❌ |
| **Alerts** | ❌ | ✅ | *In progress* | ✅¹ | France | Denmark |
2024-02-09 23:24:37 +01:00
| **Normals** | Average | ✅ | Average | Average | ✅ | Average |
2024-02-09 23:02:53 +01:00
2024-03-02 15:42:46 +01:00
| Sources | China | NWS | Bright Sky | ECCC | SMHI | MET Éireann |
|------------------------------------|---------|---------|------------|------|---------|-------------|
| **Air quality** | Current | ❌ | ❌ | ❌ | ❌ | ❌ |
| **Pollen** | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| **Precipitation in the next hour** | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| **Alerts** | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ |
| **Normals** | Average | Average | Average | ✅ | Average | Average |
* ¹ List of available countries: https://openweathermap.org/api/push-weather-alerts#listsource
2023-08-23 20:38:32 +02:00
* ² Works best in Europe at the moment
Legend:
| Letter | Meaning |
|--------|--------------|
| R | Rain |
| T | Thunderstorm |
| S | Snow |
| I | Ice |
## Other weather data
2024-02-09 23:02:53 +01:00
| Sources | Open-Meteo | AccuWeather | MET Norway | OpenWeather | Météo-France | DMI |
|----------------------------|------------|-------------|------------|-------------|--------------|-----|
| **Humidity** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Dew point** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Pressure** | ✅ | Current | ✅ | ✅ | ✅ | ✅ |
| **Cloud cover** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| **Visibility** | ✅ | ✅ | ❌ | ✅ | ❌ | ✅ |
| **Ceiling** | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
| **Precipitation duration** | ❌ | ✅ (RSI) | ❌ | ❌ | ❌ | ❌ |
| **Hours of sun** | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| Sources | China | NWS | Bright Sky | ECCC | SMHI | MET Éireann |
|----------------------------|---------|-----|------------|---------|------|-------------|
| **Humidity** | Current | ✅ | ✅ | Current | ✅ | ✅ |
| **Dew point** | Current | ✅ | ✅ | Current | ✅ | ✅ |
2024-02-12 18:11:54 +01:00
| **Pressure** | ❌ | ✅ | ✅ | Current | ✅ | ✅ |
| **Cloud cover** | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ |
| **Visibility** | Current | ✅ | ✅ | Current | ✅ | ❌ |
2024-02-09 23:02:53 +01:00
| **Ceiling** | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| **Precipitation duration** | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| **Hours of sun** | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
¹ Median from daily forecast
## Location
2024-02-09 23:02:53 +01:00
| Sources | Open-Meteo | AccuWeather | MET Norway | OpenWeather | Météo-France | DMI |
|-----------------------|------------|-------------|------------|-------------|--------------|---------|
| **Search** | ✅ | ✅ | Default | Default | Default | Default |
| **Reverse geocoding** | ❌² | ✅ | ❌² | ❌² | ✅² | ✅ |
| Sources | China | NWS | Bright Sky | ECCC | SMHI | MET Éireann |
|-----------------------|-------|---------|------------|---------|---------|-------------|
| **Search** | ✅³ | Default | Default | Default | Default | Default |
2024-03-02 15:08:02 +01:00
| **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
2024-03-02 15:08:02 +01:00
* ³ TimeZone is assumed to be Asia/Shanghai
* ⁴ TimeZone is assumed to be Europe/Dublin
2023-07-29 09:58:27 +02:00
# Additional sources with mandatory API key
## Main features
2023-08-25 18:53:26 +02:00
| Sources | Pirate Weather | HERE |
|---------------------------------|----------------|----------|
| **Daily (days)** | 8 | 6 |
| **Hourly (days)** | 2 | 6 |
| **Weather** | ✅ | ✅ |
| **Temperature** | ✅ | ✅ |
| **Precipitation** | ✅ (RS) | ✅ |
| **Precipitation probability** | ✅ | ✅ |
| **Wind** | ✅ | ✅ |
| **UV** | ✅ | ✅ |
| **Sun & Moon & Moon phase** | ✅ | ✅ |
## Features that can be added from other sources
2023-08-25 18:53:26 +02:00
| Sources | Pirate Weather | HERE |
|------------------------------------|----------------|----------|
| **Air quality** | ❌ | ❌ |
2023-08-26 08:59:20 +02:00
| **Pollen** | ❌ | ❌ |
2023-08-25 18:53:26 +02:00
| **Precipitation in the next hour** | ✅ | ❌ |
| **Alerts** | ✅ | ❌ |
2023-08-25 19:46:34 +02:00
| **Normals** | Average¹ | Average¹ |
¹ Median from daily forecast
## Other weather data
2023-08-25 18:53:26 +02:00
| Sources | Pirate Weather | HERE |
|---------------------------------|----------------|----------|
| **Humidity** | ✅ | ✅ |
| **Dew point** | ✅ | ✅ |
| **Pressure** | ✅ | ✅ |
| **Cloud cover** | ✅ | ❌ |
| **Visibility** | Current | ✅ |
| **Ceiling** | ❌ | ❌ |
| **Precipitation duration** | ❌ | ❌ |
| **Hours of sun** | ✅ | ✅ |
| **Search** | Default | ✅ |
2023-08-25 19:46:34 +02:00
| **Reverse geocoding** | ❌¹ | ✅ |
* ¹ TimeZone is assumed to be the same as device
# Combinable sources
2024-02-09 23:02:53 +01:00
| Sources | Open-Meteo | AccuWeather | MET Norway | OpenWeather | Pirate Weather | Météo-France | DMI |
|------------------------------------|------------|-------------|-------------|-------------|----------------|--------------|---------------|
| **Air quality** | ✅ | ✅ | Norway | ✅ | ❌ | ❌ | ❌ |
| **Pollen** | ✅² | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| **Precipitation in the next hour** | ✅³ | ✅ | Nordic area | ✅ | ✅ | France | ❌ |
| **Alerts** | ❌ | ✅ | ❌ | ✅ | ✅ | France | *In progress* |
| **Normals** | ❌ | ✅ | ❌ | ❌ | ❌ | ✅⁴ | ❌ |
| Sources | China | NWS | Bright Sky | ECCC | MET Éireann | ATMO AURA |
|------------------------------------|-------|-----|------------|--------|---------------|---------------|
| **Air quality** | China | ❌ | ❌ | ❌ | ❌ | France (AuRA) |
| **Pollen** | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| **Precipitation in the next hour** | China | ❌ | ❌ | ❌ | ❌ | ❌ |
| **Alerts** | China | ✅ | Germany | Canada | *In progress* | ❌ |
| **Normals** | ❌ | ❌ | ❌ | Canada | ❌ | ❌ |
* ¹ Only supports NWS alerts, but has many duplicate issues, so not worth implementing
* ² Not restricted but currently only works in Europe
* ³ Works best in Europe at the moment