დეველოპერებისთვის

API ცნობარი

ისტორია

ქალაქის დღიური საშუალოები 2017 წლიდან ნებისმიერი პერიოდისთვის და მთელი მისი ისტორია თვეების მიხედვით, წლიური საშუალოებითა და რეკორდებით.

დღიური ისტორია

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

Data Hub-ის დღიური საშუალოები (UTC): ბოლო დღეები days=-ით ან ნებისმიერი პერიოდი 2017 წლიდან from=-ითა და to=-ით, ერთ მოთხოვნაზე მაქსიმუმ 400 დღე; დღე სენსორების არასაკმარისი რაოდენობით გამოტოვებულია. 2026-01-19-დან ყოველ დღეს თავისი ამინდიც ახლავს: საშუალო, მინიმალური და მაქსიმალური ტემპერატურა, ტენიანობა, წნევა, ქარი, ყველაზე ძლიერი ქარის დაბერვა და ღრუბლიანობა.

მოთხოვნის პარამეტრები

city string არასავალდებულო

ქალაქის სახელი საიტის ნებისმიერ ენაზე, slug (ქვეყანა/ქალაქი) ან id.

country string არასავალდებულო

ქვეყნის სახელი ან slug, ერთნაირი სახელის ქალაქების გასარჩევად.

days integer არასავალდებულო

რამდენი დღით უკან ბოლო სრული დღიდან; from-ისა და to-ს დროს არ გამოიყენება.

ნაგულისხმევი: 30

from date არასავალდებულო

პირველი დღე (UTC), 2017-01-01 ან შემდეგ.

to date არასავალდებულო

ბოლო დღე (UTC); ნაგულისხმევად ბოლო სრული დღე. მოთხოვნაზე არაუმეტეს 400 დღისა.

lang string არასავალდებულო

ქალაქისა და ქვეყნის სახელების და გვერდის ბმულის ენა.

ნაგულისხმევი: en

GET/air-quality/history?city=germany/berlin&days=30
curl "https://api.atmy.ai/v1/air-quality/history?city=germany/berlin&days=30"
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/"
  },
  "unit": "ug/m3",
  "method": "datahub_daily",
  "period_timezone": "UTC",
  "category_scale": "US_EPA_2024",
  "from": "2026-10-24",
  "to": "2026-10-26",
  "available_since": "2017-01-01",
  "days": [
    {
      "date": "2026-10-24",
      "pm25": 3.4,
      "sensors": 172,
      "level": "good",
      "weather": {
        "temperature_c": 10.1,
        "temperature_min_c": 6.7,
        "temperature_max_c": 14.7,
        "humidity_percent": 71,
        "pressure_hpa": 1010,
        "wind_m_s": 4.3,
        "wind_gust_max_m_s": 12.7,
        "clouds_percent": 83,
        "observations": 7
      }
    },
    {
      "date": "2026-10-25",
      "pm25": 3.9,
      "sensors": 174,
      "level": "good",
      "weather": {
        "temperature_c": 9.8,
        "temperature_min_c": 7.2,
        "temperature_max_c": 14.6,
        "humidity_percent": 72,
        "pressure_hpa": 1002,
        "wind_m_s": 5,
        "wind_gust_max_m_s": 14.7,
        "clouds_percent": 86,
        "observations": 7
      }
    },
    {
      "date": "2026-10-26",
      "pm25": 4.6,
      "sensors": 176,
      "level": "good",
      "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
      }
    }
  ],
  "weather_since": "2026-01-19",
  "weather_notes": "weather: means of the readings Atmy stored for the city on the UTC day (observations: how many); temperature_min_c and temperature_max_c are the lowest and highest the provider reported for the day; wind_gust_max_m_s the strongest gust. No precipitation sum: the readings are instants.",
  "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."
}

თვიური ისტორია

GEThttps://api.atmy.ai/v1/air-quality/history/monthly

ქალაქის გაზომვების მთელი ისტორია თვეების მიხედვით: წლიური საშუალოები (სრული წლები მონიშნულია), ყველაზე დაბინძურებული და ყველაზე სუფთა თვეები და დღეები. სენსორების ქსელის საკუთარ დღიურ საშუალოებზე დაფუძნებული მნიშვნელობები მონიშნულია. 2026 წლის იანვრიდან ყოველ თვეს თავისი ამინდიც ახლავს.

მოთხოვნის პარამეტრები

city string არასავალდებულო

ქალაქის სახელი საიტის ნებისმიერ ენაზე, slug (ქვეყანა/ქალაქი) ან id.

country string არასავალდებულო

ქვეყნის სახელი ან slug, ერთნაირი სახელის ქალაქების გასარჩევად.

lang string არასავალდებულო

ქალაქისა და ქვეყნის სახელების და გვერდის ბმულის ენა.

ნაგულისხმევი: en

GET/air-quality/history/monthly?city=germany/berlin
curl "https://api.atmy.ai/v1/air-quality/history/monthly?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/"
  },
  "unit": "ug/m3",
  "method": "datahub_monthly",
  "period_timezone": "UTC",
  "notes": "A month is the mean of its sensors; a sensor is the mean of its quality-checked days. Yearly means use months with data on at least half of their days; only complete years (12 months) compare as a whole. The number of sensors grew over the years, so comparisons are approximate. source_daily_days / source_daily_sensors: values that include the daily means of the sensor network itself where no hourly readings were kept. weather: means of the readings Atmy stored for the city in the month, its lowest and highest temperature.",
  "since": "2025-01",
  "months": [
    {
      "month": "2025-01",
      "pm25": 8.1,
      "sensors": 174,
      "days_with_data": 30,
      "days": 31
    },
    {
      "month": "2025-02",
      "pm25": 14.5,
      "sensors": 175,
      "days_with_data": 28,
      "days": 28
    }
  ],
  "years": [
    {
      "year": "2025",
      "pm25": 9,
      "months": 12,
      "complete": true
    },
    {
      "year": "2026",
      "pm25": 8.7,
      "months": 10,
      "complete": false
    }
  ],
  "dirtiest_months": [
    {
      "month": "2026-01",
      "pm25": 18.3,
      "sensors": 191,
      "days_with_data": 31,
      "days": 31
    },
    {
      "month": "2026-02",
      "pm25": 15.8,
      "sensors": 193,
      "days_with_data": 28,
      "days": 28
    }
  ],
  "cleanest_months": [
    {
      "month": "2026-09",
      "pm25": 4.5,
      "sensors": 205,
      "days_with_data": 30,
      "days": 30
    },
    {
      "month": "2026-06",
      "pm25": 5.1,
      "sensors": 195,
      "days_with_data": 30,
      "days": 30
    }
  ],
  "dirtiest_days": [
    {
      "date": "2026-01-23",
      "pm25": 40.3,
      "sensors": 183
    },
    {
      "date": "2025-02-13",
      "pm25": 35.5,
      "sensors": 162
    }
  ],
  "cleanest_days": [
    {
      "date": "2025-04-06",
      "pm25": 1.7,
      "sensors": 173
    },
    {
      "date": "2025-04-07",
      "pm25": 1.7,
      "sensors": 170
    }
  ],
  "weather_since": "2026-01-19",
  "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."
}