Skip to content

Latest commit

 

History

History
79 lines (55 loc) · 2.88 KB

README.md

File metadata and controls

79 lines (55 loc) · 2.88 KB
Raw

HSS + DarkSky Weather

Skill zur Abfrage von Wetterinformationen von DarkSky (www.darksky.net). Es sind Abfragen bis zu 7 Tage in die Zukunft möglich.

Benötigt den Hermes Skill Server (HSS).

Installation

1) DarkSky API Key

Für die Nutzung der API von DarkSky ist ein API-Key nötig, welcher kostenlos bei Registrierung erhältlich ist. Registrierung unter: https://darksky.net/dev

In der kostenlosen Version sind 1000 Aufrufe pro Tag möglich.

2) Installation des Skills im HSS

/home/s710 $> cd hss
/home/s710/hss $> source venv/bin/activate
(venv) /home/s710/hss $> hss-cli -i hss-s710-weather
Installing 'hss-s710-weather' into '/home/pi/.config/hss_server/skills/hss-s710-weather'
Cloning repository ...
Creating venv ...
Installing dependencies ...
[...]
Initializing config.ini ...
Section 'skill'
Enter value for parameter 'api_key': xxxxxx
Enter value for parameter 'homecity': Frankfurt am Main


Updating sentences ...
Sentences successfully updated
Updating slots ...
The following slots already exist: relative_time
Overwrite? (YES|no)

Slots successfully updated
Triggering traing ...
Training successful
Triggering hss-server with pid 32512 for reload

Skill 'hss-s710-weather' version 1.0.0 successfully installed.

(venv) /home/s710/hss $>

Parameter

Die App bentöigt die folgenden Parameter:

  • api_key: Der in Installation/1) erstellte API-Key von DarkSky
  • homecity: Die Stadt für die Wetter abgefragt wird, wenn kein Ort genannt wird ("Wie wird das Wetter morgen?")
  • unit: Format der Einheiten. si für SI-Einheiten (default) oder us für imperiale Einheiten
  • language: Sprache des Skills (de_DE oder en_GB)

Funktionen

Die App umfasst folgende Intents:

  • s710:getForecast - Wetterbericht für einen Zeitpunkt/Ort abfragen
  • s710:getTemperature - Temperatur für einen Zeitpunkt/Ort abfragen
  • s710:hasRain - Abfragen ob es zu einem Zeitpunkt/an einem Ort regnet/regnen wird
  • s710:hasSun - Abfragen ob es zu einem Zeitpunkt/an einem Ort sonnig ist/sonnig wird
  • s710:hasSnow - Abfragen ob es zu einem Zeitpunkt/an einem Ort schneit/schneien wird

Die Angabe des Orts und der Zeit ist optional. Ohne Angabe einer Zeit gilt "jetzt", ohne Angabe des Ortes wird homecity verwendet.

Folgende Zeitbereiche sind abfragbar:

  • aktueller Zeitpunkt ('jetzt', 'gerade', ...)
  • Zeitraum an einem Tag ('Morgen früh', 'heute Abend', 'übermorgen Nachmittag', ...)
  • einzelner Tag ('heute', 'morgen', 'Dienstag', ...)
  • Wochenende ('am Wochenende')
  • Mehrere Tage ('diese Woche', 'nächste Woche')

Bei der Abfrage von ganzen Zeitbereichen versucht die App die Wetterinformationen so gut als möglich zu beschreiben. Bei der Abfrage einzelner Tage/des aktuellen Zeitpunkts wird als Wetterbericht die Summary von DarkSky verwendet. Bei der Abfrage des Wochenendes wird die Summary von DarkSky für Samstag und Sonntag verwendet.