Pro vývojáře

Reference API

Předpověď počasí a hromadění znečištění

Nejbližší hodiny pro dané město, až 72: teplota, vítr, vlhkost, srážky a index hromadění znečištění 0–100 — jak silně počasí zadržuje částice u země. Odhad podle počasí, nikoli předpověď PM2.5.

Předpověď počasí a hromadění znečištění

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

Parametry dotazu

city string volitelný

Název města v libovolném jazyce webu, slug (země/město) nebo id.

country string volitelný

Název nebo slug země, k rozlišení měst se stejným názvem.

hours integer volitelný

Hodin dopředu, až 72.

Výchozí: 24

lang string volitelný

Jazyk názvů města a země a odkazu na stránku.

Výchozí: en

GET/air-quality/forecast?city=germany/berlin&hours=24
curl "https://api.atmy.ai/v1/air-quality/forecast?city=germany/berlin&hours=24"
200Odpověď
{
  "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"
}