OpenMeteo¶
STABLE ETM CONSUMER
Connexion : DONNÉES PUBLIQUES — Coordonnées envoyées arrondies à 2 décimales (environ 1 km).
Prévisions météo et production solaire prévue pour votre site, via Open-Meteo.
Le plugin OpenMeteo fournit à la box les prévisions météo et solaires de votre site : météo du jour et du lendemain, et production photovoltaïque prévue pour chaque orientation de toiture. Les données viennent du service public Open-Meteo, interrogé directement par la box, sans compte ni clé d'API et sans passer par un service ETM.
Paquet : powersync-plugin-openmeteo. Cette page décrit la version 1.15.2+etm18,
publiée dans le canal stable et installée avec le paquet powersync-plugins-supported.
1. Ce que le plugin publie¶
Le plugin crée deux types d'objets :
- un site (
Open-Meteo site) : météo de l'emplacement (température, nuages, vent, humidité…), irradiance solaire prévue, lever et coucher du soleil, et une observation satellite de l'heure écoulée ; - un ou plusieurs plans PV (
Open-Meteo PV plane), rattachés au site : un par orientation de toiture. Chaque plan publie l'irradiance prévue sur ses panneaux et la production prévue qui en découle, pour l'heure courante, les 3, 6 et 12 heures à venir, le reste de la journée et le lendemain.
Le moteur d'énergie additionne les plans du site désigné et l'application affiche la courbe obtenue à côté des mesures, avec la météo heure par heure — voir Prévision de production PV.
2. Ajouter le site¶
En session administrateur, ajoutez un appareil Open-Meteo site (voir Ajouter un appareil) et renseignez :
| Champ | Contenu |
|---|---|
Latitude (required, -90 to 90), Longitude (required, -180 to 180) |
Position du site, en degrés décimaux. Obligatoires : un site sans coordonnées valides ne publie rien, et sa reconfiguration sans coordonnées est refusée. |
Elevation (m, optional) |
Altitude du site en mètres. Facultative : laissée à 0, Open-Meteo utilise l'altitude de son propre modèle de terrain. À renseigner en montagne ou en vallée encaissée, où la température prévue en dépend. |
Le site n'est pas découvert automatiquement : on le crée à la main, une fois par emplacement.
3. Ajouter les plans PV¶
Une fois le site créé, ajoutez un appareil Open-Meteo PV plane : la découverte propose un plan pour chaque site existant. Créez un plan par orientation — une toiture est-ouest donne deux plans.
| Champ | Contenu |
|---|---|
Tilt (deg, 0=horizontal) |
Inclinaison des panneaux, en degrés : 0 = à plat, 90 = vertical |
Azimuth (deg geographic, 180=South) |
Orientation, en convention géographique : 180 = sud, 90 = est, 270 = ouest |
Peak power kWp |
Puissance crête des panneaux de ce plan |
Performance ratio (declared, not learned) |
Rendement global de l'installation, déclaré par l'installateur (il n'est pas appris par la box). Laissé à 1.0, la production prévue est surestimée. |
Deux champs issus de la fiche technique des modules
complètent le plan : Power temperature coefficient (%/K, declared, not learned)
(par défaut −0,37 %/K) et NOCT (°C, declared, not learned) (par défaut 45 °C). Ils servent à corriger la production prévue
quand les modules chauffent.
Attention à l'azimut
D'autres outils comptent l'azimut à partir du sud (0 = sud). Ici, 0 est le
nord : un azimut de 0 saisi pour une toiture plein sud donne une production
prévue fortement sous-estimée.
4. Une prévision, jamais une mesure¶
Tout ce que publie ce plugin est une prévision météo convertie en production, ou une observation satellite datant d'environ une heure. Ce n'est jamais une mesure de votre installation : la production réelle se lit sur l'onduleur ou le compteur.
C'est pourquoi les grandeurs sont nommées forecast… (prévision) ou observed…
(observation satellite) : il n'existe pas de pvPower dans ce plugin, seulement
forecastPvPower.
La production prévue est calculée simplement : irradiance prévue × puissance crête × rendement déclaré. Elle ne tient pas compte de l'ombrage, de l'encrassement des panneaux ni, au niveau du plugin, de l'écrêtage de l'onduleur (le moteur applique le plafond onduleur à la somme des plans, s'il est renseigné). L'écart va donc toujours dans le même sens : la prévision est optimiste. 4 kW prévus ne sont pas 4 kW produits.
La dispersion météo publiée pour aujourd'hui et demain (en %) dit à quel point la météo elle-même est incertaine. Elle ne dit rien de la justesse de la production prévue : par grand beau temps stable, elle est faible alors que la surestimation, elle, est à son maximum.
5. Rafraîchissement et coupure internet¶
Les modèles météo ne publient pas plus souvent que cela : la prévision et
l'observation satellite sont relues toutes les heures, la dispersion toutes les
3 heures. L'action Refresh du site force les trois.
Si Open-Meteo ne répond pas, le plugin réessaie après 5 minutes, puis 10, 20, 40… sans
dépasser le rythme normal de la source, et reprend son rythme dès la première réponse.
Après 3 heures sans prévision reçue, l'état Forecast valid passe à faux.
Une coupure internet ne bloque rien : la box continue de piloter avec ses mesures, la sécurité reste assurée, et seules les prévisions se dégradent jusqu'au retour de la connexion.
6. Ce qui quitte la box¶
Pour obtenir ses prévisions, la box envoie à Open-Meteo uniquement :
- les coordonnées du site, arrondies à deux décimales (environ 1 km) : assez précises pour la météo, trop floues pour désigner une adresse ;
- l'altitude du site, si vous l'avez renseignée ;
- l'inclinaison et l'azimut de chaque plan PV.
Aucune mesure, aucune consommation et aucune donnée d'usage n'est transmise. La puissance crête et le rendement restent sur la box : la conversion en production se fait localement.
7. Usage commercial : instance Open-Meteo dédiée¶
L'API publique d'Open-Meteo est réservée à un usage non commercial. Pour un
déploiement commercial, les réglages du plugin permettent de pointer vers une instance
Open-Meteo auto-hébergée (Base URL (forecast), Base URL (satellite radiation),
Base URL (ensemble spread)) ou de renseigner une clé pour l'offre commerciale
d'Open-Meteo (API key (commercial endpoint, optional)). Sans modification, le plugin
interroge l'API publique.
8. Sources des données¶
Données météo de Météo-France, rayonnement satellite d'EUMETSAT, fournis par Open-Meteo sous licence CC-BY 4.0.
Référence¶
Libellés de l'application
Les clés et libellés ci-dessous sont ceux affichés par l'application, en anglais. Ils sont laissés tels quels pour que vous les retrouviez à l'identique à l'écran.
Fabricant : Open-Meteo
Plugin : OpenMeteo
Modèles pris en charge¶
| Modèle | Rôle | Transport | Ajout | Grandeurs |
|---|---|---|---|---|
| Open-Meteo site | weather, daylightsensor | — | Manual | 30 |
| Open-Meteo PV plane | — | — | Auto-discovery | 18 |
Détail par modèle¶
Open-Meteo site — openMeteoSite
Réglages :
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
|---|---|---|---|---|---|
name |
Name | QString | — | — | non |
latitude |
Latitude (required, -90 to 90) | double | — | 999 |
non |
longitude |
Longitude (required, -180 to 180) | double | — | 999 |
non |
elevation |
Elevation (m, optional) | double | — | 0 |
non |
Grandeurs mesurées :
| Clé | Grandeur | Type | Unité |
|---|---|---|---|
weatherDescription |
Weather description | QString | — |
weatherCondition |
Weather condition | QString | — |
updateTime |
Last update | int | UnixTime |
temperature |
Temperature | double | DegreeCelsius |
temperatureMin |
Minimum temperature (today) | double | DegreeCelsius |
temperatureMax |
Maximum temperature (today) | double | DegreeCelsius |
humidity |
Humidity | int | Percentage |
pressure |
Pressure | double | HectoPascal |
windSpeed |
Wind speed | double | MeterPerSecond |
windDirection |
Wind direction | int | Degree |
cloudiness |
Cloudiness | int | Percentage |
snowfall |
Snowfall (preceding hour) | double | CentiMeter |
forecastGhi |
GHI forecast (W/m²) | double | — |
forecastDni |
DNI forecast (W/m²) | double | — |
forecastDhi |
DHI forecast (W/m²) | double | — |
terrestrialRadiation |
TOA radiation (W/m2) | double | — |
forecastGhiSumToday |
GHI sum forecast today (kWh/m²) | double | — |
observedGhi |
GHI observed, satellite (W/m²) | double | — |
observedClearSkyGhi |
Clear-sky GHI observed, satellite (W/m²) | double | — |
observedClearSkyIndex |
Clear-sky index kt (observed) | double | — |
sunriseTime |
Sunrise time | int | UnixTime |
sunsetTime |
Sunset time | int | UnixTime |
daylight |
Daylight | bool | — |
forecastModel |
Forecast model that answered | QString | — |
forecastValid |
Forecast valid | bool | — |
forecastTendencyToday |
Sky tendency forecast today | QString | — |
observedTime |
Satellite sample time | int | UnixTime |
forecastIssuedAt |
Model run initialisation — revision key | int | UnixTime |
forecastAvailableAt |
Model run publication — informational, never a revision key | int | UnixTime |
forecastHourlyWeather |
Hourly weather forecast — series for the app, not a value | QVariantMap | — |
Open-Meteo PV plane — openMeteoPvPlane
Réglages :
| Clé | Libellé | Type | Plage | Défaut | Lecture seule |
|---|---|---|---|---|---|
name |
Name | QString | — | — | non |
tilt |
Tilt (deg, 0=horizontal) | double | 0–90 | 30 |
non |
azimuth |
Azimuth (deg geographic, 180=South) | double | 0–360 | 180 |
non |
kwp |
Peak power kWp | double | — | 0 |
non |
performanceRatio |
Performance ratio (declared, not learned) | double | 0.1–1.0 | 1.0 |
non |
tempCoeffPctPerK |
Power temperature coefficient (%/K, declared, not learned) | double | -1.0–0.0 | -0.37 |
non |
noctC |
NOCT (°C, declared, not learned) | double | 30–70 | 45 |
non |
Grandeurs mesurées :
| Clé | Grandeur | Type | Unité |
|---|---|---|---|
forecastGtiSource |
GTI forecast, source quantity (W/m²) | double | — |
updateTime |
Last update | int | UnixTime |
forecastPvPower |
PV power forecast | double | Watt |
forecastEnergyNext3h |
PV energy forecast, next 3 h (rolling, may cross midnight) | double | KiloWattHour |
forecastEnergyNext6h |
PV energy forecast, next 6 h (rolling, may cross midnight) | double | KiloWattHour |
forecastEnergyNext12h |
PV energy forecast, next 12 h (rolling, may cross midnight) | double | KiloWattHour |
forecastEnergyRestOfDay |
PV energy forecast, now until sunset | double | KiloWattHour |
forecastEnergyTomorrow |
PV energy forecast, tomorrow | double | KiloWattHour |
forecastPeakTime |
Forecast peak irradiance time today | int | UnixTime |
observedGti |
GTI observed, satellite (W/m²) | double | — |
observedGtiTime |
Satellite sample time | int | UnixTime |
observedGtiSeries |
GTI observed, satellite — hourly series, transport channel, not a value | QVariantMap | — |
forecastWeatherSpreadTodayPercent |
GTI weather spread today — qualifies weather only, not PV accuracy | double | Percentage |
forecastWeatherSpreadTomorrowPercent |
GTI weather spread tomorrow — qualifies weather only, not PV accuracy | double | Percentage |
forecastWeatherSpreadTime |
Weather spread computed at | int | UnixTime |
forecastWeatherSpreadValid |
Weather spread current (computed less than 6 h ago) | bool | — |
forecastSpreadModel |
Ensemble model used for spread | QString | — |
forecastCurveTransport |
Forecast curve — transport channel, not a value | QVariantMap | — |