breezy-weather/docs/SOURCES.md

# 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).

**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](https://forecastadvisor.com/) | | |  |              |
| 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 | ❌                  | ❌           | ❌              | ❌             | ❌       |
| **Precipitation in the next hour** | ❌          | ✅             | Nordic area        | ✅           | ✅              | France        | ✅       |
| **Alerts**                         | ❌          | ✅             | *In progress*      | ✅¹          | ✅              | ✅             | ✅       |

* ¹ List of available countries: https://openweathermap.org/api/push-weather-alerts#listsource

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**           | ✅          | ✅           | ✅          | ✅           | ✅              | ✅            | ✅       |
| **Normals**                | Average¹   | ✅           | Average¹   | Average¹    | Average¹        | ✅            | Average¹ |

¹ Median from daily forecast


## 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**                      | ❌        |
| **Precipitation in the 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**                      | ✅²         | ❌           | ❌           | ❌          | ❌              | ❌            | ❌            |
| **Precipitation in the next hour** | ❌          | ✅           | Nordic area | ✅          | ✅              | France       | ❌             |
| **Alerts**                         | ❌          | ✅           | ❌           | ✅          | ✅              | France       | ❌             |
| **Normals**                        | ❌          | ❌           | ❌           | ❌          | ❌              | ✅³           | ❌             |

❌ means that it’s either not supported or doesn’t support longitude/latitude.

* ¹ Only supports NWS alerts, but has many duplicate issues, so not worth implementing
* ² Not restricted but currently only works in Europe
* ³ Implemented but it is not yet possible to change secondary normals source for a location from UI
-												Clean up SOURCES.md document + prefer source term over provider

											
										
										
											2023-07-22 23:26:54 +02:00
+								# 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).
-												Secondary weather source implementation almost complete

											
										
										
											2023-08-01 20:44:08 +02:00
+								**AccuWeather** is the most complete source, although you may not need so much completeness (not many people care about ceiling, for example).
-												Clean up SOURCES.md document + prefer source term over provider

											
										
										
											2023-07-22 23:26:54 +02:00
-												Secondary weather source implementation almost complete

											
										
										
											2023-08-01 20:44:08 +02:00
+								**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).
-												Clean up SOURCES.md document + prefer source term over provider

											
										
										
											2023-07-22 23:26:54 +02:00
-												Add more accuracy suggestions

											
										
										
											2023-07-31 22:21:41 +02:00
+								## 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](https://forecastadvisor.com/) | | |  |              |
 								| France            | Météo-France |             | Open-Meteo  | Météo-France | Météo-France |
-												Oops, wrong copy/paste

											
										
										
											2023-07-31 22:22:43 +02:00
+								| Norway            | MET Norway   | MET Norway  | Open-Meteo  | MET Norway   |              |
-												Add more accuracy suggestions

											
										
										
											2023-07-31 22:21:41 +02:00
-												Clean up SOURCES.md document + prefer source term over provider

											
										
										
											2023-07-22 23:26:54 +02:00
 								## Status
-												Integrate new weather source

											
										
										
											2023-07-27 23:20:16 +02:00
+								| 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  |
-												Clean up SOURCES.md document + prefer source term over provider

											
										
										
											2023-07-22 23:26:54 +02:00
-												Add more accuracy suggestions

											
										
										
											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.
-												Clean up SOURCES.md document + prefer source term over provider

											
										
										
											2023-07-22 23:26:54 +02:00
+								* ¹ 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
-												Integrate new weather source

											
										
										
											2023-07-27 23:20:16 +02:00
+								| 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       |
-												[MET No] Add weather texts

											
										
										
											2023-08-05 13:50:25 +02:00
+								| **Weather**                     | ✅          | ✅             | ✅                 | ✅           | ✅              | ✅             | ✅       |
-												Integrate new weather source

											
										
										
											2023-07-27 23:20:16 +02:00
+								| **Temperature**                 | ✅          | ✅             | ✅                  | ✅           | ✅              | ✅             | ✅       |
 								| **Precipitation**               | ✅          | ✅ (RSI)       | ✅                  | ✅ (RS)      | ✅ (RS)         | ✅ (RS)        | ❌       |
 								| **Precipitation probability**   | ✅          | ✅ (TRSI)      | ✅ (T)              | ✅           | ✅              | ✅ (RSI)       | Daily   |
 								| **Wind**                        | ✅          | ✅             | ✅                  | ✅           | ✅              | ✅             | ✅       |
