跳转到内容
POST AI agent ready /v1/air-quality/check

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

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

Parameters

numberrequired

Latitude of the location to check.

numberrequired

Longitude of the location to check.

Code examples

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 或臭氧峰值阈值警报,并为设施经理生成每日空气质量报告。

Frequently asked questions

美国和欧洲的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+)。

Get your API key

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