API ცნობარი

სენსორები

Atmy-ის რუკის ყველა სენსორი მდებარეობით, ქსელით, ხარისხის შემოწმებითა და ჩვენებებით: PM1, PM2.5, PM10, ტემპერატურა, ტენიანობა, წნევა და მოწყობილობის სხვა არხები. რეგისტრაციისა და გასაღების გარეშე: ჩვეულებრივი GET მოთხოვნები.

სენსორების სია

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

Სენსორები ბოლო ჩვენებით, ხარისხითა და რეიტინგით, გვერდზე 100

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

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

Ქალაქის id ან slug, მაგალითად serbia/belgrade

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

Ქვეყნის slug, მაგალითად serbia

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

min_lon,min_lat,max_lon,max_lat

lat number არასავალდებულო

Სენსორები წერტილის გარშემო, 50 km-მდე

lon number არასავალდებულო

Სენსორები წერტილის გარშემო, 50 km-მდე

radius_km number არასავალდებულო

Სენსორები წერტილის გარშემო, 50 km-მდე

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

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

sensor_community, airgradient ან atmy

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

All ან passed

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

min_rating number არასავალდებულო

Მხოლოდ სენსორები, რომელთა რეიტინგი არანაკლებ ამდენია, 0-დან 10-მდე

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

Id ან rating: ჯერ ყველაზე სანდო სენსორები

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

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

Გვერდები 500 სენსორამდე

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

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

Გვერდები 500 სენსორამდე

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

GET/sensors?city=serbia/belgrade&sort=rating&limit=10

curl "https://api.atmy.ai/v1/sensors?city=serbia/belgrade&sort=rating&limit=10"

const response = await fetch("https://api.atmy.ai/v1/sensors?city=serbia/belgrade&sort=rating&limit=10");
const data = await response.json();

import requests

data = requests.get("https://api.atmy.ai/v1/sensors?city=serbia/belgrade&sort=rating&limit=10").json()

200პასუხი

{
  "api_version": "2.0",
  "total": 31,
  "page": 1,
  "limit": 2,
  "sensors": [
    {
      "id": 41504,
      "uuid": "b4e7f10c-bd0b-4234-aff9-41d9222affd0",
      "name": "Belgrade BIG Fashion Park",
      "network": "AirGradient",
      "network_id": "airgradient",
      "license": "CC BY-SA 4.0",
      "location": {
        "lat": 44.81659101498,
        "lon": 20.511912304712
      },
      "city": {
        "id": 50068,
        "slug": "serbia/belgrade",
        "name": "Belgrade",
        "country": "Serbia"
      },
      "quality": {
        "status": "good",
        "date": "2026-10-26",
        "pm_eligible": true,
        "rating": 10,
        "rating_7d": 10,
        "scores": {
          "pm": 10,
          "transport": 10,
          "meteo": 10
        },
        "reasons": []
      },
      "latest": {
        "time": "2026-10-27T11:03:35+00:00",
        "pm1": 8.4,
        "pm25": 13.8,
        "pm10": 14.5,
        "temperature_c": 14.4,
        "humidity_percent": 47
      }
    },
    {
      "id": 41752,
      "uuid": "611c7e92-5462-4f8c-8766-7cfaf69fba84",
      "name": "for map",
      "network": "AirGradient",
      "network_id": "airgradient",
      "license": "CC BY-SA 4.0",
      "location": {
        "lat": 44.790233610673,
        "lon": 20.470308143789
      },
      "city": {
        "id": 50068,
        "slug": "serbia/belgrade",
        "name": "Belgrade",
        "country": "Serbia"
      },
      "quality": {
        "status": "good",
        "date": "2026-10-26",
        "pm_eligible": true,
        "rating": 10,
        "rating_7d": 10,
        "scores": {
          "pm": 10,
          "transport": 10,
          "meteo": 10
        },
        "reasons": []
      },
      "latest": {
        "time": "2026-10-27T11:03:34+00:00",
        "pm1": 3,
        "pm25": 6,
        "pm10": 7,
        "temperature_c": 17.7,
        "humidity_percent": 40,
        "tvoc": 117.4
      }
    }
  ],
  "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/"
}

ერთი ქსელის სენსორები

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

იგივე სია მხოლოდ ერთი ქსელისთვის, იგივე ფილტრებით.

გზის პარამეტრები

network string სავალდებულო

sensor_community, airgradient ან atmy.

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

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

Ქალაქის id ან slug, მაგალითად serbia/belgrade

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

Ქვეყნის slug, მაგალითად serbia

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

min_lon,min_lat,max_lon,max_lat

lat number არასავალდებულო

Სენსორები წერტილის გარშემო, 50 km-მდე

lon number არასავალდებულო

