weather-forecast
Bloczek weather-forecast udostępnia 3-dniową prognozę pogody dla domyślnej lokalizacji ustawionej w systemie. Na wyjściach zwraca kategorię pogody oraz temperaturę minimalną i maksymalną na dzisiaj, jutro i pojutrze.
Parametry konfiguracyjne
| Nazwa parametru | Wartość |
|---|---|
Interwał odświeżania (refresh_interval_hours) |
Obowiązkowa wartość określająca, co ile godzin prognoza ma być odświeżana. Dozwolone wartości: 3, 6, 9, 12. |
Obsługa wejścia
Bloczek weather-forecast nie posiada wejść.
Wyjścia bloczka
| Numer i nazwa wyjścia | Opis wyjścia |
|---|---|
| 1. Prognoza dzisiaj. | Liczbowa kategoria pogody dla dnia dzisiejszego. |
| 2. Temperatura minimalna dzisiaj. | Minimalna temperatura prognozowana na dzisiaj, z dokładnością do 0.1°C. |
| 3. Temperatura maksymalna dzisiaj. | Maksymalna temperatura prognozowana na dzisiaj, z dokładnością do 0.1°C. |
| 4. Prognoza jutro. | Liczbowa kategoria pogody dla jutra. |
| 5. Temperatura minimalna jutro. | Minimalna temperatura prognozowana na jutro, z dokładnością do 0.1°C. |
| 6. Temperatura maksymalna jutro. | Maksymalna temperatura prognozowana na jutro, z dokładnością do 0.1°C. |
| 7. Prognoza pojutrze. | Liczbowa kategoria pogody na pojutrze. |
| 8. Temperatura minimalna pojutrze. | Minimalna temperatura prognozowana na pojutrze, z dokładnością do 0.1°C. |
| 9. Temperatura maksymalna pojutrze. | Maksymalna temperatura prognozowana na pojutrze, z dokładnością do 0.1°C. |
Kategorie prognozy
Większa wartość oznacza gorszą pogodę, co pozwala używać kategorii w prostych porównaniach.
| Wartość | Kategoria |
|---|---|
0 |
nieznana |
1 |
bezchmurnie |
2 |
częściowe zachmurzenie |
3 |
pochmurno |
4 |
całkowite zachmurzenie |
5 |
mgła |
6 |
mżawka |
7 |
deszcz |
8 |
przelotny deszcz |
9 |
deszcz ze śniegiem |
10 |
śnieg |
11 |
oblodzenie |
12 |
burza |
Wartości null
Wszystkie wyjścia zwracają null, gdy lokalizacja systemowa jest niedostępna albo gdy prognoza dla bieżącej lokalizacji nie jest jeszcze dostępna.
Jeżeli prognoza dla dzisiaj jest dostępna, ale brakuje danych na jutro albo pojutrze, null jest zwracane tylko na wyjściach brakującego dnia.
Temperatury są zaokrąglane do jednej cyfry po przecinku.
Błędy zwracane przez bloczek
| Komunikat | Znaczenie |
|---|---|
Invalid refresh interval configuration. |
Parametr refresh_interval_hours jest pusty, nie jest liczbą całkowitą albo ma wartość inną niż 3, 6, 9 lub 12. |
Location unavailable. |
Domyślna lokalizacja systemu jest niedostępna. |
Forecast unavailable. |
Prognoza dla bieżącej lokalizacji nie jest jeszcze dostępna. |
Przykłady działania
Dla prognozy dzisiejszej clear, temperatury minimalnej 8.0°C i maksymalnej 15.0°C wyjście 1 zwróci 1, wyjście 2 zwróci 8.0°C, a wyjście 3 zwróci 15.0°C. Opis bloczka będzie miał postać today clear 8.0..15.0°C.
Dla prognozy dzisiejszej rain, temperatury minimalnej 6.5°C i maksymalnej 12.0°C wyjście 1 zwróci 7, wyjście 2 zwróci 6.5°C, a wyjście 3 zwróci 12.0°C. Opis bloczka będzie miał postać today rain 6.5..12.0°C.