MeteoNetwork Weather integration for Home Assistant

Home Assistant unofficial integration for MeteoNetwork Weather current conditions

This integration adds support for retrieving the current conditions from MeteoNetwork realtime weather data of specific weather stations.

A valid Auth token for MeteoNetwork API is required. You can configure multiple MeteoNetwork weather stations to get observed weather conditions.

Tip

If the MeteoNetwork station you want to add is not under a CC-BY 4.0 license, most certainly its data will not be available through the API, so this integration will not work. However you can still use Mauro Giacomelli’s integration, which reads values directly from the station’s webpage via scraping.

Note

If you are interested in a station operated by ARPA Veneto that doesn't work with this Meteonetwork integration, you can also try the arpa-veneto-weather integration which incidentally provides better recognition of the current weather state.

This integration will set up the following platforms.

Platform	Description
weather	A Home Assistant weather entity, with current data.
sensor	A Home Assistant sensor entity, with all available sensor from the API.

Installation through HACS (Recommended Method)

If you are not familiar with HACS, or haven't installed it, I would recommend to look through the HACS documentation, before continuing.

Register davidecavestro/meteonetwork-weather as an HACS custom repository.

Manual installation

1. Create a new folder in your configuration folder (where the configuration.yaml lives) called custom_components
2. Download the latest version into the custom_components folder so that the full path from your config folder is custom_components/meteonetwork_weather/
3. Restart Home Assistant.
4. Once Home Assistant is started, from the UI go to Configuration > Integrations > Add Integrations. Search for "MeteoNetwork Weather". After selecting, it could take up to a minute.

Configuration

To add MeteoNetwork Weather to your installation, do the following:

• Go to Settings then Devices % services.

• From the Integrations tab click the ⊕ Add Integration button on the lower right corner.

• Search for MeteoNetwork Weather and click the integration.

• When loaded, there will be a configuration wizard, where you must enter:

  Parameter	Required	Default Value	Description
  Auth Token	Yes	None	The token provided by MeteoNetwork. You can generate it from the MeteoNetwork API documentation.
  Station Type	Yes	Real	Choose the type of Weather Station. Choose a real one near your home, or
  a virtual one based on latitude and longitude to get interpolated data from nearest real stations.
  Station ID (for real stations)	Yes	None	Choose the Weather Station for getting current conditions among the available ones. Check the live map or the stations list.
  Latitude (for virtual stations)	Yes	None	Virtual station latitude.
  Longitude (for virtual stations)	Yes	None	Virtual station longitude.
  Station name (for virtual stations)	Yes	None	Virtual station name.

• Complete the wizard to save your data. If all goes well you should now have a new Weather entity with data from MeteoNetwork Forecast

• Please Note: You can configure multiple instances of the Integration.

Preferences

Once you have configured a station, you can control some options from ⚙ (its Configure action):

• Expose extended sensors: Expose additional sensors, covering daily high/avg/low temperature and so on
• Expose station attributes as sensors: Expose as sensors some station attributes such as longitude, latitude, altitude, etc
• Expose JSON extra attributes for raw data: Expose JSON extra attributes for raw data
• Compute the current condition: Expose the weather state as computed from available metrics

Compute the current weather condition

Since the stations don't provide data for current sky condition, the weather state has been historically left to Unknown.

Since v0.7 this integration optionally computes the current sky condition with a best-effort approach based on available sensors:

day - sun above the horizon

it compares the actual sunlight (Global Horizontal Irradiance) with the maximum expected for the current sun position, as its elevation over the horizon and the azimuth actually reflects the latitude, the season and the time of the day.
Based on the realtime data available for solar radiation.

When available, it also uses data such as precipitation, humidity, dew point and wind speed to make the best possible estimate of the actual sky conditions.

night - sun below the horizon

we miss data about the actual night sky brightness, so we can just detect precipitation or wind.

Note

This feature is still under test, so it is disabled by default.
In order to enable it, go to Configuration > Integrations > Meteonetwork Weather.
Click on the gear on the station you are interested in.
Then choose Compute the current condition: > From sensors.

Tip

If you want to experiment - choose Compute the current condition: From sensors using custom thresholds to set custom thresholds for separately switching between clear, partly cloudy and cloudy based on solar radiance during day.

Enable Debug Logging

If logs are needed for debugging or reporting an issue, use the following configuration.yaml:

logger:
  default: error
  logs:
    custom_components.meteonetwork-weather: debug

Disclaimer

This project is not affiliated with, endorsed by, or sponsored by MeteoNetwork (Associazione MeteoNetwork OdV).

The data and information provided through this integration are sourced from the MeteoNetwork API, which is publicly available and licensed under the Creative Commons Attribution 4.0 INternational (CC BY 4.0) license unless otherwise specified.

Terms of Use

All trademarks, logos, and distinctive signs visible on MeteoNetwork's website are the property of MeteoNetwork and cannot be used without prior authorization.

Any reproduction, distribution, modification, or use of MeteoNetwork's content must attribute the source by citing "MeteoNetwork" and providing the URL: https://meteonetwork.it.

This project utilizes MeteoNetwork's data strictly within the terms of the Creative Commons Attribution 4.0 INternational license.

Limitations of Liability

MeteoNetwork disclaims all responsibility for the accuracy, completeness, and timeliness of the data provided via their API, and for any issues arising from its use. Users should refer to MeteoNetwork's official site for authoritative information.

For more details about MeteoNetwork's copyright and licensing terms, visit their website.

---