Әзірлеушілерге

API анықтамасы

Қазіргі ауа сапасы

Ағымдағы мән (әр датчиктің 60 минуттан ескі емес соңғы өлшемінің орташа шамасы, әр 15 минут сайын қайта есептеледі) және Data Hub жүйесіндегідей соңғы аяқталған күн, US EPA санаты, датчик желілері және қала бетіне сілтемемен. Сондай-ақ қазіргі ауа райын (температура, ылғалдылық, қысым, жел, бұлттылық, жауын-шашын) және соңғы толық күннің ауа райын береді. Қаланы 25 тілдің кез келгеніндегі атауы, slug не id немесе координаттар бойынша табыңыз — 50 km ішіндегі қорытындысы бар ең жақын қала. Екі қаланың атауы бірдей болса country= қосыңыз.

Қазіргі ауа сапасы

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

Сұрау параметрлері

city string міндетті емес

Сайттың кез келген тіліндегі қала атауы, slug (ел/қала) немесе id.

country string міндетті емес

Аттас қалаларды ажырату үшін ел атауы немесе slug.

lat number міндетті емес

Ендік, lon-мен бірге, city орнына: 50 km ішіндегі жиынтығы бар ең жақын қала.

lon number міндетті емес

Бойлық, lat-пен бірге.

lang string міндетті емес

Қала мен ел атауларының және бет сілтемесінің тілі.

Әдепкі: en

GET/air-quality/current?city=germany/berlin
curl "https://api.atmy.ai/v1/air-quality/current?city=germany/berlin"
200Жауап
{
  "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/"
  },
  "now": {
    "status": "current",
    "pm25": 3.8,
    "median": 2.4,
    "min": 0,
    "max": 105.32,
    "unit": "ug/m3",
    "category": {
      "scale": "US_EPA_2024",
      "level": "good",
      "approximate": true
    },
    "sensors": 173,
    "observed": {
      "start": "2026-10-27T10:42:02.000Z",
      "end": "2026-10-27T10:53:14.000Z"
    },
    "updated_at": "2026-10-27T11:00:01.147Z",
    "method": "mean_of_latest_reading_per_sensor_at_most_60_minutes_old"
  },
  "weather": {
    "observed_at": "2026-10-27T11:07:04Z",
    "temperature_c": 14,
    "feels_like_c": 11,
    "humidity_percent": 62,
    "pressure_hpa": 1020,
    "wind_m_s": 3,
    "wind_gust_m_s": 8,
    "wind_direction_deg": 185,
    "clouds_percent": 90,
    "precipitation_mm": 0,
    "condition": "cloudy"
  },
  "completed_day": {
    "date": "2026-10-26",
    "period": "2026-10-26T00:00:00Z/2026-10-27T00:00:00Z",
    "pm25": 4.6,
    "unit": "ug/m3",
    "sensors": 176,
    "category": {
      "scale": "US_EPA_2024",
      "level": "good"
    },
    "method": "datahub_daily",
    "weather": {
      "temperature_c": 9,
      "temperature_min_c": 7.2,
      "temperature_max_c": 13.4,
      "humidity_percent": 73,
      "pressure_hpa": 1014,
      "wind_m_s": 3.2,
      "wind_gust_max_m_s": 11.2,
      "clouds_percent": 44,
      "observations": 7
    }
  },
  "attribution": "Atmy (atmy.ai), aggregated public and citizen sensor networks; approximate values, not official monitoring.",
  "weather_attribution": "Weather: OpenWeatherMap (to 2026-07-08, CC BY-SA 4.0) and Open-Meteo.com (from 2026-07-09, CC BY 4.0), collected by Atmy.",
  "sources": {
    "networks": {
      "Sensor.Community": 169,
      "AirGradient": 4
    },
    "methodology": "https://api.atmy.ai/air-quality/methodology",
    "license": "https://api.atmy.ai/legal/data",
    "city_json": "https://api.atmy.ai/api/public/v1/cities/germany/berlin/air-quality"
  }
}