-												Secondary weather source implementation almost complete

											
										
										
											2023-08-01 20:44:08 +02:00
+								| **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.
-												Fix #18 - Implement temperature normals

											
										
										
											2023-08-14 19:54:25 +02:00
+								| Sources                            | Open-Meteo | AccuWeather   | MET Norway         | OpenWeather | Pirate Weather | Météo-France  | China   |
 								|------------------------------------|------------|---------------|--------------------|-------------|----------------|---------------|---------|
 								| **Air quality**                    | ✅          | ✅             | Norway             | ✅           | ❌              | France (AURA) | Current |
 								| **Allergens**                      | Europe     | North America | ❌                  | ❌           | ❌              | ❌             | ❌       |
 								| **Precipitation in the next hour** | ❌          | ✅             | Nordic area        | ✅           | ✅              | France        | ✅       |
 								| **Alerts**                         | ❌          | ✅             | *In progress*      | ✅¹          | ✅              | ✅             | ✅       |
-												Clean up SOURCES.md document + prefer source term over provider

											
										
										
											2023-07-22 23:26:54 +02:00
 								* ¹ List of available countries: https://openweathermap.org/api/push-weather-alerts#listsource
 								Legend:
 								| Letter | Meaning      |
 								|--------|--------------|
 								| R      | Rain         |
 								| T      | Thunderstorm |
 								| S      | Snow         |
 								| I      | Ice          |
 								## Other weather data
-												Integrate new weather source

											
										
										
											2023-07-27 23:20:16 +02:00
+								| 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**           | ✅          | ✅           | ✅          | ✅           | ✅              | ✅            | ✅       |
-												Fix #18 - Implement temperature normals

											
										
										
											2023-08-14 19:54:25 +02:00
+								| **Normals**                | Average¹   | ✅           | Average¹   | Average¹    | Average¹        | ✅            | Average¹ |
 								¹ Median from daily forecast
-												Clean up SOURCES.md document + prefer source term over provider

											
										
										
											2023-07-22 23:26:54 +02:00
 								## Location
-												Integrate new weather source

											
										
										
											2023-07-27 23:20:16 +02:00
+								| Sources               | Open-Meteo | AccuWeather | MET Norway     | OpenWeather    | Pirate Weather | Météo-France   | China |
 								|-----------------------|------------|-------------|----------------|----------------|----------------|----------------|-------|
-												IP.SB + GeoNames + complete 2ndary sources + Privacy policy
Fix #89 - Complete weather data from one provider with another
Fix #283 - Allow customize location search source + add GeoNames
Fix #249 - Add IP.SB as alternative location service
Add Privacy policy activity in About

											
										
										
											2023-08-02 20:49:37 +02:00
+								| **Search**            | ✅          | ✅           | Default       | Default        | Default        | Default        | ✅³    |
 								| **Reverse geocoding** | ❌²         | ✅           | ❌²             | ❌²             | ❌²             | ✅²             | ✅³    |
-												Clean up SOURCES.md document + prefer source term over provider

											
										
										
											2023-07-22 23:26:54 +02:00
-												IP.SB + GeoNames + complete 2ndary sources + Privacy policy
Fix #89 - Complete weather data from one provider with another
Fix #283 - Allow customize location search source + add GeoNames
Fix #249 - Add IP.SB as alternative location service
Add Privacy policy activity in About

											
										
										
											2023-08-02 20:49:37 +02:00
+								* ¹ Default means it will use the configured location search source in settings. By default, it is Open-Meteo.
-												Clean up SOURCES.md document + prefer source term over provider

											
										
										
											2023-07-22 23:26:54 +02:00
+								* ² TimeZone is assumed to be the same as device
-												IP.SB + GeoNames + complete 2ndary sources + Privacy policy
Fix #89 - Complete weather data from one provider with another
Fix #283 - Allow customize location search source + add GeoNames
Fix #249 - Add IP.SB as alternative location service
Add Privacy policy activity in About

											
										
										
											2023-08-02 20:49:37 +02:00
