Қызмет бүкіл Арал өңірі бойынша машина оқитын қатарларды ұсынады: үш елдегі 10 елді мекен бойынша PM10 және шаң, Әмудария мен Сырдария ағыны, теңіз айдынының жылдар бойынша ауданы және оқиғалар журналы (PM10 шектерінен асу).
Деректер ашық көздерден сағат сайынғы ingest арқылы жаңарады; тарих қызмет дерекқорында жинақталады.
Адал ескерту. Бұл ашық модельдік деректердің қайта жариялануы (Copernicus CAMS және GloFAS — Open-Meteo арқылы, Landsat суреттері) — алғашқы дереккөз де, жердегі өлшеулер де емес. Ғылыми қорытындылар үшін алғашқы дереккөздермен салыстырыңыз.
Сол API маршруттары ?format=csv параметрімен text/csv қайтарады: бірінші жол — тақырыптар, бөлгіш — үтір, кодтау — UTF-8 (Excel үшін BOM).
| Қатар | Сілтеме | Бағандар |
|---|---|---|
| Ауа сапасы: 24 сағаттық болжам | CSV | Сағат, елді мекен, PM10, PM2.5, шаң, AOD |
| Ауа райы: 24 сағаттық болжам | CSV | Сағат, елді мекен, температура °C, ылғалдылық %, жауын-шашын мм |
| Жел: 24 сағаттық болжам | CSV | Сағат, жылдамдық м/с, бағыт °, екпін м/с, ылғалдылық %, топырақ ылғалдылығы |
| Өзендер ағыны | CSV | Күн, өзен, бекет, шығын м³/с, болжам белгісі |
| 2050 жылға дейінгі климат проекциясы | CSV | Жыл, орташа температура °C, жауын-шашын қосындысы мм, модель |
| Теңіз ауданы жылдар бойынша | CSV | Жыл, аудан км², дереккөз, проекция белгісі |
| Су айдындарының деңгейі | CSV | Су айдыны, күн, деңгей м, дереккөз — DAHITI спутниктік альтиметриясы, нүктелер спутниктің тұрақты емес өтулері бойынша, сағат сайын емес |
| Оқиғалар журналы | CSV | Уақыт, елді мекен, деңгей, PM10, триггер және негіз |
| Оқиғалардың айлық мұрағаты | CSV | Ай, барлық оқиғалар, бақылау, ескерту, дабыл |
| Болжам дәлдігі | CSV | Сағат, елді мекен, горизонт сағ, болжам, факт |
| Елді мекендер | CSV | Код, атауы, ел, халқы, ендік, бойлық |
Базалық URL: https://api.aralkum.com
| Маршрут | Не қайтарады |
|---|---|
GET /meta | Қызметтік: деректердің соңғы жаңару уақыты және нұсқа |
GET /settlements | Елді мекендер: кодтар, елдер, координаттар |
GET /air-quality/forecast?hours=24 | Барлық мекендер бойынша 24 сағаттық ауа сапасы болжамы |
GET /wind/forecast?hours=24 | Жел болжамы (жылдамдық пен бағыт) |
GET /weather/forecast?hours=24 | Ауа райы болжамы: температура, жауын-шашын, топырақ ылғалдылығы |
GET /river/discharge?river=amudarya&days=120 | Әмудария немесе Сырдария ағыны (тарих + GloFAS болжамы) |
GET /climate/projection | 2050 жылға дейінгі климат проекциясы (CMIP6) |
GET /sea-area | Арал теңізінің жылдар бойынша ауданы (Landsat) |
GET /sea-level | Арал жүйесіндегі төрт су айдынының деңгейі (DAHITI альтиметриясы) |
GET /alerts | Белсенді оқиғалар (PM10 шектерінен асу) |
GET /alerts/archive | Оқиғалардың айлық мұрағаты |
GET /air-quality/accuracy | Болжам дәлдігі: болжам мен факт |
GET /ml/pm10-forecast?settlement=nukus&hours=24 | Мекен бойынша ML PM10 болжамы, сенім дәлізімен |
GET /ml/insight?lang=en | Жағдай бойынша AI-қорытынды (резервті режимі бар LLM) |
Мысал:
curl -s "https://api.aralkum.com/air-quality/forecast?hours=24"Аутентификация жоқ — барлық маршруттар ашық. Сұраныс жиілігін орынды ұстаңыз: деректер сағатына бір рет жаңарады, жиірек сұраудың мәні жоқ.
Дереккөз деректері өз лицензиялары бойынша пайдаланылады: Open-Meteo — CC BY 4.0; Copernicus деректері (CAMS, GloFAS) — Copernicus лицензиясы (дереккөзді көрсетіп еркін пайдалану); Landsat (USGS) — ашық деректер.
Қызметтің агрегаттары, ML-проекциялары және API дереккөзді көрсетіп еркін пайдаланылады: «Aral System (aralkum.com)».
Дәйексөз форматы:
Aral System (aralkum.com) — Арал өңірінің ашық деректері; дереккөздер: Copernicus CAMS/GloFAS via Open-Meteo (CC BY 4.0), Landsat (USGS).