Interfejs programistyczny aplikacji (API)

Interfejs API portalu "Jakość Powietrza" GIOŚ umożliwia dostęp do danych dotyczących jakości powietrza w Polsce, wytwarzanych w ramach Państwowego Monitoringu Środowiska i gromadzonych w bazie EKOINFONET - JPOAT.

Korzystając z API akceptują Państwo wszystkie warunki zawarte w Regulaminie portalu. Użytkownik ponownie wykorzystujący informacje sektora publicznego udostępniane na portalu Jakość Powietrza zobowiązany jest w sposób czytelny i wyraźny wskazać źródło pozyskania informacji.

W przypadku wystąpienia problemów technicznych/informatycznych prosimy o kontakt na adres mailowy api@gios.gov.pl

Udostępniane dane nie są na bieżąco weryfikowane, zatem mogą ulec zmianie w późniejszym czasie.

Wyniki pomiarów wszystkich zanieczyszczeń udostępnianych poprzez API wyświetlane są w jednostce μg/m³ (również wyniki pomiarów CO - tlenku węgla, dla którego wyniki pomiarów prezentowane na mapie bieżących danych pomiarowych portalu Jakość Powietrza oraz w aplikacji mobilnej "Jakość Powietrza w Polsce" przeliczone są na mg/m³).

Ze względu na zdarzające się przypadki awarii sprzętu pomiarowego, awarii transmisji danych lub innych zdarzeń losowych, na które pracownicy Głównego Inspektoratu Ochrony Środowiska nie mają wpływu, mogą występować sporadyczne przerwy w transmisji i prezentacji danych pomiarowych na portalu "Jakość Powietrza" oraz w aplikacjach korzystających z interfejsu API.

Nowe usługi API GIOŚ:

Poniższa lista opisuje usługi sieciowe udostępnione w ramach interfejsu API w formacie JSON-LD (wraz z inormacją o limitach zabezpieczających przed nadmiernym obciążeniem zasobów), dostępne za pomocą automatycznej dokumentacji dostępnej pod linkiem OPEN API:

zagregowane dane maksimum ze średnich 8-godzinnych z 1-godzinnych wyników pomiarów pyłu zawieszonego PM10 i średnia 24-godzinna z 1-godzinnych wyników pomiarów pyłu zawieszonego PM10 dla ostatnich 3 dób (limit 2 żądania na minutę),
archiwalne dane pomiarowe, udostępniane w czasie UTC+ 01:00, środkowoeuropejski zimowy (limit 2 żądania na minutę),
informacje o przekroczeniu poziomu informowania, alarmowego, dopuszczalnego i docelowego zanieczyszczeń (limit 2 żądania na minutę),
dane prezentowane na mapach rozkładów stężeń zanieczyszczeń (limit 2 żądania na minutę),
metadane stacji i stanowisk pomiarowych (limit 2 żądania na minutę),
statystyki roczne (limit 2 żądania na minutę),
bieżące dane pomiarowe od ostatniej pełnej godziny do trzeciej doby wstecz, udostępniane w czasie lokalnym (limit 1500 żądań na minutę),
aktualne wskazania indeksu jakości powietrza (limit 1500 żądań na minutę),
lista stacji i stanowisk pomiarowych (limit 2 i 1500 żądań na minutę).

Utworzenie nowych usług API portalu Jakość Powietrza Głównego Inspektoratu Ochrony Środowiska sfinansowano ze środków Narodowego Funduszu Ochrony Środowiska i Gospodarki Wodnej.

Uwaga - 30.06.2025 r. wycofano starsze wersje usług opisanych poniżej. Jak informowaliśmy w komunikatach, aktualnie należy stosować zmodernizowane odpowiedniki tych usług, opisane w dokumentacji OPEN API.

Stacje pomiarowe - Usługa sieciowa udostępniająca listę stacji pomiarowych:
Wycofano: https://api.gios.gov.pl/pjp-api/rest/station/findAll
Aktualna wersja: https://api.gios.gov.pl/pjp-api/v1/rest/station/findAll
Stanowiska pomiarowe - usługa sieciowa udostępniająca listę stanowisk pomiarowych dostępnych na wybranej stacji pomiarowej:

Wycofano: https://api.gios.gov.pl/pjp-api/rest/station/sensors/{stationId}
Aktualna wersja: https://api.gios.gov.pl/pjp-api/v1/rest/station/sensors/{stationId}

Dane pomiarowe - usługa sieciowa udostępniająca dane pomiarowe na podstawie podanego identyfikatora stanowiska pomiarowego:

Wycofano: https://api.gios.gov.pl/pjp-api/rest/data/getData/{sensorId}
Aktualna wersja: https://api.gios.gov.pl/pjp-api/v1/rest/data/getData/{sensorId}

Indeks jakości powietrza - usługa sieciowa udostępniająca indeks jakości powietrza na podstawie podanego identyfikatora stacji pomiarowej:
Wycofano: https://api.gios.gov.pl/pjp-api/rest/aqindex/getIndex/{stationId}
Aktualna wersja: https://api.gios.gov.pl/pjp-api/v1/rest/aqindex/getIndex/{stationId}

Interfejs API Instytutu Ochrony Środowiska - Państwowego Instytutu Badawczego udostępniający dane w zakresie prognoz jakości powietrza:

Interfejs API Prognoz jakości powietrza opracowywanych przez Instytut Ochrony Środowiska - Państwowy Instytut Badawczy, zwraca prognozowane średnie dobowe steżenie w jednostce μg/m³ na obszarze powiatu/gminy na podstawie kodu TERYT (wyszukiwarka kodów TERYT) dla pyłu zawieszonego PM10 (PM10), dwutlenku azotu (NO2), dwutlenku siarki (SO₂) i ozonu (O₃). W przypadku ewentualnych problemów lub pytań dot. API prognoz, należy je kierować bezpośrednio do Instytutu Ochrony Środowiska - Państwowego Instytutu Badawczego.

Przykład zapytania: PM10 dla Warszawy

https://api.prognozy.ios.edu.pl/v1/PM10/1465

Przykład odpowiedzi:

{"20220811": 16.88, "20220812": 19.52, "20220813": 17.65}

Przykład zapytania: PM10 dla powiatu Wołomińskiego

https://api.prognozy.ios.edu.pl/v1/PM10/1434

Przykład odpowiedzi:

{"20220811": 13.58, "20220812": 16.05, "20220813": 12.41}