POST AI agent ready /v1/air-quality/check

空气质量 API - AQI 和污染物水平（按坐标）

返回给定纬度和经度的当前空气质量指数（美国 EPA 和欧洲等级）和单个污染物浓度。污染物包括PM2.5、PM10、一氧化碳、二氧化氮、二氧化硫和臭氧。

Endpoint

curl -X POST https://api.botoi.com/v1/air-quality/check \
  -H "Content-Type: application/json" \
  -d '{"lat":40.7128,"lng":-74.006}'

When to use this API

在推荐户外活动之前检查当地空气质量。当 AQI 超过 100（对敏感人群不健康）时，建议进行室内锻炼，而不是在户外跑步或骑自行车。在应用程序仪表板中显示颜色编码的 AQI 徽章。

将空气质量分数添加到房产列表中。寻找房屋的买家可以按平均空气质量指数进行过滤，列表页面可以显示当前的污染物水平以及学校和交通等社区数据。

构建实时空气质量仪表板，每 30 分钟轮询多个位置的此端点。显示历史趋势，设置 PM2.5 或臭氧峰值阈值警报，并为设施经理生成每日空气质量报告。

美国和欧洲的AQI有什么区别？

美国 EPA 空气质量指数范围为 0-500，断点为 50（良好）、100（中等）、150（对敏感群体不健康）或更高。欧洲 AQI 采用 0-100+ 等级，具有不同的污染物权重。两者都会返回，以便您可以使用受众期望的规模。

污染物浓度用什么单位表示？

PM2.5 和 PM10 的单位为微克每立方米 (ug/m3)。一氧化碳的单位为ug/m3。二氧化氮、二氧化硫和臭氧的单位为ug/m3。这些是标准大气测量单位。

空气质量数据多久更新一次？

上游监测网络的空气质量读数每小时更新一次。对于大多数用例，缓存 30-60 分钟是合理的。

我可以获取城市名称而不是坐标的空气质量数据吗？

该端点需要纬度/经度坐标。首先使用 geo 地理编码端点将城市名称转换为坐标，然后将它们传递到此端点。

aqi_category 是什么意思？

aqi_category 字段返回基于 US EPA AQI 的人类可读标签：“良好”(0-50)、“中等”(51-100)、“对敏感群体不健康”(101-150)、“不健康”(151-200)、“非常不健康”(201-300) 或“危险”(301+)。

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.