AirVisual 云

airvisual 传感器平台查询 AirVisual 云 API 以获取空气质量数据。可以通过纬度/经度或城市/州/国家收集数据。

使用 AirVisual 云 API

AirVisual API 密钥可以在 这里 获得。请注意,该平台是使用“社区”包设计的;“Startup” 和 “Enterprise” 包的密钥应该继续有效,但实际结果可能会有所不同(或者根本无法使用)。

社区 API 密钥有效期为 12 个月,之后将过期。您必须返回 AirVisual 网站,删除旧密钥,按照相同的步骤创建新密钥并用新密钥更新配置。

Note

“社区”API 密钥每月限制为 10,000 次调用。为了适应在多个地理位置使用相同的 API 密钥,airvisual 集成将自动“重新调整” API 调用之间的时间,以避免超过调用限制。

例如:

  • 一个集成实例:每 5 分钟进行一次 API 调用

  • 两个集成实例:每 10 分钟进行一次 API 调用

  • 等等。

配置

要将 AirVisual 云 服务 添加到您的 Home Assistant 实例中,请使用此 My 按钮:

手动配置步骤

如果上述 My 按钮不起作用,您也可以手动执行以下步骤:

确定城市/州/国家

除了使用纬度和经度,AirVisual 集成还可以配置为使用城市/州/国家的组合。要轻松确定特定位置的正确值,请使用 AirVisual 区域目录。浏览到您想要的特定城市时,请注意面包屑标题,其形式为 国家 > 州/地区 > 城市

例如,巴西圣保罗的面包屑标题为 巴西 > 圣保罗 > 圣保罗。因此,在 UI 中使用的值将是:

  • 城市:圣保罗
  • 州:圣保罗
  • 国家:巴西

传感器类型

配置完成后,该平台将为每个空气质量标准创建三个传感器:

空气质量指数

  • 描述: 该传感器显示一个数值空气质量指数 (AQI),这是衡量空气整体“健康”的指标。
  • 示例传感器名称: sensor.chinese_air_quality_index
  • 示例传感器值: 32
  • 说明:
AQI 状态 描述
0 - 50 良好 空气质量被认为令人满意,空气污染带来的风险很小或没有风险
51 - 100 适中 空气质量可以接受;然而,对于某些污染物,可能对极少数对空气污染过敏的人存在适度的健康隐患
101 - 150 对敏感人群不健康 敏感人群可能会经历健康影响。普通人群不太可能受到影响
151 - 200 不健康 每个人可能开始经历健康影响;敏感人群可能会经历更严重的健康影响
201 - 300 非常不健康 健康警告:紧急情况。整个居民更可能受到影响
301+ 危险 健康警报:所有人可能会经历更严重的健康影响

空气污染水平

  • 描述: 该传感器显示当前 AQI 的相关 状态(来自上表)。
  • 示例传感器名称: sensor.us_air_pollution_level
  • 示例传感器值: 适中

主要污染物

  • 描述: 该传感器显示当前值最高的污染物。
  • 示例传感器名称: sensor.us_main_pollutant
  • 示例传感器值: PM2.5
  • 说明:
污染物 符号 更多信息
颗粒物 (<= 2.5 μm) PM2.5 EPA: 颗粒物 (PM) 污染
颗粒物 (<= 10 μm) PM10 EPA: 颗粒物 (PM) 污染
臭氧 O EPA: 臭氧污染
二氧化硫 SO2 EPA: 二氧化硫 (SO2) 污染
一氧化碳 CO EPA: 户外空气中的一氧化碳 (CO) 污染