From 75f92aece39e26507f581cf081e661165f0bfaa3 Mon Sep 17 00:00:00 2001 From: Marko Oldenburg Date: Tue, 14 Oct 2025 07:35:18 +0200 Subject: [PATCH] Remove DarkSky API support from Weather module The DarkSky API support has been removed from the Weather module documentation, including its references in both English and German sections. The API documentation has been updated to exclusively focus on the OpenWeatherMap API. The changes made to `59_Weather.pm` include: - Deleted mentions of the DarkSky API in the documentation. - Updated example command snippets to reference the OpenWeatherMap API. - Version number has been incremented from v2.2.35 to v2.3.0. In addition, the version number for the OpenWeatherMap API support has been updated from v3.2.7 to v3.2.8 in the corresponding API file. These updates were necessary to streamline the module's functionality and align it with current API availability, as DarkSky has been discontinued. There are no breaking changes for existing users of the OpenWeatherMap API. --- FHEM/59_Weather.pm | 39 +++------------------- controls_Weather.txt | 8 ++--- lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm | 2 +- 3 files changed, 10 insertions(+), 39 deletions(-) diff --git a/FHEM/59_Weather.pm b/FHEM/59_Weather.pm index 3b2a855..6a1ab45 100755 --- a/FHEM/59_Weather.pm +++ b/FHEM/59_Weather.pm @@ -78,7 +78,6 @@ __END__ The Weather module works with various weather APIs: @@ -96,7 +95,7 @@ __END__ The parameters have the following meanings:
- +
APIname of the weather API, e.g. DarkSkyAPI
APIname of the weather API, e.g. OpenWeatherMapAPI
apioptionsindivual options for the chosen API
apikeykey for the chosen API
locationlocation for the weather forecast; @@ -108,7 +107,7 @@ __END__

A very simple definition is:

- define <name> Weather apikey=<DarkSkyAPISecretKey>

+ define <name> Weather apikey=<OpenWeatherMapAPISecretKey>

This uses the Dark Sky API with an individual key that you need to retrieve from the Dark Sky web site.

@@ -122,19 +121,6 @@ __END__ API-specific documentation follows.

-

Dark Sky

- - - - - -
APIDarkSkyAPI
apioptionscachemaxage:<cachemaxage>
duration - in seconds to retrieve the forecast from the cache instead from the API
location<latitude,longitude>
- geographic coordinates in degrees of the location for which the - weather is forecast; if missing, the values of the attributes - of the global device are taken, if these exist.
-

-

OpenWeatherMap

@@ -324,7 +310,7 @@ __END__ Die Parameter haben die folgende Bedeutung:
- +
APIName des Wetter-APIs, z.B. DarkSkyAPI
APIName des Wetter-APIs, z.B. OpenWeatherMapAPI
apioptionsIndividuelle Optionen für das gewählte API
apikeySchlüssel für das gewählte API
locationOrt, für den das Wetter vorhergesagt wird. @@ -338,7 +324,7 @@ __END__ Eine ganz einfache Definition ist:

- define <name> Weather apikey=<DarkSkyAPISecretKey>

+ define <name> Weather apikey=<OpenWeatherMapAPISecretKey>

Bei dieser Definition wird die API von Dark Sky verwendet mit einem individuellen Schlüssel, den man sich auf der Webseite von Dark Sky @@ -353,20 +339,6 @@ __END__ Es folgt die API-spezifische Dokumentation.

-

Dark Sky

- - - - - -
APIDarkSkyAPI
apioptionscachemaxage:<cachemaxage>
Zeitdauer in - Sekunden, innerhalb derer die Wettervorhersage nicht neu abgerufen - sondern aus dem Cache zurück geliefert wird.
location<latitude,longitude>
Geographische Breite - und Länge des Ortes in Grad, für den das Wetter vorhergesagt wird. - Bei fehlender Angabe werden die Werte aus den gleichnamigen Attributen - des global-Device genommen, sofern vorhanden.
-

-

OpenWeatherMap

@@ -539,13 +511,12 @@ __END__ "fhem-mod-device", "fhem-core", "Weather", - "DarkSky", "OpenWeatherMap", "Underground" ], "release_status": "stable", "license": "GPL_2", - "version": "v2.2.35", + "version": "v2.3.0", "author": [ "Marko Oldenburg " ], diff --git a/controls_Weather.txt b/controls_Weather.txt index e3d2e88..b20fe7e 100644 --- a/controls_Weather.txt +++ b/controls_Weather.txt @@ -1,4 +1,4 @@ -UPD 2025-02-05_05:56:41 25899 FHEM/59_Weather.pm -UPD 2025-10-14_06:51:10 34175 lib/FHEM/Core/Weather.pm -UPD 2025-10-14_07:00:04 33545 lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm -UPD 2025-10-14_07:03:17 38721 lib/FHEM/APIs/Weather/wundergroundAPI.pm +UPD 2025-10-14_07:34:42 24515 FHEM/59_Weather.pm +UPD 2025-10-14_07:20:30 34175 lib/FHEM/Core/Weather.pm +UPD 2025-10-14_07:25:36 33545 lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm +UPD 2025-10-14_07:20:30 38721 lib/FHEM/APIs/Weather/wundergroundAPI.pm diff --git a/lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm b/lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm index 88e6a39..281dd51 100644 --- a/lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm +++ b/lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm @@ -1029,7 +1029,7 @@ sub _strftimeWrapper { ], "release_status": "stable", "license": "GPL_2", - "version": "v3.2.7", + "version": "v3.2.8", "author": [ "Marko Oldenburg " ],