Հանրային, միայն կարդալու համար JSON API։ Հիմնական ճանապարհ՝
https://airquality.am/{locale}/air-quality-app/v1/, որտեղ {locale}-ը en, ru կամ hy է։
Թույլատրվում է միայն GET։ Պատասխանները՝ application/json; charset=utf-8։
Ուղարկեք իմաստալից User-Agent (ձեր հավելվածի կամ նախագծի անունը)։ Այս էջի օրինակներում օգտագործվում է docs-example։
API-ն կարող եք օգտագործել անձնական վիջեթների, ինտեգրացիաների և այլ նախագծերի համար։ Բաց հրապարակման դեպքում որպես տվյալների աղբյուր նշեք airquality.am։
Ֆայլային արտահանումն ու լիցենզիան նկարագրված են բաց տվյալների էջում (տես նաև readme.txt և DbCL ֆայլերի համար)։
Օբյեկտ providers[] զանգվածում՝ stations.json պատասխանում։
| Դաշտ | Տիպ | Նկարագրություն |
|---|---|---|
id | string | Մատակարարի սլագ (օր.՝ Station.provider դաշտում) |
title | string | Մատակարարի անվանումը |
url | string | Կայքի մատակարարի էջ կամ դատարկ տող |
image | string | Լուսավոր թեմայի պատկերակի URL |
image_dark | string | Մուգ թեմայի պատկերակի URL |
Օբյեկտ stations[] զանգվածում կամ միակ պատասխանը station/{id}.json։
| Դաշտ | Տիպ | Նկարագրություն |
|---|---|---|
id | integer | Կայանի ID |
status | string | Կարգավիճակի տող (օր.՝ online, offline) |
title | string | Հասցե կամ անվանում հարցման լեզվով |
city | string|null | Քաղաք կամ null |
city_slug | string|null | Քաղաքի սլագ կամ null |
district | string|null | Շրջան կամ null |
district_slug | string|null | Շրջանի սլագ կամ null |
latitude | number | Լայնություն՝ տասնորդական աստիճաններով (WGS-84) |
longitude | number | Երկայնություն՝ տասնորդական աստիճաններով (WGS-84) |
is_bad_thp | boolean | Կասկածելի ջերմաստիճան/խոնավություն/մթնոլորտային ճնշում |
measurement_time | string|null | Վերջին չափման ժամ (ISO 8601) կամ null |
temperature | number|null | °C (միջին ժամային) |
humidity | number|null | Հարաբերական խոնավություն % |
pressure | number|null | Մթնոլորտային ճնշում պասկալներով (Պա) (ամբողջ թիվ)։ ԳՊա ստանալու համար բաժանել 100-ի |
aqi | integer|null | US EPA AQI՝ վերջին ժամային միջինից |
pm2.5 | number|null | PM2.5 µg/m³ |
pm2.5_raw | number|null | Չմշակված PM2.5 µg/m³ |
pm10 | number|null | PM10 µg/m³ |
pm1 | number|null | PM1 µg/m³ |
wind_speed | number|null | Քամու արագություն (մ/վ) |
wind_direction | string|null | Քամու ուղղություն (օր.՝ N, NE) |
uv | number|null | UV ինդեքս |
rain | number|null | Տեղումներ (մմ) |
no2 | number|null | NO₂ (ppb) |
so2 | number|null | SO₂ µg/m³ |
o3 | number|null | O₃ µg/m³ |
dust | number|null | Փոշի (PM) µg/m³ |
usvh | number|null | Ճառագայթման դոզայի հզորություն (µSv/ժ) |
lux | null | Պահված է; ներկայումս միշտ null |
provider | string | Մատակարարի սլագ (տես Provider.id) |
url | string | Կայանի էջի URL airquality.am-ում |
Օբյեկտներ regions[] զանգվածում՝ քաղաքի համար, կամ region/{slug}.json պատասխանը, եթե slug-ը քաղաք է։
| Դաշտ | Տիպ | Նկարագրություն |
|---|---|---|
slug | string | Քաղաքի սլագ |
title | string | Քաղաքի անվանումը հարցման լեզվով |
measurement_time | string|null | Ժամանակ օգտագործված համախմբման համար (ISO 8601) կամ null |
temperature | number|null | °C (ագրեգատ) |
humidity | number|null | Հարաբերական խոնավություն % |
pressure | number|null | Ինչ կայանում՝ պասկալներ (Պա)։ ԳՊա՝ բաժանել 100-ի |
aqi | integer|null | US EPA AQI |
pm2.5 | number|null | PM2.5 µg/m³ |
pm10 | number|null | PM10 µg/m³ |
no2 | number|null | NO₂ ppb |
url | string | Քաղաքի էջ airquality.am-ում |
map_latitude | number | Քարտեզի կենտրոնի լայնություն (տասնորդական աստիճաններ) |
map_longitude | number | Քարտեզի կենտրոնի երկայնություն (տասնորդական աստիճաններ) |
map_delta | number | Քարտեզի մասշտաբի պարամետր |
is_hidden | boolean | Թաքնված է արդյոք ցուցակներում |
Նույն դաշտերը, ինչ Region (քաղաք)՝ չափումների և քարտեզի համար, տարբերություններով՝ slug — շրջանի սլագ; title — շրջանի անուն; լրացուցիչ՝ city և city_slug — մայր քաղաքը։ Շրջանի օբյեկտում չկա is_hidden դաշտը։
Մեկ տարր 24h, 7d, 30d, 1y, 2y զանգվածներում։ Զանգվածը կարող է լինել դատարկ [], եթե պատուհանում տվյալ չկա (օր.՝ կայանը offline)։ Դաշտերը կարող են լինել null։
Կայանի պատմում կա avg_pm25_raw։ Շրջանի պատմում՝ station_count (avg_pm25_raw չկա)։
Ժամային շարքերում (24h, 7d) սովորաբար չկան min_* / max_* դաշտերը; 30d օրական կետերում կան և range_* զանգվածները, և min_* / max_*։
| Դաշտ | Տիպ | Նկարագրություն |
|---|---|---|
timestamp | string | Ինտերվալի սկիզբ (ISO 8601) |
avg_temperature | number|null | °C |
avg_humidity | number|null | Հարաբերական խոնավություն % |
avg_pressure | number|null | Ինչ ընթացիկ ցուցումները՝ պասկալներ (Պա)։ ԳՊա՝ բաժանել 100-ի |
avg_pm25 | number|null | PM2.5 µg/m³ |
avg_pm10 | number|null | PM10 µg/m³ |
avg_pm25_raw | number|null | Չմշակված PM2.5 µg/m³ (միայն կայանի պատմություն) |
avg_no2 | number|null | NO₂ ppb |
avg_usvh | number|null | µSv/ժ |
avg_dust | number|null | Փոշի (PM) µg/m³ |
avg_so2 | number|null | SO₂ µg/m³ |
avg_o3 | number|null | O₃ µg/m³ |
avg_wind_direction | number|null | Քամու ուղղություն (աստիճաններ՝ ժամասլաքի ուղությամբ հյուսիսից) |
avg_wind_speed | number|null | Քամու արագություն (մ/վ) |
total_rain | number|null | Տեղումներ ինտերվալի համար (մմ) |
station_count | number|null | Կայանների մոտավոր քանակ (միայն շրջանի պատմություն) |
range_temperature | [number, number]|null | [min, max] °C |
range_pm25 | [number, number]|null | [min, max] PM2.5 µg/m³ |
range_pm10 | [number, number]|null | [min, max] PM10 µg/m³ |
range_dust | [number, number]|null | [min, max] փոշի (PM) µg/m³ |
range_wind_speed | [number, number]|null | [min, max] քամու արագություն (մ/վ) |
range_aqi | [integer, integer]|null | [min, max] US EPA AQI |
aqi | integer|null | US EPA AQI |
min_temperature, max_temperature | number|null | Օրական և նմանատիպ ինտերվալներ՝ էքստրեմումներ °C; հաճախ 30d-ում, ոչ թե 24h/7d-ում |
min_pm25, max_pm25, min_pm10, max_pm10 | number|null | Նույն ինտերվալի կանոնները; արժեքներ՝ µg/m³ |
min_no2, max_no2 | number|null | Նույն ինտերվալի կանոնները; արժեքներ՝ ppb |
min_dust, max_dust | number|null | Նույն ինտերվալի կանոնները; փոշի (PM) µg/m³ |
min_wind_speed, max_wind_speed | number|null | Նույն ինտերվալի կանոնները; արժեքներ՝ մ/վ |
min_* / max_* դաշտերը համապատասխանում են range_* զանգվածի ծայրերին, երբ երկուսն էլ կան։
https://airquality.am/en/... հատվածում՝ en-ի փոխարեն կարող եք օգտագործել ru կամ hy։ Բոլոր օրինակներում՝
curl -sS -H 'User-Agent: docs-example' 'URL'
GET /v1/stations.jsonՊատասխան՝ { "providers": [...], "stations": [...], "regions": [...] }։ Կայանների ցանկում միայն տեսանելի, ոչ պարտադիր թաքցված կայաններ։
curl -sS -H 'User-Agent: docs-example' 'https://airquality.am/en/air-quality-app/v1/stations.json'
GET /v1/station/{id}.jsonՄեկ Station օբյեկտ։ 404, եթե ID չկա։
curl -sS -H 'User-Agent: docs-example' 'https://airquality.am/en/air-quality-app/v1/station/1.json'
GET /v1/station/{id}-history.jsonՕբյեկտ՝ հինգ HistoryPoint զանգվածներով՝ 24h (ժամային), 7d (ժամային), 30d (օրական), 1y (ամսական), 2y (ամսական)։ Օրինակում՝ կայան 126 (ստուգման պահին կան ժամային տվյալներ); offline կայանի զանգվածները կարող են լինել դատարկ։
curl -sS -H 'User-Agent: docs-example' 'https://airquality.am/en/air-quality-app/v1/station/126-history.json'
GET /v1/region/{slug}.jsonՄեկ Region օբյեկտ (քաղաք կամ շրջան)։ slug — փոքրատառ լատիներեն և գծիկներ (օր.՝ yerevan)։ 404, եթե չի գտնվել։
curl -sS -H 'User-Agent: docs-example' 'https://airquality.am/en/air-quality-app/v1/region/yerevan.json'
GET /v1/region/{slug}-history.jsonՆույն հինգ բանալիները, ինչ կայանի պատմությանում؛ շրջանի կետերում կա station_count։
curl -sS -H 'User-Agent: docs-example' 'https://airquality.am/en/air-quality-app/v1/region/yerevan-history.json'