开放数据
本服务提供覆盖整个咸海地区的机器可读数据序列：三国 10 个居民点的 PM10 与沙尘、阿姆河与锡尔河径流、咸海水面面积逐年数据，以及事件日志（PM10 阈值超标）。
数据通过每小时一次的 ingest 从开放来源更新；历史数据累积在服务数据库中。
诚实说明。这是对开放模型数据的再发布（Copernicus CAMS 与 GloFAS——经 Open-Meteo，Landsat 影像），并非原始数据源，也不是地面实测。用于科研结论请与原始数据源核对。
CSV 导出
同一批 API 路由加上 ?format=csv 参数即返回 text/csv：首行为表头，逗号分隔，UTF-8 编码（含 BOM，便于 Excel 打开）。
| 序列 | 链接 | 列 |
|---|---|---|
| 空气质量：24 小时预报 | CSV | 小时、居民点、PM10、PM2.5、沙尘、AOD |
| 天气：24 小时预报 | CSV | 小时、居民点、气温 °C、湿度 %、降水 mm |
| 风力：24 小时预报 | CSV | 小时、风速 m/s、风向 °、阵风 m/s、湿度 %、土壤湿度 |
| 河流径流 | CSV | 日期、河流、站点、流量 m³/s、预报标记 |
| 至 2050 年的气候预估 | CSV | 年份、年均气温 °C、降水总量 mm、模型 |
| 咸海面积（逐年） | CSV | 年份、面积 km²、来源、外推标记 |
| 各水体水位 | CSV | 水体、日期、水位 m、来源——DAHITI 卫星测高，数据点随卫星不定期过境产生，并非逐小时 |
| 事件日志 | CSV | 时间、居民点、级别、PM10、触发条件与依据 |
| 事件月度归档 | CSV | 月份、事件总数、关注、警告、紧急 |
| 预报准确度 | CSV | 时间、居民点、时效（小时）、预报值、实测值 |
| 居民点 | CSV | 代码、名称、国家、人口、纬度、经度 |
REST API
基础 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)。