開発者向け

API リファレンス

現在値

全センサーの最新値を 1 回のリクエストで、毎分更新

全センサーの現在値

GEThttps://api.atmy.ai/v1/sensors/current

1 つの IP アドレスから 1 分あたり 60 リクエスト、キー不要。各レスポンスに X-RateLimit-Remaining が含まれます。/v1/sensors/current は 1 分に 1 回作り直されるため、それより頻繁に取得しても同じデータです。

クエリパラメーター

network string 任意

sensor_community、airgradient、atmy

quality string 任意

All または passed

既定値: all

min_rating number 任意

評価がこの値以上のセンサーのみ(0〜10)

bbox string 任意

min_lon,min_lat,max_lon,max_lat

GET/sensors/current?quality=passed&min_rating=8
curl "https://api.atmy.ai/v1/sensors/current?quality=passed&min_rating=8"
200レスポンス
{
  "api_version": "2.0",
  "generated_at": "2026-10-27T11:11:32+00:00",
  "count": 1644,
  "sensors": [
    {
      "id": 40656,
      "network_id": "airgradient",
      "lat": 19.094645,
      "lon": 101.529558,
      "city": null,
      "time": "2026-10-27T11:03:32+00:00",
      "pm1": 2.8,
      "pm25": 6.4,
      "pm10": 7.3,
      "temperature_c": 31,
      "humidity_percent": 48,
      "tvoc": 110.1,
      "quality": {
        "status": "good",
        "pm_eligible": true,
        "rating": 10
      }
    },
    {
      "id": 40657,
      "network_id": "airgradient",
      "lat": -34.0467846944686,
      "lon": 151.1229561199615,
      "city": "australia/sydney",
      "time": "2026-10-27T11:02:53+00:00",
      "pm25": 1,
      "temperature_c": 22.6,
      "humidity_percent": 63,
      "tvoc": 293.3,
      "quality": {
        "status": "good",
        "pm_eligible": true,
        "rating": 10
      }
    }
  ],
  "attribution": "Sensor data: Atmy (atmy.ai), from the networks named in each sensor's \"network\", under that network's license.",
  "terms": "https://atmy.ai/legal/data/"
}

1 つのネットワークの現在値

GEThttps://api.atmy.ai/v1/networks/{network}/sensors/current

同じレスポンスを 1 つのネットワークに限定したものです。

パスパラメーター

network string 必須

sensor_community、airgradient、atmy のいずれか。

クエリパラメーター

quality string 任意

All または passed

既定値: all

min_rating number 任意

評価がこの値以上のセンサーのみ(0〜10)

bbox string 任意

min_lon,min_lat,max_lon,max_lat

GET/networks/airgradient/sensors/current?quality=passed
curl "https://api.atmy.ai/v1/networks/airgradient/sensors/current?quality=passed"
200レスポンス
{
  "api_version": "2.0",
  "generated_at": "2026-10-27T11:11:32+00:00",
  "count": 1644,
  "sensors": [
    {
      "id": 40656,
      "network_id": "airgradient",
      "lat": 19.094645,
      "lon": 101.529558,
      "city": null,
      "time": "2026-10-27T11:03:32+00:00",
      "pm1": 2.8,
      "pm25": 6.4,
      "pm10": 7.3,
      "temperature_c": 31,
      "humidity_percent": 48,
      "tvoc": 110.1,
      "quality": {
        "status": "good",
        "pm_eligible": true,
        "rating": 10
      }
    },
    {
      "id": 40657,
      "network_id": "airgradient",
      "lat": -34.0467846944686,
      "lon": 151.1229561199615,
      "city": "australia/sydney",
      "time": "2026-10-27T11:02:53+00:00",
      "pm25": 1,
      "temperature_c": 22.6,
      "humidity_percent": 63,
      "tvoc": 293.3,
      "quality": {
        "status": "good",
        "pm_eligible": true,
        "rating": 10
      }
    }
  ],
  "attribution": "Sensor data: Atmy (atmy.ai), from the networks named in each sensor's \"network\", under that network's license.",
  "terms": "https://atmy.ai/legal/data/"
}