Dokumentacja API

Prognoza pogody i gromadzenia się zanieczyszczeń

Najbliższe godziny dla miasta, do 72: temperatura, wiatr, wilgotność, opady i wskaźnik gromadzenia się zanieczyszczeń 0–100 — jak silnie pogoda zatrzymuje cząstki przy ziemi. Oszacowanie na podstawie pogody, a nie prognoza PM2.5.

Prognoza pogody i gromadzenia się zanieczyszczeń

GEThttps://api.atmy.ai/v1/air-quality/forecast

Parametry zapytania

city string opcjonalny

Nazwa miasta w dowolnym języku strony, slug (kraj/miasto) lub id.

country string opcjonalny

Nazwa lub slug kraju, by odróżnić miasta o tej samej nazwie.

hours integer opcjonalny

Godzin naprzód, do 72.

Domyślnie: 24

lang string opcjonalny

Język nazw miasta i kraju oraz linku do strony.

Domyślnie: en

GET/air-quality/forecast?city=germany/berlin&hours=24

curl "https://api.atmy.ai/v1/air-quality/forecast?city=germany/berlin&hours=24"

const response = await fetch("https://api.atmy.ai/v1/air-quality/forecast?city=germany/berlin&hours=24");
const data = await response.json();

import requests

data = requests.get("https://api.atmy.ai/v1/air-quality/forecast?city=germany/berlin&hours=24").json()

200Odpowiedź

{
  "city": {
    "id": 50037,
    "slug": "germany/berlin",
    "name": "Berlin",
    "country": "Germany",
    "timezone": "Europe/Berlin",
    "center": {
      "lat": 52.5073,
      "lon": 13.3979
    },
    "page": "https://atmy.ai/air-quality/germany/berlin/"
  },
  "generated_at": "2026-10-27T11:07:04+00:00",
  "local_time": "2026-10-27 12:07",
  "air_now": {
    "value": 3.8,
    "min": 0,
    "max": 105.3,
    "sensors": 173,
    "level": "good",
    "approximate": true,
    "basis": "mean_of_latest_per_sensor",
    "snapshot_at": "2026-10-27T11:00:01.147Z"
  },
  "weather_now": {
    "temp": 14,
    "feels_like": 11,
    "humidity": 62,
    "pressure": 1020,
    "wind": 3,
    "gust": 8,
    "clouds": 90,
    "precipitation": 0,
    "condition": "cloudy",
    "icon": "03d",
    "wind_deg": 185,
    "weather_id": 803
  },
  "hours": [
    {
      "time": "2026-10-27T11:00:00Z",
      "temperature_c": 13,
      "wind_m_s": 3.1,
      "gust_m_s": 7.6,
      "humidity_percent": 63,
      "clouds_percent": 87,
      "precipitation_mm": 0,
      "accumulation_risk": 6
    },
    {
      "time": "2026-10-27T12:00:00Z",
      "temperature_c": 14,
      "wind_m_s": 3.2,
      "gust_m_s": 7.2,
      "humidity_percent": 64,
      "clouds_percent": 77,
      "precipitation_mm": 0,
      "accumulation_risk": 6
    }
  ],
  "accumulation_risk": {
    "scale": "0-100",
    "meaning": "How strongly the weather (calm, inversion, humidity) keeps particles near the ground: low disperses them, high traps them. A weather estimate, not a PM2.5 forecast."
  },
  "methodology": "https://api.atmy.ai/air-quality/methodology"
}