资源描述
AirQo docs 是乌干达 Makerere 大学主导的开源空气质量监测平台 AirQo 的官方技术文档站点，提供设备部署、数据采集、API 接口、数据可视化及平台管理等完整技术指南。适用于环境科研人员、城市管理者、开发者及 NGO 技术团队，助力低成本、高精度的本地化空气监测系统建设与运维。
详细内容
## 网站概述
AirQo docs（https://wiki.airqo.net）是 AirQo 项目官方维护的技术文档中心，由乌干达 Makerere 大学人工智能研究实验室（AIRL）牵头开发与运营。AirQo 致力于通过低成本物联网传感器网络、边缘计算与开放数据平台，提升非洲及全球发展中国家在空气质量监测领域的自主能力。该文档站点并非简单的产品说明书，而是面向技术实践者构建的综合性知识库，涵盖从硬件选型、固件烧录、网关配置、LoRaWAN/4G 数据回传，到 AirQo 平台数据接入、RESTful API 使用、Python/R 数据分析示例、仪表板定制，以及符合 WHO 和 EPA 标准的数据校准方法等全链路内容。所有文档均基于真实部署案例（如坎帕拉、内罗毕、基加利等城市监测网络），强调可复现性、本地适配性与开源协作精神，支持多语言（含部分斯瓦希里语注释），并持续随 AirQo 平台 v2.x 架构迭代更新。
## 核心功能与特色
- **模块化文档体系**：按用户角色分层组织——‘For Deployers’（设备部署）、‘For Developers’（API 与 SDK）、‘For Data Scientists’（数据质量评估与建模）、‘For City Managers’（仪表盘解读与报告生成）；
- **实操导向的教程**：提供带截图与 CLI 命令的详细操作指南，例如：如何使用 `airqo-api-cli` 工具批量注册传感器、如何配置 Raspberry Pi 网关连接 AirQo Cloud、如何调用 `/v2/devices/measurement` 获取实时 PM2.5 数据；
- **开放标准兼容性说明**：明确标注各组件遵循的协议标准（如 SensorML 元数据规范、MQTT v3.1.1、GeoJSON 地理编码格式），便于与第三方系统（如 OpenAQ、QGIS、ThingsBoard）集成；
- **数据可信度保障文档**：详述 AirQo 的双阶段校准流程（实验室基准校准 + 现场动态校准模型）、不确定性量化方法（如 Kriging 插值误差范围）、以及原始传感器读数与发布数据间的转换逻辑；
- **社区贡献机制指引**：提供文档翻译、案例提交、Issue 提报与 PR 合并规范，所有文档源码托管于 GitHub（airqo-platform/docs），支持版本追溯与协作编辑。
## 适用人群与使用场景
- **环境科研人员**：快速获取符合学术引用规范的传感器技术参数、数据采集频率、时空分辨率及质控标记说明，支撑区域污染溯源或健康暴露评估研究；
- **地方政府与环保部门**：参考‘City Deployment Playbook’搭建属地化监测网络，利用预置的合规报告模板（PDF/Excel）生成向国家环保局提交的季度空气质量简报；
- **IoT 开发者与系统集成商**：基于清晰的 API 文档与 Swagger UI 实例，将 AirQo 数据流接入自有智慧城市平台或预警系统；
- **高校教学与实训团队**：选用文档中提供的 Docker Compose 环境模拟 AirQo 本地测试集群，开展传感器网络、边缘计算与环境大数据课程实验。
## 使用建议或入门步骤
1. **明确目标角色**：首次访问时，优先点击顶部导航栏的 ‘Role-Based Guides’，选择对应身份路径（如开发者应进入 ‘API Documentation’ → ‘Authentication’ 获取 JWT 配置说明）；
2. **验证环境依赖**：确认已安装 Python 3.8+、curl 及 jq 工具（Linux/macOS）或 PowerShell（Windows），部分 CLI 示例需提前配置 `AIRQO_API_TOKEN` 环境变量；
3. **从最小可行案例启动**：推荐先完成 ‘Quickstart: Get Your First Measurement’ 教程——仅需 10 分钟即可通过 Postman 调用公开沙箱 API（`https://api.airqo.net/api/v2/devices/measurements?device_id=xxx`）获取模拟数据；
4. **订阅变更通知**：在文档页脚点击 ‘Watch this repository’ 关注 GitHub 仓库更新，或订阅 AirQo 官方 Newsletter 获取文档重大修订与新功能发布提醒；
5. **反馈与共建**：发现文档错误或缺失内容时，在对应页面右下角点击 ‘Edit this page on GitHub’ 提交修正，所有贡献者将列入 AirQo 官网致谢名单。