API jakości powietrza: prognozy, AQI i wartości zmierzone

Pyły, gazy, indeks UV oraz europejski i amerykański indeks jakości powietrza dla dowolnego miejsca na Ziemi, godzina po godzinie na maksymalnie pięć dni, a do tego pyłki w Europie. Oprócz prognozy ten sam klucz daje to, co właśnie mierzą pobliskie stacje oficjalne i czujniki obywatelskie.

curl "https://geo.runningcat.dev/v1/air?lon=6.869&lat=45.924&hours=48" \
  -H "Authorization: Bearer YOUR_KEY"
Przykładowe zapytanie

Prognoza dla punktu

{
  "lon": 6.869, "lat": 45.924,
  "current": { "time": "2026-11-07T17:00:00Z", "pm25": 6.3, "pm10": 7.5,
               "nitrogenDioxide": 5.3, "ozone": 51, "sulphurDioxide": 0.2, "carbonMonoxide": 154,
               "dust": 0, "uvIndex": 0, "europeanAqi": 23, "usAqi": 27,
               "alderPollen": 0, "birchPollen": 0, "grassPollen": 0,
               "mugwortPollen": 0, "olivePollen": 0, "ragweedPollen": 0 },
  "hourly": [ { "time": "2026-11-07T17:00:00Z", "pm25": 6.3, ... }, ... ]
}
Godziny
od 1 do 120, domyślnie 48
Zanieczyszczenia
PM2.5, PM10, dwutlenek azotu, ozon, dwutlenek siarki, tlenek węgla i pył pustynny, w µg/m³; nad Europą także amoniak
Indeksy
europejski AQI, amerykański AQI oraz indeks UV
Pyłki
olsza, brzoza, trawy, bylica, oliwka i ambrozja, ziarna na m³, w Europie; zobacz API pyłków

Prognozy pochodzą z Copernicus Atmosphere Monitoring Service (CAMS): w Europie z jego modelu europejskiego, na reszcie świata z modelu globalnego.

Dla obszaru

GET /v1/air/area?bbox=west,south,east,north&cells=&hours= zwraca wszystkie wartości na siatce do 400 komórek, godzina po godzinie, do map dymu, pyłu pustynnego lub ozonu nad regionem. Siatka jest taka sama jak w zapytaniu o pogodę dla obszaru.

Co stacje mierzą teraz

Prognoza to model. Żeby sprawdzić, jakie jest powietrze w tej chwili, użyj /v1/air/stations: zwraca stacje w pobliżu punktu, wewnątrz prostokąta lub wzdłuż trasy, każdą z najnowszymi wartościami godzinowymi i danymi z ostatnich siedmiu dni.

{
  "stations": [
    { "id": "gios:400", "name": "Kraków, Aleja Krasińskiego", "kind": "government",
      "lon": 19.92619, "lat": 50.05768, "distanceKm": 1.02, "time": "2026-11-07T17:00:00.000Z",
      "values": { "co": 750, "no2": 52.1, "pm10": 48.1, "pm25": 41.2 } },
    { "id": "sensorcommunity:68207", "name": null, "kind": "citizen",
      "lon": 19.936, "lat": 50.078, "distanceKm": 2.02, "time": "2026-11-07T17:28:37.000Z",
      "values": { "pm10": 39.3, "pm25": 20.5 } }
  ],
  "credits": [ "..." ]
}

Stacje oficjalne obejmują Albanię, Andorę, Austrię, Belgię, Bośnię i Hercegowinę, Bułgarię, Chorwację, Cypr, Czechy, Danię, Estonię, Finlandię, Francję, Niemcy, Grecję, Węgry, Islandię, Irlandię, Włochy, Łotwę, Luksemburg, Maltę, Czarnogórę, Holandię, Macedonię Północną, Norwegię, Polskę, Portugalię, Rumunię, Serbię, Słowację, Słowenię, Szwecję, Szwajcarię i Wielką Brytanię; czujniki obywatelskie mierzą pyły w tysiącach miejsc na całym świecie. Każda stacja podaje swój rodzaj (kind), więc można poprosić tylko o jeden rodzaj. Czujniki obywatelskie dobrze pokazują, czy powietrze jest teraz złe, ale przy mgle zawyżają odczyty i nie są tak dokładne jak stacje oficjalne.

Razem z resztą danych o miejscu

GET /v1/point zwraca w jednym żądaniu nazwę miejsca, strefę czasową, wysokość, pogodę, prognozę jakości powietrza, pobliskie stacje pomiaru powietrza i wodowskazy rzek. Liczy się to jako jedno żądanie. Dla prostokąta GET /v1/area robi to samo dla każdej jego części.

Cena

Plan darmowy daje 500 żądań dziennie, także w aplikacjach komercyjnych. Developer kosztuje 14,99 USD miesięcznie za 5000 żądań dziennie, a Pro 39,99 USD miesięcznie za 20 000 dziennie; na tym samym kluczu są pogoda, dane map, poziomy rzek, wysokości i routing.

Źródła: prognozy jakości powietrza z Open-Meteo.com (CC BY 4.0), oparte na danych Copernicus Atmosphere Monitoring Service. Wartości zmierzone: Sensor.Community contributors (ODbL 1.0); Czech Hydrometeorological Institute, ČHMÚ (CC BY 4.0); Źródło danych: GIOŚ - EKOINFONET (CC BY 4.0; dane bieżące są niezweryfikowane); European Environment Agency, aktualne dane zgłaszane przez kraje (CC BY 4.0; niezweryfikowane); sieć czujników Syngeos (syngeos.pl).

Plan darmowy daje 500 zapytań dziennie, także w aplikacjach komercyjnych. Załóż konto przez Google lub e-mail i od razu utwórz swoje klucze.