/IPSymconOpenWeatherMap

Access to API of OpenWeatherMap

Primary LanguagePHP

IPSymconOpenWeatherMap

IPS-Version Module-Version Code License StyleCI

Dokumentation

Inhaltsverzeichnis

  1. Funktionsumfang
  2. Voraussetzungen
  3. Installation
  4. Funktionsreferenz
  5. Konfiguration
  6. Anhang
  7. Versions-Historie

1. Funktionsumfang

OpenWeatherMap (https://openweathermap.org) ist eine Web-Seite, die Wetterdaten bereit stellt. Es gibt eine API, die sowohl einen kostenlosen Zugriff erlaubt als auch komerzielle Angebote beinhaltet.

Das Modul behandelt nur die kostenlosen Zugriffe.

OpenWeatherData:

  • aktuellen Daten (Current weather data)
  • stündlichen Vorhersagen (5 day / 3 hour forecast)

OpenWeatherStation:

  • Übertragng von Daten einer lokalen Wetterstation an OpenWeather

2. Voraussetzungen

  • IP-Symcon ab Version 5

3. Installation

Die Konsole von IP-Symcon öffnen. Im Objektbaum unter Kerninstanzen die Instanz Modules durch einen doppelten Mausklick öffnen.

In der Modules Instanz rechts oben auf den Button Hinzufügen drücken.

In dem sich öffnenden Fenster folgende URL hinzufügen:

https://github.com/demel42/IPSymconOpenWeatherMap.git

und mit OK bestätigen.

Anschließend erscheint ein Eintrag für das Modul in der Liste der Instanz Modules

Anmeldung bei OpenWeatherMap

Man muss hier (https://home.openweathermap.org/users/sign_up) einen Account erstellen. Nach erfolgter Anmeldung kann man in dem Punkt API keys einen API-Key erzeugen bzw. diese verwalten.

Einrichtung in IPS

siehe OpenWeatherData und OpenWeatherStation

4. Funktionsreferenz

siehe OpenWeatherData und OpenWeatherStation

5. Konfiguration

siehe OpenWeatherData und OpenWeatherStation

6. Anhang

GUIDs

  • Modul: {BCAEF996-FC2B-420D-A801-5C0B4A021225}
  • Instanzen:
    • OpenWeatherData: {8072158E-53BF-482A-B925-F4FBE522CEF2}
    • OpenWeatherStation: {604AD7FF-7883-47E7-A2A8-0C6D3C343BE9}

Verweise:

7. Versions-Historie

  • 1.9 @ 04.11.2018 17:36

    • offizielle defines der Status-Codes verwendet sowie eigenen Status-Codes relativ zu IS_EBASE angelegt

  • 1.8 @ 28.10.2018 09:23

    • OpenWeatherStation dazu

  • 1.7 @ 13.10.2018 17:52

    • Umstellung der internen Speicherung zur Vermeidung der Warnung Puffer > 8kb.

  • 1.6 @ 12.10.2018 19:29

    • Bugfix: z.T. fehlende Suffixe bei Vorhersage-Variablen, falsche Windgeschwindigkeit in der HTML-Darstellung
    • in der HTML-Darstellung wird die WIndgeschwindigkeit ohne Nachkommastellen ausgegeben

  • 1.5 @ 11.10.2018 18:08

    • ConditionIcons und ConditionIds (Plural) ersetzt durch ConditionIcon und ConditionId (Singular). Es wird nur noch der wichtigste Eintrag gespeichert - laut OpenWeatherMap ist das jeweils der erste Eintrag.
    • zusätzliche temporäre Ablage der Originaldaten in internen Buffern und Funktion zum Abruf der Daten (OpenWeatherMap_GetRawData())

  • 1.4 @ 10.10.2018 15:27

    • optionale Übernahme der Ids der Wetterbedingungen

  • 1.3 @ 09.10.2018 17:38

    • optische Aufbereitung der Wetterinformationen

  • 1.2 @ 08.10.2018 22:21

    • Korrektur des Zugriffs auf Location

  • 1.1 @ 07.10.2018 10:27

    • Sprache der texuellen Informationen per Konfigurationsdialog einstellbar
    • Angabe der Einheiten bestimmer Felder im Konfigurationsdialog

  • 1.0 @ 25.09.2018 17:35
    Initiale Version