AirVisual

airvisual传感器平台通过使用 AirVisual 的 API 向服务器获取制定经纬度地点或城市的空气质量数据。该平台支持的指数有：空气质量指数 (AQI)、空气质量等级及主要污染物。数据可选择使用美国标准和/或中国标准。

使用该平台要求已有 AirVisual API key，可知官网获取。 注意：申请时请选择 “Community” 类型，”Startup” 和 “Enterprise” 类的 key 可能在本平台无法工作。

“Community” API key 每月限制调用 10,000 次，因此本平台将调用时间设定为每 10 分钟 1 次以配合此限制。

Configuring the Platform via Latitude/Longitude

使用本平台并通过纬度/经度收集数据，将下列命令增添至 configuration.yaml 文件：

sensor:
  - platform: airvisual
    api_key: abc123
    monitored_conditions:
      - us
      - cn
    latitude: 42.81212
    longitude: 108.12422
    radius: 500

变量说明：

• api_key (必须): 你的 AirVisual API key
• monitored_conditions (必须): 数据标准 (us 为美国， cn 为中国)
• latitude (可选): 监测地区纬度；如果没有设定，默认为 configuration.yaml 中所设的系统纬度
• longitude (可选): 监测地区经度；如果没有设定，默认为 configuration.yaml 中所设的系统经度
• radius (可选): 监测范围，即监测距离所涉中心点多大范围内城市的数据；默认为 1000；单位默认为米

Configuring the Platform via City/State/Country

To enable the platform and gather data via city/state/country, add the following lines to your configuration.yaml file:

sensor:
  - platform: airvisual
    api_key: abc123
    monitored_conditions:
      - us
      - cn
    city: southend-on-sea
    state: essex
    country: uk

Configuration variables:

• api_key (Required): your AirVisual API key
• monitored_conditions (Required): the air quality standard(s) to use (us for U.S., cn for Chinese)
• city (Optional): the city to monitor
• state (Optional): the state/region to monitor
• country (Optional): the country to monitor

To easily determine the proper values for a particular location, use the AirVisual region directory. Once you browse to the particular city you want, take note of the breadcrumb title, which is of the form country > state/region > city. Use this information to fill out configuration.yaml.

For example, Sao Paulo, Brazil shows a breadcrumb title of Brazil > Sao Paulo > Sao Paulo – thus, the proper configuration would look like this:

sensor:
  - platform: airvisual
    api_key: abc123
    monitored_conditions:
      - us
      - cn
    city: sao-paulo
    state: sao-paulo
    country: brazil

Sensor Types

平台接入后，将会生成 3 个传感器显示所监测的数据，包括：

空气质量指数

描述： 该传感器显示 AQI 数值

示例传感器 ID： sensor.chinese_air_quality_index

示例传感器值： 32

解释：

空气污染等级

描述： 该传感器显示空气污染等级

示例传感器 ID： sensor.us_air_pollution_level

示例传感器值： Moderate

主要污染物

描述： 该传感器显示主要污染物

示例传感器 ID： sensor.us_main_pollutant

示例传感器值： PM2.5

Explanation: