Strona główna GIOŚ
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/m3 (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/m3).

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ę).

Logo NFOŚiGW

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

 

 

Link do dokumentacji Open API

 

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:
    Wycofanohttps://api.gios.gov.pl/pjp-api/rest/station/findAll
    Aktualna wersjahttps://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:

Wycofanohttps://api.gios.gov.pl/pjp-api/rest/station/sensors/{stationId}
Aktualna wersjahttps://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/m3  na obszarze powiatu/gminy na podstawie kodu TERYT (wyszukiwarka kodów TERYT) dla pyłu zawieszonego PM10 (PM10), dwutlenku azotu (NO2), dwutlenku siarki (SO2) i ozonu (O3). 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}