Სენსორები წერტილის გარშემო, 50 km-მდე

radius_km number არასავალდებულო

Სენსორები წერტილის გარშემო, 50 km-მდე

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

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

All ან passed

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

min_rating number არასავალდებულო

Მხოლოდ სენსორები, რომელთა რეიტინგი არანაკლებ ამდენია, 0-დან 10-მდე

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

Id ან rating: ჯერ ყველაზე სანდო სენსორები

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

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

Გვერდები 500 სენსორამდე

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

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

Გვერდები 500 სენსორამდე

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

GET/networks/atmy/sensors?sort=rating

curl "https://api.atmy.ai/v1/networks/atmy/sensors?sort=rating"

const response = await fetch("https://api.atmy.ai/v1/networks/atmy/sensors?sort=rating");
const data = await response.json();

import requests

data = requests.get("https://api.atmy.ai/v1/networks/atmy/sensors?sort=rating").json()

200პასუხი

{
  "api_version": "2.0",
  "total": 31,
  "page": 1,
  "limit": 2,
  "sensors": [
    {
      "id": 41504,
      "uuid": "b4e7f10c-bd0b-4234-aff9-41d9222affd0",
      "name": "Belgrade BIG Fashion Park",
      "network": "AirGradient",
      "network_id": "airgradient",
      "license": "CC BY-SA 4.0",
      "location": {
        "lat": 44.81659101498,
        "lon": 20.511912304712
      },
      "city": {
        "id": 50068,
        "slug": "serbia/belgrade",
        "name": "Belgrade",
        "country": "Serbia"
      },
      "quality": {
        "status": "good",
        "date": "2026-10-26",
        "pm_eligible": true,
        "rating": 10,
        "rating_7d": 10,
        "scores": {
          "pm": 10,
          "transport": 10,
          "meteo": 10
        },
        "reasons": []
      },
      "latest": {
        "time": "2026-10-27T11:03:35+00:00",
        "pm1": 8.4,
        "pm25": 13.8,
        "pm10": 14.5,
        "temperature_c": 14.4,
        "humidity_percent": 47
      }
    },
    {
      "id": 41752,
      "uuid": "611c7e92-5462-4f8c-8766-7cfaf69fba84",
      "name": "for map",
      "network": "AirGradient",
      "network_id": "airgradient",
      "license": "CC BY-SA 4.0",
      "location": {
        "lat": 44.790233610673,
        "lon": 20.470308143789
      },
      "city": {
        "id": 50068,
        "slug": "serbia/belgrade",
        "name": "Belgrade",
        "country": "Serbia"
      },
      "quality": {
        "status": "good",
        "date": "2026-10-26",
        "pm_eligible": true,
        "rating": 10,
        "rating_7d": 10,
        "scores": {
          "pm": 10,
          "transport": 10,
          "meteo": 10
        },
        "reasons": []
      },
      "latest": {
        "time": "2026-10-27T11:03:34+00:00",
        "pm1": 3,
        "pm25": 6,
        "pm10": 7,
        "temperature_c": 17.7,
        "humidity_percent": 40,
        "tvoc": 117.4
      }
    }
  ],
  "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/"
}

ერთი სენსორი

GEThttps://api.atmy.ai/v1/sensors/{id}

Ერთი სენსორი

გზის პარამეტრები

id string სავალდებულო

სენსორის id, როგორც სენსორების სიაში.

GET/sensors/41504

curl "https://api.atmy.ai/v1/sensors/41504"

const response = await fetch("https://api.atmy.ai/v1/sensors/41504");
const data = await response.json();

import requests

data = requests.get("https://api.atmy.ai/v1/sensors/41504").json()

200პასუხი

{
  "api_version": "2.0",
  "sensor": {
    "id": 41504,
    "uuid": "b4e7f10c-bd0b-4234-aff9-41d9222affd0",
    "name": "Belgrade BIG Fashion Park",
    "network": "AirGradient",
    "network_id": "airgradient",
    "license": "CC BY-SA 4.0",
    "location": {
      "lat": 44.81659101498,
      "lon": 20.511912304712
    },
    "city": {
      "id": 50068,
      "slug": "serbia/belgrade",
      "name": "Belgrade",
      "country": "Serbia"
    },
    "quality": {
      "status": "good",
      "date": "2026-10-26",
      "pm_eligible": true,
      "rating": 10,
      "rating_7d": 10,
      "scores": {
        "pm": 10,
        "transport": 10,
        "meteo": 10
      },
      "reasons": []
    },
    "latest": {
      "time": "2026-10-27T11:03:35+00:00",
      "pm1": 8.4,
      "pm25": 13.8,
      "pm10": 14.5,
      "temperature_c": 14.4,
      "humidity_percent": 47
    }
  },
  "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/"
}