SuperAPI AI 工具集

openaq-data-fetch

数据与分析

查看项目

更新于 10-16 03:39

技能介绍

用途:查询 OpenAQ API v3 端点获取元数据和测量数据,或从公共 OpenAQ S3 归档按前缀/键批量下载历史文件;支持自动路由:交互式或带过滤条件查询走 API,全量回填和按分区批量下载走 S3。

必要环境:API 请求需 OPENAQ_API_KEY;OPENAQ_REGION 可选,用于选择 S3 端点,未设置时默认 us-east-1;OPENAQ_S3_BUCKET 可选,默认 openaq-data-archive。

使用方式:先校验配置,运行 python3 scripts/openaq_api_client.py check-config 和 python3 scripts/openaq_s3_fetch.py check-config。API 示例:python3 scripts/openaq_api_client.py request --path /v3/locations --query countries_id=9 --query limit=100 --pretty,可用 --all-pages 与 --max-pages 跨页合并。S3 示例:ls 列分区前缀、build-prefix 构建 Hive 风格前缀、download 按 key 下载文件。自动路由示例:python3 scripts/openaq_router.py fetch --source-mode auto --volume-profile interactive …,full-backfill 配置可强制走 S3。

限制:API 速率限制为每分钟 60 次、每小时 2000 次,超限返回 429 Too Many Requests;S3 归档访问不受该速率限制。其他限制细节可参考 references/openaq-limitations.md。