+								* ³ TimeZone is assumed to be China
-												Integrate new source

											
										
										
											2023-07-29 09:58:27 +02:00
 								# Additional sources with mandatory API key
-												Secondary weather source implementation almost complete

											
										
										
											2023-08-01 20:44:08 +02:00
+								## Main features
-												Remove MS Azure (not compliant)

											
										
										
											2023-08-04 08:37:18 +02:00
+								| Sources                         | HERE     |
 								|---------------------------------|----------|
 								| **Daily (days)**                | 6        |
 								| **Hourly (days)**               | 6        |
 								| **Weather**                     | ✅        |
 								| **Temperature**                 | ✅        |
 								| **Precipitation**               | ✅        |
 								| **Precipitation probability**   | ✅        |
 								| **Wind**                        | ✅        |
 								| **UV**                          | ✅        |
 								| **Sun & Moon & Moon phase**     | ✅        |
-												Secondary weather source implementation almost complete

											
										
										
											2023-08-01 20:44:08 +02:00
 								## Features that can be added from other sources
-												Fix #18 - Implement temperature normals

											
										
										
											2023-08-14 19:54:25 +02:00
+								| Sources                            | HERE     |
 								|------------------------------------|----------|
 								| **Air quality**                    | ❌        |
 								| **Allergens**                      | ❌        |
 								| **Precipitation in the next hour** | ❌        |
 								| **Alerts**                         | US (NWS) |
-												Secondary weather source implementation almost complete

											
										
										
											2023-08-01 20:44:08 +02:00
 								## Other weather data
-												Remove MS Azure (not compliant)

											
										
										
											2023-08-04 08:37:18 +02:00
+								| Sources                         | HERE     |
 								|---------------------------------|----------|
 								| **Humidity**                    | ✅        |
 								| **Dew point**                   | ✅        |
 								| **Pressure**                    | ✅        |
 								| **Cloud cover**                 | ❌        |
 								| **Visibility**                  | ✅        |
 								| **Ceiling**                     | ❌        |
 								| **Precipitation duration**      | ❌        |
 								| **Hours of sun**                | ✅        |
 								| **Yesterday temperature**       | ❌        |
 								| **Search**                      | ✅        |
 								| **Reverse geocoding**           | ✅        |
-												Secondary weather source implementation almost complete

											
										
										
											2023-08-01 20:44:08 +02:00
 								# Combinable sources
 								From v4.5.0, you can combine your main weather source with other sources:
-												Fix #18 - Implement temperature normals

											
										
										
											2023-08-14 19:54:25 +02:00
+								| Sources                            | Open-Meteo | AccuWeather | MET Norway  | OpenWeather | Pirate Weather | Météo-France | ATMO AURA      |
 								|------------------------------------|------------|-------------|-------------|-------------|----------------|--------------|----------------|
 								| **Air quality**                    | ✅          | ❌           | Norway      | ✅          | ❌              | ❌           | France (AURA) |
 								| **Allergens**                      | ✅²         | ❌           | ❌           | ❌          | ❌              | ❌            | ❌            |
 								| **Precipitation in the next hour** | ❌          | ✅           | Nordic area | ✅          | ✅              | France       | ❌             |
 								| **Alerts**                         | ❌          | ✅           | ❌           | ✅          | ✅              | France       | ❌             |
 								| **Normals**                        | ❌          | ❌           | ❌           | ❌          | ❌              | ✅³           | ❌             |
-												Secondary weather source implementation almost complete

											
										
										
											2023-08-01 20:44:08 +02:00
 								❌ means that it’s either not supported or doesn’t support longitude/latitude.
-												IP.SB + GeoNames + complete 2ndary sources + Privacy policy
Fix #89 - Complete weather data from one provider with another
Fix #283 - Allow customize location search source + add GeoNames
Fix #249 - Add IP.SB as alternative location service
Add Privacy policy activity in About

											
										
										
											2023-08-02 20:49:37 +02:00
+								* ¹ Only supports NWS alerts, but has many duplicate issues, so not worth implementing
-												Fix #18 - Implement temperature normals

											
										
										
											2023-08-14 19:54:25 +02:00
+								* ² Not restricted but currently only works in Europe
 								* ³ Implemented but it is not yet possible to change secondary normals source for a location from UI