# OpenMeteo

This plugin allows to get current weather and solar irradiance data from [Open-Meteo](https://open-meteo.com), including plane-of-array irradiance (GTI) for photovoltaic surfaces and satellite-observed clear-sky data.

## Usage

The data is refreshed every 15 minutes automatically, and can also be refreshed manually.

A **site** is added by entering its latitude and longitude (no discovery). It provides the shared weather and solar data for the location, including a satellite-observed GHI and clear-sky index.

One or more **PV planes** can be added as children of a site. Each plane has its own tilt, azimuth and peak power, and reports the global tilted irradiance (GTI) for that orientation. Multiple orientations are handled by adding multiple planes.

> Note: the azimuth is entered in geographic convention (180 = South, 90 = East, 270 = West).

By default the plugin queries the public Open-Meteo API. For commercial deployments, the `Base URL` and `Base URL (satellite radiation)` plugin settings can be pointed to a self-hosted Open-Meteo instance (the public API is for non-commercial use only).

## Supported Things

* Open-Meteo site (interfaces: weather, daylightsensor)
    * Weather condition
    * Temperature (current, daily min and max)
    * Humidity
    * Pressure
    * Wind speed and direction
    * Cloudiness
    * Snowfall
    * Global, direct normal and diffuse irradiance (GHI / DNI / DHI)
    * Terrestrial (top-of-atmosphere) radiation
    * Daily shortwave radiation sum
    * Satellite-observed GHI, clear-sky GHI and clear-sky index
    * Sunrise and sunset time
    * Daylight

* Open-Meteo PV plane
    * Global tilted irradiance (GTI) for the configured tilt and azimuth

## Requirements

* Internet connection, or a reachable self-hosted Open-Meteo instance
* The package 'nymea-plugin-openmeteo' must be installed
* No API key is required. For commercial use, a self-hosted instance is required (the public Open-Meteo API is non-commercial only).

## More

Open-Meteo https://open-meteo.com

Weather data by Météo-France, satellite radiation by EUMETSAT, provided through Open-Meteo (CC-BY 4.0).

For the overall architecture (role of this plugin, conventions, license boundary), see the `etm-powersync-docs` repository.