Integracja Home Assistant wykorzystująca publiczne dane IMGW-PIB (Instytut Meteorologii i Gospodarki Wodnej - Państwowy Instytut Badawczy). Dostarcza dane pogodowe, hydrologiczne i ostrzeżenia dla dowolnej lokalizacji w Polsce.
- Dwa tryby konfiguracji - automatyczny (GPS) lub manualny (wpisanie lokalizacji)
- Config Flow UI - konfiguracja przez interfejs, zero YAML
- 7 źródeł danych - synoptyczne, hydrologiczne, meteorologiczne, ostrzeżenia meteo, ostrzeżenia hydro, ostrzeżenia rozszerzone (meteo.imgw.pl), dane rozszerzone hydro (hydro-back)
- Do 90+ encji - temperatura, wiatr, wilgotność, ciśnienie, stan wody, przepływ, trendy, alarmy, ostrzeżenia, binary sensory zjawisk, mapy radarowe i inne
- Encja pogodowa - prognoza pogody (dzienna i godzinowa) z IMGW-PIB jako encja weather
- Mapy radarowe i satelitarne - opcjonalne encje camera z mapą opadów, odbiciowości, sumy opadów i zdjęciem satelitarnym
- Wiele instancji - możliwość dodania integracji wielokrotnie dla różnych lokalizacji
- Tłumaczenia PL/EN
- Bez klucza API - dane z publicznego API IMGW-PIB
- Auto-Discovery - automatyczne wykrywanie i aktualizacja najbliższych stacji na podstawie lokalizacji Home Assistant
- Geokodowanie - wyszukiwanie lokalizacji po nazwie z podpowiedziami (gmina, powiat, województwo)
- Filtrowanie ostrzeżeń według powiatu - precyzyjne filtrowanie ostrzeżeń meteorologicznych i hydrologicznych z kodami TERYT
- Automatyczne wykrywanie województwa i powiatu - system sam rozpoznaje region na podstawie współrzędnych
- Obliczanie odległości - każdy sensor pokazuje odległość do stacji pomiarowej
- Globalny koordynator - centralne pobieranie danych z rate limiting, oszczędność zapytań do API
- Options Flow - zmiana interwału aktualizacji i włączanie/wyłączanie prognozy pogody w dowolnym momencie (5-120 minut)
- Współrzędne geograficzne - wszystkie sensory zawierają współrzędne stacji w atrybutach
- Prognoza pogody - opcjonalna encja pogodowa z prognozą dzienną i godzinową (dane z IMGW API Proxy)
- Ostrzeżenia rozszerzone - szczegółowe ostrzeżenia z meteo.imgw.pl z 16 typami zjawisk (burze, grad, mróz, upał itp.) jako binary sensory
- Wzbogacone dane hydro - trend poziomu wody, odległość do poziomu alarmowego/ostrzegawczego, stan wody z hydro-back API
- Dynamiczne koordynaty stacji - współrzędne stacji synoptycznych pobierane z API (fallback na dane lokalne)
- Odporność na awarie - błędy map radarowych i prognozy nie blokują działania reszty integracji
Każda lokalizacja tworzy osobne urządzenia — stacje pomiarowe, ostrzeżenia i prognozę pogody.
|
Encja weather z aktualną pogodą, prognozą dzienną i godzinową.
|
8 sensorów dla każdego typu ostrzeżeń — od liczby aktywnych po pełną treść.
|
Sensory pomiarowe (poziom wody, przepływ, temperatura wody) i diagnostyczne (ID stacji, odległość).
System wykorzystuje współrzędne GPS z konfiguracji Home Assistant. Po wybraniu tego trybu integracja automatycznie wyszukuje najbliższe stacje pomiarowe wszystkich typów (synoptyczne, hydrologiczne, meteorologiczne) w promieniu 50 km. W kolejnym kroku możesz wybrać, które typy danych chcesz monitorować.
Funkcje trybu automatycznego:
- Automatyczne wykrywanie najbliższej stacji dla każdego typu danych
- Dynamiczna aktualizacja stacji jeśli zmieni się lokalizacja Home Assistant
- Automatyczne rozpoznanie województwa i powiatu dla ostrzeżeń
- Jeden wpis integracji obsługuje wszystkie wybrane typy danych
System pyta o nazwę miejscowości lub adres. Po wpisaniu nazwa jest wyszukiwana przez IMGW API Proxy, które zwraca listę propozycji z pełnymi szczegółami (nazwa miejscowości, gmina, powiat, województwo, kod TERYT). Po wybraniu lokalizacji system wyszukuje najbliższe stacje pomiarowe.
Funkcje trybu manualnego:
- Wyszukiwanie lokalizacji po nazwie z danymi z IMGW API
- Automatyczne pobieranie kodu TERYT powiatu z API
- Automatyczne rozpoznanie województwa i powiatu
- Możliwość wybrania dowolnej lokalizacji w Polsce
- Sortowanie wyników według rangi (najważniejsze miejscowości na górze)
- Jeden wpis integracji obsługuje wszystkie wybrane typy danych
| Sensor | Jednostka | Typ |
|---|---|---|
| Temperatura | °C | Pomiar |
| Prędkość wiatru | m/s | Pomiar |
| Kierunek wiatru | ° | Pomiar |
| Wilgotność | % | Pomiar |
| Suma opadu | mm | Pomiar |
| Ciśnienie atmosferyczne | hPa | Pomiar |
| ID stacji synop | - | Diagnostyczny |
| Odległość synop | km | Diagnostyczny |
Atrybuty: nazwa stacji, ID stacji, data pomiaru, godzina pomiaru, współrzędne geograficzne, odległość
| Sensor | Jednostka | Typ |
|---|---|---|
| Stan wody | cm | Pomiar |
| Przepływ wody | m³/s | Pomiar |
| Temperatura wody | °C | Pomiar |
| Stan poziomu wody | enum (low/medium/high/warning/alarm/...) | Informacyjny |
| Trend poziomu wody | enum (strongly_falling/.../strongly_rising) | Informacyjny |
| Ile do poziomu ostrzegawczego | cm | Pomiar |
| Ile do poziomu alarmowego | cm | Pomiar |
| Status alarmu wodnego | enum (none/warning/alarm) | Informacyjny |
| ID stacji hydro | - | Diagnostyczny |
| Odległość hydro | km | Diagnostyczny |
Atrybuty sensora stanu wody: poziom alarmowy (alarm_level), poziom ostrzegawczy (warning_level).
Wszystkie dane hydrologiczne (stan wody, progi alarmowe, trend, przepływ, temperatura wody) pobierane są z hydro-back API (hydro-back.imgw.pl) — tego samego źródła co portal hydro.imgw.pl.
| Sensor | Jednostka | Typ |
|---|---|---|
| Temperatura powietrza | °C | Pomiar |
| Temperatura gruntu | °C | Pomiar |
| Średnia prędkość wiatru | m/s | Pomiar |
| Maksymalna prędkość wiatru | m/s | Pomiar |
| Porywy wiatru (10 min) | m/s | Pomiar |
| Kierunek wiatru | ° | Pomiar |
| Wilgotność | % | Pomiar |
| Opad (10 min) | mm | Pomiar |
| ID stacji meteo | - | Diagnostyczny |
| Odległość meteo | km | Diagnostyczny |
Atrybuty: nazwa stacji, kod stacji, współrzędne geograficzne, odległość
| Sensor | Opis | Typ |
|---|---|---|
| Liczba aktywnych ostrzeżeń | Ilość bieżących ostrzeżeń | Pomiar |
| Najwyższy stopień ostrzeżenia | Najwyższy aktywny poziom (1-3) | - |
| Nazwa ostatniego zdarzenia | Nazwa najpoważniejszego ostrzeżenia | - |
| Stopień ostatniego ostrzeżenia | Poziom najpoważniejszego ostrzeżenia | - |
| Prawdopodobieństwo | Prawdopodobieństwo ostatniego ostrzeżenia (%) | - |
| Ważne od | Data początku ważności ostatniego ostrzeżenia | - |
| Ważne do | Data końca ważności ostatniego ostrzeżenia | - |
| Treść ostrzeżenia | Treść ostatniego ostrzeżenia (max 255 znaków) | - |
Sensor "Liczba aktywnych ostrzeżeń" zawiera w atrybucie warnings pełną listę wszystkich aktywnych ostrzeżeń.
Ostrzeżenia można filtrować według:
- Województwa (16 województw)
- Powiatu (dokładniejsze filtrowanie) - opcjonalne
| Sensor | Opis | Typ |
|---|---|---|
| Liczba aktywnych ostrzeżeń | Ilość bieżących ostrzeżeń hydro | Pomiar |
| Najwyższy stopień ostrzeżenia hydro | Najwyższy aktywny poziom | - |
| Nazwa ostatniego zdarzenia hydro | Nazwa/opis najpoważniejszego ostrzeżenia | - |
| Stopień ostatniego ostrzeżenia hydro | Poziom najpoważniejszego ostrzeżenia | - |
| Prawdopodobieństwo hydro | Prawdopodobieństwo ostatniego ostrzeżenia (%) | - |
| Ważne od hydro | Data początku ważności | - |
| Ważne do hydro | Data końca ważności | - |
| Opis ostrzeżenia hydro | Opis przebiegu ostrzeżenia (max 255 znaków) | - |
Sensor "Liczba aktywnych ostrzeżeń" zawiera w atrybucie warnings pełną listę wszystkich aktywnych ostrzeżeń hydrologicznych.
Ostrzeżenia można filtrować według:
- Województwa (16 województw)
- Powiatu (wyszukiwanie w opisie obszarów) - opcjonalne
Opcjonalne szczegółowe ostrzeżenia meteorologiczne z API meteo.imgw.pl. Niezależne od standardowych ostrzeżeń z danepubliczne.imgw.pl.
| Sensor | Opis | Typ |
|---|---|---|
| Liczba ostrzeżeń (obecne) | Wszystkie ostrzeżenia (w tym przyszłe) | Pomiar |
| Liczba ostrzeżeń (aktywne) | Ostrzeżenia obowiązujące teraz | Pomiar |
| Najwyższy stopień (obecne) | Max poziom wśród obecnych | - |
| Najwyższy stopień (aktywne) | Max poziom wśród aktywnych | - |
| Zjawiska (obecne) | Lista kodów zjawisk | - |
| Zjawiska (aktywne) | Lista kodów aktywnych zjawisk | - |
Per stopień (6 sensorów): dla każdego stopnia (1, 2, 3) — osobny binary sensor dla trybu "obecne" i "aktywne".
Per zjawisko (32 sensory): dla każdego z 16 zjawisk meteorologicznych — osobny binary sensor dla trybu "obecne" i "aktywne":
| Kod | Zjawisko | Ikona |
|---|---|---|
| BU | Burze | mdi:weather-lightning |
| BG | Burze z gradem | mdi:weather-hail |
| IS | Intensywne opady śniegu | mdi:weather-snowy-heavy |
| ID | Intensywne opady deszczu | mdi:weather-pouring |
| MS | Mgła osadzająca szadź | mdi:weather-fog |
| OB | Oblodzenie | mdi:sun-snowflake-variant |
| OM | Opady marznące | mdi:weather-snowy-rainy |
| OS | Opady śniegu | mdi:weather-snowy |
| PR | Przymrozki | mdi:snowflake-thermometer |
| RO | Roztopy | mdi:snowflake-melt |
| DB | Silny deszcz z burzami | mdi:weather-lightning-rainy |
| MG | Gęsta mgła | mdi:weather-hazy |
| MR | Silny mróz | mdi:snowflake-alert |
| SW | Silny wiatr | mdi:weather-windy |
| UP | Upał | mdi:weather-sunny-alert |
| ZZ | Zawieje zamiecie śnieżne | mdi:weather-dust |
Atrybuty binary sensorów: poziom ostrzeżenia, prawdopodobieństwo, daty ważności, treść SMS.
Opcjonalna encja pogodowa weather.* z danymi z IMGW API Proxy. Obsługuje:
| Właściwość | Opis |
|---|---|
| Warunki pogodowe | Na podstawie ikony IMGW (słonecznie, pochmurno, deszcz itp.) |
| Temperatura | Bieżąca temperatura powietrza (°C) |
| Temperatura odczuwalna | Temperatura odczuwalna (°C) |
| Wilgotność | Wilgotność powietrza (%) |
| Ciśnienie | Ciśnienie atmosferyczne (hPa) |
| Prędkość wiatru | Prędkość wiatru (m/s) |
| Porywy wiatru | Prędkość porywów wiatru (m/s) |
| Kierunek wiatru | Kierunek wiatru (°) |
| Zachmurzenie | Stopień zachmurzenia (%) |
Dodatkowe atrybuty: opady, opady śniegu, wschód/zachód słońca, ikona IMGW, model prognozy.
Prognozy:
- Dzienna - temperatura max/min, wiatr, opady (grupowanie dzień/noc)
- Godzinowa - pełne dane pogodowe na każdą godzinę
Opcjonalne encje camera.* z mapami generowanymi przez IMGW API Proxy. Obraz 800×800 px z podkładem mapowym OSM, danymi IMGW i markerem lokalizacji.
| Mapa | Opis | Produkt |
|---|---|---|
| Odbiciowość (CMAX) | Maksymalna odbiciowość radarowa — pokazuje echo chmur i opadów | cmax |
| Opady (SRI) | Intensywność opadu na ziemi w mm/h | sri |
| Suma opadów 1h (PAC) | Skumulowany opad w ciągu ostatniej godziny w mm | pac |
| Mapa | Opis | Produkt |
|---|---|---|
| Kolory naturalne | Obraz satelitarny w kolorach naturalnych | natural_color |
| Zachmurzenie (IR) | Mapa chmur w podczerwieni — działa 24/7, niezależnie od pory dnia | infrared |
| Para wodna | Kanał pary wodnej 6.2µm — ruchy mas powietrza | water_vapor |
| Typy chmur | Klasyfikacja chmur NWC SAF — niskie, średnie, wysokie, Cb | cloud_type |
Mapy prognoz generacji energii z odnawialnych źródeł na podstawie modelu ECMWF IFS 9km. Dane identyczne jak na meteo.imgw.pl, aktualizowane co pełną godzinę UTC. Animacje pokazują prognozę na 24 godziny do przodu.
| Mapa | Opis | Produkt |
|---|---|---|
| Generacja PV | Prognoza generacji energii fotowoltaicznej (% mocy nominalnej) | oze_pv |
| Generacja wiatr | Prognoza generacji energii wiatrowej (% mocy nominalnej) | oze_wind |
| Animacja PV (GIF) | Animowany GIF z prognozą PV na 24h do przodu | oze_pv_anim |
| Animacja wiatr (GIF) | Animowany GIF z prognozą wiatru na 24h do przodu | oze_wind_anim |
|
Prognoza generacji PV (animacja 24h)
|
Prognoza generacji wiatrowej (animacja 24h)
|
W konfiguracji dostępny jest multi-select — możesz wybrać dowolną kombinację produktów:
| Kategoria | Produkty |
|---|---|
| Radar | CMAX, SRI, PAC |
| Satelita | Kolory naturalne, Zachmurzenie (IR), Para wodna, Typy chmur |
| OZE | Generacja PV, Generacja wiatr, Animacja PV, Animacja wiatr |
Atrybuty każdej encji: współrzędne lokalizacji, typ produktu, timestamp obrazu.
Mapy radarowe zawierają skalę kolorów z wartościami (dBZ, mm/h, mm). Zdjęcia zachmurzenia i typów chmur zawierają legendę kolorów. Mapy OZE zawierają skalę generacji (0-100%). Każdy obraz zawiera datę i godzinę w czasie polskim.
- Otwórz HACS w Home Assistant
- Kliknij ⋮ - Custom repositories
- Dodaj
https://github.com/abnvle/ha-imgw-pib-monitorz kategorią Integration - Wyszukaj IMGW-PIB Monitor i zainstaluj
- Uruchom ponownie Home Assistant
- Pobierz repozytorium
- Skopiuj
custom_components/imgw_pib_monitordo katalogucustom_components/ - Uruchom ponownie Home Assistant
- Przejdź do Ustawienia - Urządzenia i usługi - Dodaj integrację
- Wyszukaj IMGW-PIB Monitor
- Wybierz Automatyczny (GPS)
- System znajdzie najbliższe stacje dla wszystkich typów danych
- Zaznacz typy danych, które chcesz monitorować:
- Dane synoptyczne (pogoda)
- Dane meteorologiczne (szczegółowa meteorologia)
- Dane hydrologiczne (rzeki)
- Ostrzeżenia meteorologiczne
- Ostrzeżenia hydrologiczne
- Dla ostrzeżeń możesz opcjonalnie włączyć filtrowanie po powiecie
- Opcjonalnie włącz prognozę pogody (encja weather)
- Potwierdź konfigurację
- Przejdź do Ustawienia - Urządzenia i usługi - Dodaj integrację
- Wyszukaj IMGW-PIB Monitor
- Wybierz Manualny (wpisanie lokalizacji)
- Wpisz nazwę miejscowości lub adres
- Wybierz odpowiednią lokalizację z listy podpowiedzi
- System znajdzie najbliższe stacje dla wszystkich typów danych
- Zaznacz typy danych, które chcesz monitorować
- Dla ostrzeżeń możesz opcjonalnie włączyć filtrowanie po powiecie
- Opcjonalnie włącz prognozę pogody (encja weather)
- Opcjonalnie wybierz mapę radarową/satelitarną (encja camera)
- Potwierdź konfigurację
Możesz dodać integrację wielokrotnie dla różnych lokalizacji. Każda instancja działa niezależnie i może monitorować inne typy danych.
Po dodaniu integracji możesz zmienić ustawienia:
- Przejdź do Ustawienia - Urządzenia i usługi
- Znajdź wpis IMGW-PIB Monitor
- Kliknij KONFIGURUJ
- Ustaw nowy interwał aktualizacji (5-120 minut)
- Włącz lub wyłącz filtrowanie ostrzeżeń po powiecie
- Włącz lub wyłącz prognozę pogody (encja weather)
- Włącz lub wyłącz ostrzeżenia rozszerzone (meteo.imgw.pl)
- Wybierz mapę radarową/satelitarną (wyłączona, pojedynczy produkt lub wszystkie)
Domyślny interwał aktualizacji: 30 minut. Globalny koordynator synchronizuje się z najkrótszym interwałem spośród wszystkich instancji.
Integracja wykorzystuje dwustopniową architekturę koordynatorów:
-
Globalny koordynator - pobiera wszystkie dane z API IMGW-PIB. Interwał jest synchronizowany z najkrótszym interwałem spośród wszystkich instancji integracji. Używa rate limiting (2 równoczesne zapytania z opóźnieniem 200ms) aby nie obciążać API.
-
Koordynatory instancji - każda instancja integracji ma własny koordynator, który filtruje dane z globalnego koordynatora i przygotowuje je dla swoich sensorów. Aktualizacje odbywają się zgodnie z ustawionym interwałem.
-
Koordynator prognozy (opcjonalny) - osobny koordynator pobierający prognozę pogody z IMGW API Proxy dla encji weather.
Korzyści:
- Jedno zapytanie do API obsługuje wszystkie instancje integracji
- Zmniejszone obciążenie API IMGW-PIB
- Lepsza wydajność Home Assistant
- Możliwość częstszych aktualizacji bez obawy o przeciążenie API
Kody TERYT powiatów i ich nazwy są pobierane bezpośrednio z IMGW API Proxy podczas konfiguracji. Integracja nie zawiera lokalnej bazy kodów - dzięki temu zawsze korzysta z aktualnych danych, bez konieczności aktualizacji po zmianach administracyjnych.
Kody TERYT są używane do:
- Filtrowania ostrzeżeń meteorologicznych (API zwraca ostrzeżenia z kodami TERYT)
- Filtrowania ostrzeżeń hydrologicznych (wyszukiwanie nazwy powiatu w opisie obszarów)
- Automatycznego wykrywania powiatu na podstawie geokodowania
Format kodu TERYT: AABB gdzie:
AA- kod województwa (02-32)BB- kod powiatu (01-99)
Przykłady:
1201- powiat bocheński (woj. małopolskie)1261- m. Kraków (miasto na prawach powiatu)1465- m. Warszawa
API IMGW-PIB nie zwraca współrzędnych dla stacji synoptycznych. Integracja zawiera twardo zakodowaną bazę współrzędnych dla wszystkich 64 stacji synoptycznych w Polsce. Współrzędne są używane do:
- Obliczania odległości do stacji
- Automatycznego wyboru najbliższej stacji w trybie auto-discovery
- Wyświetlania lokalizacji stacji w atrybutach sensorów
Dla tych stacji współrzędne są pobierane bezpośrednio z API IMGW-PIB.
W trybie automatycznym integracja na bieżąco sprawdza, czy nie zmieniła się lokalizacja Home Assistant. Jeśli wykryje zmianę współrzędnych GPS, automatycznie aktualizuje wybrane stacje na najbliższe dostępne. Dzięki temu:
- Integracja działa poprawnie po zmianie lokalizacji (np. przeniesienie instalacji)
- Zawsze korzystasz z danych z najbliższych stacji
- Nie musisz ręcznie rekonfigurować integracji
Aktualizacja dotyczy tylko typów danych, które były włączone podczas konfiguracji.
System automatycznie wykrywa województwo i powiat na podstawie:
- Danych z IMGW API Proxy (reverse geocoding - współrzędne GPS -> najbliższa lokalizacja)
- API zwraca nazwę województwa, powiatu i kod TERYT
- Fallback: odległość do stolic województw jeśli API nie zwróci danych
- Danych z IMGW API Proxy (nazwa lokalizacji zawiera województwo, powiat, kod TERYT)
- Kod TERYT powiatu i nazwa są pobierane bezpośrednio z API
Wykryty region jest używany do:
- Filtrowania ostrzeżeń meteorologicznych i hydrologicznych według kodu TERYT
- Wyświetlania informacji w nazwach urządzeń
- Automatycznej konfiguracji ostrzeżeń
automation:
- alias: "Ostrzeżenie IMGW"
trigger:
- platform: numeric_state
entity_id: sensor.imgw_auto_discovery_warnings_meteo_count
above: 0
action:
- service: notify.mobile_app
data:
title: "Ostrzeżenie meteorologiczne"
message: >
{{ state_attr('sensor.imgw_auto_discovery_warnings_meteo_latest', 'event') }}
Stopień: {{ state_attr('sensor.imgw_auto_discovery_warnings_meteo_latest', 'level') }}
Ważne: {{ state_attr('sensor.imgw_auto_discovery_warnings_meteo_latest', 'valid_from') }} - {{ state_attr('sensor.imgw_auto_discovery_warnings_meteo_latest', 'valid_to') }}automation:
- alias: "Alert mrozowy"
trigger:
- platform: numeric_state
entity_id: sensor.imgw_auto_discovery_temperature
below: -15
action:
- service: notify.mobile_app
data:
title: "Silny mróz"
message: "Temperatura spadła do {{ states('sensor.imgw_auto_discovery_temperature') }}°C w {{ state_attr('sensor.imgw_auto_discovery_temperature', 'station_name') }}"automation:
- alias: "Alert stan wody"
trigger:
- platform: numeric_state
entity_id: sensor.imgw_auto_discovery_water_level
above: 500
action:
- service: notify.mobile_app
data:
title: "Wysoki stan wody"
message: >
Stan wody w {{ state_attr('sensor.imgw_auto_discovery_water_level', 'river') }}
w {{ state_attr('sensor.imgw_auto_discovery_water_level', 'station_name') }}
wynosi {{ states('sensor.imgw_auto_discovery_water_level') }} cmautomation:
- alias: "Alert silny wiatr"
trigger:
- platform: numeric_state
entity_id: sensor.imgw_auto_discovery_wind_speed
above: 15
action:
- service: notify.mobile_app
data:
title: "Silny wiatr"
message: "Prędkość wiatru: {{ states('sensor.imgw_auto_discovery_wind_speed') }} m/s ({{ (states('sensor.imgw_auto_discovery_wind_speed') | float * 3.6) | round(0) }} km/h)"type: vertical-stack
cards:
- type: entities
title: Ostrzeżenia IMGW
entities:
- entity: sensor.imgw_auto_discovery_warnings_meteo_count
name: Aktywne ostrzeżenia meteo
- entity: sensor.imgw_auto_discovery_warnings_meteo_max_level
name: Najwyższy stopień
- entity: sensor.imgw_auto_discovery_warnings_meteo_latest
name: Ostatnie ostrzeżenie
- entity: sensor.imgw_auto_discovery_warnings_hydro_count
name: Aktywne ostrzeżenia hydro
- type: weather-forecast
entity: weather.home
- type: entities
title: Dane IMGW
entities:
- entity: sensor.imgw_auto_discovery_temperature
name: Temperatura
- entity: sensor.imgw_auto_discovery_wind_speed
name: Wiatr
- entity: sensor.imgw_auto_discovery_humidity
name: Wilgotność
- entity: sensor.imgw_auto_discovery_pressure
name: CiśnienieAPI IMGW-PIB nie wymaga klucza i nie ma oficjalnych limitów, ale warto zachować rozsądek:
- Globalny koordynator pobiera dane zgodnie z najkrótszym interwałem instancji (domyślnie 30 minut)
- Rate limiting - maksymalnie 2 równoczesne zapytania z opóźnieniem 200ms
- Cache - wszystkie instancje używają tych samych danych
- Timeout - timeout po 30 sekundach
Zalecenia:
- Nie ustawiaj interwału poniżej 5 minut
- Dla wielu instancji używaj tego samego interwału
- Dane z API są aktualizowane co godzinę, nie ma sensu odpytywać częściej niż co 15 minut
Jeśli system nie znajduje żadnych stacji w promieniu 50 km:
- Sprawdź czy współrzędne GPS w Home Assistant są poprawne
- Spróbuj trybu manualnego i wpisz najbliższą dużą miejscowość
- Niektóre typy stacji (zwłaszcza hydrologiczne) nie są dostępne wszędzie
Jeśli sensory pokazują unavailable lub None:
- Sprawdź logi Home Assistant (
Ustawienia - System - Logi) - Niektóre stacje nie raportują wszystkich parametrów
- API IMGW-PIB czasami zwraca puste wartości
- Sprawdź czy powiat został wykryty (informacja w logach)
- Dla ostrzeżeń hydro filtrowanie działa tylko jeśli nazwa powiatu występuje w opisie obszarów
- Możesz wyłączyć filtrowanie po powiecie i zostawić samo województwo
- Sprawdź interwał aktualizacji w opcjach integracji
- Sprawdź czy globalny koordynator pobiera dane (logi)
- Sprawdź połączenie internetowe Home Assistant
Dane pochodzą z publicznego API IMGW-PIB:
https://danepubliczne.imgw.pl/api/data/synophttps://danepubliczne.imgw.pl/api/data/meteohttps://danepubliczne.imgw.pl/api/data/warningsmeteohttps://danepubliczne.imgw.pl/api/data/warningshydro
Dane hydrologiczne (hydro-back API — to samo źródło co portal hydro.imgw.pl):
https://hydro-back.imgw.pl/list/hydro(lista stacji, stan wody, progi alarmowe, trend)https://hydro-back.imgw.pl/station/hydro/discharge?id=...(aktualny przepływ)https://hydro-back.imgw.pl/station/hydro/water-temperature?id=...(temperatura wody)
Dane rozszerzone:
https://meteo.imgw.pl/api/meteo/messages/v1/osmet/latest/osmet-teryt(ostrzeżenia rozszerzone)
IMGW API Proxy (prognoza, radar, satelita, OZE, koordynaty stacji):
https://imgw-api-proxy.evtlab.pl/forecast(prognoza pogody)https://imgw-api-proxy.evtlab.pl/radar?lat=...&lon=...&product=...(mapy radarowe, satelitarne i OZE)https://imgw-api-proxy.evtlab.pl/radar?...&product=oze_pv&hour=0(prognoza OZE — bieżąca godzina)https://imgw-api-proxy.evtlab.pl/radar?...&product=oze_pv&animate=24(animacja OZE 24h)https://imgw-api-proxy.evtlab.pl/stations/synop(koordynaty stacji synoptycznych)
Dane OZE (źródło: model ECMWF IFS 9km via IMGW):
https://tilesources-c.imgw.pl/vector/oze/epsg3857/latest/(obrazy prognoz OZE)
Źródłem pochodzenia danych pomiarowych jest Instytut Meteorologii i Gospodarki Wodnej - Państwowy Instytut Badawczy.
Łukasz Kozik - lkozik@evilit.pl
Dziękuję Allon za pomoc w tworzeniu integracji.
