開発者向け

API リファレンス

国内都市ランキング

直近の完了日のPM2.5日平均に基づく国内都市のランキングです。汚染が最も深刻な都市、または最もきれいな都市から順に並べます。大都市のみ、またはすべての集落を対象にできます。

国内都市ランキング

GEThttps://api.atmy.ai/v1/ranking

クエリパラメーター

country string 必須

サイトのいずれかの言語での国名、または ISO コード。

order string 任意

most_polluted または cleanest を先に。

既定値: most_polluted

settlements string 任意

cities — 大都市のみ、all — センサーが十分あるすべての集落。

既定値: cities

limit integer 任意

都市の数、50 まで。

既定値: 10

lang string 任意

都市名・国名とページリンクの言語。

既定値: en

GET/ranking?country=Germany&limit=10
curl "https://api.atmy.ai/v1/ranking?country=Germany&limit=10"
200レスポンス
{
  "country": "Germany",
  "date": "2026-10-26",
  "period": "2026-10-26T00:00:00Z/2026-10-27T00:00:00Z",
  "order": "most_polluted",
  "settlements": "cities",
  "unit": "ug/m3",
  "method": "datahub_daily",
  "category_scale": "US_EPA_2024",
  "count": 76,
  "cities": [
    {
      "rank": 1,
      "id": 52005,
      "name": "Flensburg",
      "pm25": 39.2,
      "level": "unhealthy_for_sensitive_groups",
      "sensors": 10
    },
    {
      "rank": 2,
      "id": 52151,
      "name": "Würzburg",
      "pm25": 22.2,
      "level": "moderate",
      "sensors": 5
    }
  ]
}