Add Airly integration (#26375)

* Add Airly integration

* Update .coveragerc file

* Remove AVAILABLE_CONDITIONS and fix device_class

* Don't create client on every update

* Rename client to session

* Rename state_attributes to device_state_attributes

* Remove log latitude and longitude

* Fix try...except

* Change latitude and longitude to HA defaults

* _show_config_form doesn't need coroutine

* Simplify config_flow errors handlig

* Preetier

* Remove unnecessary condition

* Change sensor platform to air_quality

* Remove PM1

* Make unique_id more unique

* Remove ,

* Add tests for config_flow

* Move conf to CONFIG

* Remove domain from unique_id

* Change the way update of attrs

* Language and attrs

* Fix attrs

* Add aiohttp error handling

* Throttle as decorator

* Suggested change

* Suggested change

* Invert condition

* Cleaning

* Add tests

* Polish no sesnor error handling

* Better strings

* Fix test_invalid_api_key

* Fix documentation url

* Remove unnecessary test

* Remove language option

* Fix test_invalid_api_key once again

* Sort imports

* Remove splits in strings

.coveragerc

@@ -19,6 +19,9 @@ omit =
     homeassistant/components/adguard/switch.py
     homeassistant/components/ads/*
     homeassistant/components/aftership/sensor.py
+    homeassistant/components/airly/__init__.py
+    homeassistant/components/airly/air_quality.py
+    homeassistant/components/airly/const.py
     homeassistant/components/airvisual/sensor.py
     homeassistant/components/aladdin_connect/cover.py
     homeassistant/components/alarm_control_panel/manual_mqtt.py

CODEOWNERS

@@ -14,6 +14,7 @@ homeassistant/scripts/check_config.py @kellerza
 
 # Integrations
 homeassistant/components/adguard/* @frenck
+homeassistant/components/airly/* @bieniu
 homeassistant/components/airvisual/* @bachya
 homeassistant/components/alarm_control_panel/* @colinodell
 homeassistant/components/alexa/* @home-assistant/cloud

homeassistant/components/airly/__init__.py

@@ -0,0 +1,21 @@
+"""The Airly component."""
+from homeassistant.core import Config, HomeAssistant
+
+
+async def async_setup(hass: HomeAssistant, config: Config) -> bool:
+    """Set up configured Airly."""
+    return True
+
+
+async def async_setup_entry(hass, config_entry):
+    """Set up Airly as config entry."""
+    hass.async_create_task(
+        hass.config_entries.async_forward_entry_setup(config_entry, "air_quality")
+    )
+    return True
+
+
+async def async_unload_entry(hass, config_entry):
+    """Unload a config entry."""
+    await hass.config_entries.async_forward_entry_unload(config_entry, "air_quality")
+    return True

homeassistant/components/airly/air_quality.py

@@ -0,0 +1,201 @@
+"""Support for the Airly service."""
+import asyncio
+import logging
+from datetime import timedelta
+
+import async_timeout
+from aiohttp.client_exceptions import ClientConnectorError
+from airly import Airly
+from airly.exceptions import AirlyError
+
+from homeassistant.const import CONF_API_KEY, CONF_LATITUDE, CONF_LONGITUDE, CONF_NAME
+from homeassistant.components.air_quality import (
+    AirQualityEntity,
+    ATTR_AQI,
+    ATTR_PM_10,
+    ATTR_PM_2_5,
+)
+from homeassistant.helpers.aiohttp_client import async_get_clientsession
+from homeassistant.util import Throttle
+
+from .const import NO_AIRLY_SENSORS
+
+_LOGGER = logging.getLogger(__name__)
+
+ATTRIBUTION = "Data provided by Airly"
+
+ATTR_API_ADVICE = "ADVICE"
+ATTR_API_CAQI = "CAQI"
+ATTR_API_CAQI_DESCRIPTION = "DESCRIPTION"
+ATTR_API_CAQI_LEVEL = "LEVEL"
+ATTR_API_PM10 = "PM10"
+ATTR_API_PM10_LIMIT = "PM10_LIMIT"
+ATTR_API_PM10_PERCENT = "PM10_PERCENT"
+ATTR_API_PM25 = "PM25"
+ATTR_API_PM25_LIMIT = "PM25_LIMIT"
+ATTR_API_PM25_PERCENT = "PM25_PERCENT"
+
+LABEL_ADVICE = "advice"
+LABEL_AQI_LEVEL = f"{ATTR_AQI}_level"
+LABEL_PM_2_5_LIMIT = f"{ATTR_PM_2_5}_limit"
+LABEL_PM_2_5_PERCENT = f"{ATTR_PM_2_5}_percent_of_limit"
+LABEL_PM_10_LIMIT = f"{ATTR_PM_10}_limit"
+LABEL_PM_10_PERCENT = f"{ATTR_PM_10}_percent_of_limit"
+
+DEFAULT_SCAN_INTERVAL = timedelta(minutes=10)
+
+
+async def async_setup_entry(hass, config_entry, async_add_entities):
+    """Add a Airly entities from a config_entry."""
+    api_key = config_entry.data[CONF_API_KEY]
+    name = config_entry.data[CONF_NAME]
+    latitude = config_entry.data[CONF_LATITUDE]
+    longitude = config_entry.data[CONF_LONGITUDE]
+
+    websession = async_get_clientsession(hass)
+
+    data = AirlyData(websession, api_key, latitude, longitude)
+
+    async_add_entities([AirlyAirQuality(data, name)], True)
+
+
+def round_state(func):
+    """Round state."""
+
+    def _decorator(self):
+        res = func(self)
+        if isinstance(res, float):
+            return round(res)
+        return res
+
+    return _decorator
+
+
+class AirlyAirQuality(AirQualityEntity):
+    """Define an Airly air_quality."""
+
+    def __init__(self, airly, name):
+        """Initialize."""
+        self.airly = airly
+        self.data = airly.data
+        self._name = name
+        self._pm_2_5 = None
+        self._pm_10 = None
+        self._aqi = None
+        self._icon = "mdi:blur"
+        self._attrs = {}
+
+    @property
+    def name(self):
+        """Return the name."""
+        return self._name
+
+    @property
+    def icon(self):
+        """Return the icon."""
+        return self._icon
+
+    @property
+    @round_state
+    def air_quality_index(self):
+        """Return the air quality index."""
+        return self._aqi
+
+    @property
+    @round_state
+    def particulate_matter_2_5(self):
+        """Return the particulate matter 2.5 level."""
+        return self._pm_2_5
+
+    @property
+    @round_state
+    def particulate_matter_10(self):
+        """Return the particulate matter 10 level."""
+        return self._pm_10
+
+    @property
+    def attribution(self):
+        """Return the attribution."""
+        return ATTRIBUTION
+
+    @property
+    def state(self):
+        """Return the CAQI description."""
+        return self.data[ATTR_API_CAQI_DESCRIPTION]
+
+    @property
+    def unique_id(self):
+        """Return a unique_id for this entity."""
+        return f"{self.airly.latitude}-{self.airly.longitude}"
+
+    @property
+    def available(self):
+        """Return True if entity is available."""
+        return bool(self.airly.data)
+
+    @property
+    def device_state_attributes(self):
+        """Return the state attributes."""
+        self._attrs[LABEL_ADVICE] = self.data[ATTR_API_ADVICE]
+        self._attrs[LABEL_AQI_LEVEL] = self.data[ATTR_API_CAQI_LEVEL]
+        self._attrs[LABEL_PM_2_5_LIMIT] = self.data[ATTR_API_PM25_LIMIT]
+        self._attrs[LABEL_PM_2_5_PERCENT] = round(self.data[ATTR_API_PM25_PERCENT])
+        self._attrs[LABEL_PM_10_LIMIT] = self.data[ATTR_API_PM10_LIMIT]
+        self._attrs[LABEL_PM_10_PERCENT] = round(self.data[ATTR_API_PM10_PERCENT])
+        return self._attrs
+
+    async def async_update(self):
+        """Get the data from Airly."""
+        await self.airly.async_update()
+
+        self._pm_10 = self.data[ATTR_API_PM10]
+        self._pm_2_5 = self.data[ATTR_API_PM25]
+        self._aqi = self.data[ATTR_API_CAQI]
+
+
+class AirlyData:
+    """Define an object to hold sensor data."""
+
+    def __init__(self, session, api_key, latitude, longitude):
+        """Initialize."""
+        self.latitude = latitude
+        self.longitude = longitude
+        self.airly = Airly(api_key, session)
+        self.data = {}
+
+    @Throttle(DEFAULT_SCAN_INTERVAL)
+    async def async_update(self):
+        """Update Airly data."""
+
+        try:
+            with async_timeout.timeout(10):
+                measurements = self.airly.create_measurements_session_point(
+                    self.latitude, self.longitude
+                )
+                await measurements.update()
+
+            values = measurements.current["values"]
+            index = measurements.current["indexes"][0]
+            standards = measurements.current["standards"]
+
+            if index["description"] == NO_AIRLY_SENSORS:
+                _LOGGER.error("Can't retrieve data: no Airly sensors in this area")
+                return
+            for value in values:
+                self.data[value["name"]] = value["value"]
+            for standard in standards:
+                self.data[f"{standard['pollutant']}_LIMIT"] = standard["limit"]
+                self.data[f"{standard['pollutant']}_PERCENT"] = standard["percent"]
+            self.data[ATTR_API_CAQI] = index["value"]
+            self.data[ATTR_API_CAQI_LEVEL] = index["level"].lower().replace("_", " ")
+            self.data[ATTR_API_CAQI_DESCRIPTION] = index["description"]
+            self.data[ATTR_API_ADVICE] = index["advice"]
+            _LOGGER.debug("Data retrieved from Airly")
+        except (
+            ValueError,
+            AirlyError,
+            asyncio.TimeoutError,
+            ClientConnectorError,
+        ) as error:
+            _LOGGER.error(error)
+            self.data = {}

homeassistant/components/airly/config_flow.py

@@ -0,0 +1,114 @@
+"""Adds config flow for Airly."""
+import async_timeout
+import voluptuous as vol
+from airly import Airly
+from airly.exceptions import AirlyError
+
+import homeassistant.helpers.config_validation as cv
+from homeassistant import config_entries
+from homeassistant.const import CONF_API_KEY, CONF_LATITUDE, CONF_LONGITUDE, CONF_NAME
+from homeassistant.core import callback
+from homeassistant.helpers.aiohttp_client import async_get_clientsession
+
+from .const import DEFAULT_NAME, DOMAIN, NO_AIRLY_SENSORS
+
+
+@callback
+def configured_instances(hass):
+    """Return a set of configured Airly instances."""
+    return set(
+        entry.data[CONF_NAME] for entry in hass.config_entries.async_entries(DOMAIN)
+    )
+
+
+class AirlyFlowHandler(config_entries.ConfigFlow, domain=DOMAIN):
+    """Config flow for Airly."""
+
+    VERSION = 1
+    CONNECTION_CLASS = config_entries.CONN_CLASS_CLOUD_POLL
+
+    def __init__(self):
+        """Initialize."""
+        self._errors = {}
+
+    async def async_step_user(self, user_input=None):
+        """Handle a flow initialized by the user."""
+        self._errors = {}
+
+        websession = async_get_clientsession(self.hass)
+
+        if user_input is not None:
+            if user_input[CONF_NAME] in configured_instances(self.hass):
+                self._errors[CONF_NAME] = "name_exists"
+            api_key_valid = await self._test_api_key(websession, user_input["api_key"])
+            if not api_key_valid:
+                self._errors["base"] = "auth"
+            else:
+                location_valid = await self._test_location(
+                    websession,
+                    user_input["api_key"],
+                    user_input["latitude"],
+                    user_input["longitude"],
+                )
+                if not location_valid:
+                    self._errors["base"] = "wrong_location"
+
+            if not self._errors:
+                return self.async_create_entry(
+                    title=user_input[CONF_NAME], data=user_input
+                )
+
+        return self._show_config_form(
+            name=DEFAULT_NAME,
+            api_key="",
+            latitude=self.hass.config.latitude,
+            longitude=self.hass.config.longitude,
+        )
+
+    def _show_config_form(self, name=None, api_key=None, latitude=None, longitude=None):
+        """Show the configuration form to edit data."""
+        return self.async_show_form(
+            step_id="user",
+            data_schema=vol.Schema(
+                {
+                    vol.Required(CONF_API_KEY, default=api_key): str,
+                    vol.Optional(
+                        CONF_LATITUDE, default=self.hass.config.latitude
+                    ): cv.latitude,
+                    vol.Optional(
+                        CONF_LONGITUDE, default=self.hass.config.longitude
+                    ): cv.longitude,
+                    vol.Optional(CONF_NAME, default=name): str,
+                }
+            ),
+            errors=self._errors,
+        )
+
+    async def _test_api_key(self, client, api_key):
+        """Return true if api_key is valid."""
+
+        with async_timeout.timeout(10):
+            airly = Airly(api_key, client)
+            measurements = airly.create_measurements_session_point(
+                latitude=52.24131, longitude=20.99101
+            )
+            try:
+                await measurements.update()
+            except AirlyError:
+                return False
+            return True
+
+    async def _test_location(self, client, api_key, latitude, longitude):
+        """Return true if location is valid."""
+
+        with async_timeout.timeout(10):
+            airly = Airly(api_key, client)
+            measurements = airly.create_measurements_session_point(
+                latitude=latitude, longitude=longitude
+            )
+
+            await measurements.update()
+        current = measurements.current
+        if current["indexes"][0]["description"] == NO_AIRLY_SENSORS:
+            return False
+        return True

homeassistant/components/airly/const.py

@@ -0,0 +1,4 @@
+"""Constants for Airly integration."""
+DEFAULT_NAME = "Airly"
+DOMAIN = "airly"
+NO_AIRLY_SENSORS = "There are no Airly sensors in this area yet."

homeassistant/components/airly/manifest.json

@@ -0,0 +1,9 @@
+{
+  "domain": "airly",
+  "name": "Airly",
+  "documentation": "https://www.home-assistant.io/integrations/airly",
+  "dependencies": [],
+  "codeowners": ["@bieniu"],
+  "requirements": ["airly==0.0.2"],
+  "config_flow": true
+}

homeassistant/components/airly/strings.json

@@ -0,0 +1,22 @@
+{
+  "config": {
+    "title": "Airly",
+    "step": {
+      "user": {
+        "title": "Airly",
+        "description": "Set up Airly air quality integration. To generate API key go to https://developer.airly.eu/register",
+        "data": {
+          "name": "Name of the integration",
+          "api_key": "Airly API key",
+          "latitude": "Latitude",
+          "longitude": "Longitude"
+        }
+      }
+    },
+    "error": {
+      "name_exists": "Name already exists.",
+      "wrong_location": "No Airly measuring stations in this area.",
+      "auth": "API key is not correct."
+    }
+  }
+}

homeassistant/generated/config_flows.py

@@ -7,6 +7,7 @@ To update, run python3 -m script.hassfest
 
 FLOWS = [
     "adguard",
+    "airly",
     "ambiclimate",
     "ambient_station",
     "axis",

requirements_all.txt

@@ -184,6 +184,9 @@ aiounifi==11
 # homeassistant.components.wwlln
 aiowwlln==2.0.2
 
+# homeassistant.components.airly
+airly==0.0.2
+
 # homeassistant.components.aladdin_connect
 aladdin_connect==0.3
 

requirements_test_all.txt

@@ -76,6 +76,9 @@ aiounifi==11
 # homeassistant.components.wwlln
 aiowwlln==2.0.2
 
+# homeassistant.components.airly
+airly==0.0.2
+
 # homeassistant.components.ambiclimate
 ambiclimate==0.2.1
 

script/gen_requirements_all.py

@@ -54,6 +54,7 @@ TEST_REQUIREMENTS = (
     "aioswitcher",
     "aiounifi",
     "aiowwlln",
+    "airly",
     "ambiclimate",
     "androidtv",
     "apns2",

tests/components/airly/__init__.py

@@ -0,0 +1 @@
+"""Tests for Airly."""

tests/components/airly/test_config_flow.py

@@ -0,0 +1,93 @@
+"""Define tests for the Airly config flow."""
+import json
+
+from airly.exceptions import AirlyError
+from asynctest import patch
+
+from homeassistant import data_entry_flow
+from homeassistant.const import CONF_API_KEY, CONF_LATITUDE, CONF_LONGITUDE, CONF_NAME
+from homeassistant.components.airly import config_flow
+from homeassistant.components.airly.const import DOMAIN
+
+from tests.common import load_fixture, MockConfigEntry
+
+CONFIG = {
+    CONF_NAME: "abcd",
+    CONF_API_KEY: "foo",
+    CONF_LATITUDE: 123,
+    CONF_LONGITUDE: 456,
+}
+
+
+async def test_show_form(hass):
+    """Test that the form is served with no input."""
+    flow = config_flow.AirlyFlowHandler()
+    flow.hass = hass
+
+    result = await flow.async_step_user(user_input=None)
+
+    assert result["type"] == data_entry_flow.RESULT_TYPE_FORM
+    assert result["step_id"] == "user"
+
+
+async def test_invalid_api_key(hass):
+    """Test that errors are shown when API key is invalid."""
+    with patch(
+        "airly._private._RequestsHandler.get",
+        side_effect=AirlyError(403, {"message": "Invalid authentication credentials"}),
+    ):
+        flow = config_flow.AirlyFlowHandler()
+        flow.hass = hass
+
+        result = await flow.async_step_user(user_input=CONFIG)
+
+        assert result["errors"] == {"base": "auth"}
+
+
+async def test_invalid_location(hass):
+    """Test that errors are shown when location is invalid."""
+    with patch(
+        "airly._private._RequestsHandler.get",
+        return_value=json.loads(load_fixture("airly_no_station.json")),
+    ):
+        flow = config_flow.AirlyFlowHandler()
+        flow.hass = hass
+
+        result = await flow.async_step_user(user_input=CONFIG)
+
+        assert result["errors"] == {"base": "wrong_location"}
+
+
+async def test_duplicate_error(hass):
+    """Test that errors are shown when duplicates are added."""
+
+    with patch(
+        "airly._private._RequestsHandler.get",
+        return_value=json.loads(load_fixture("airly_valid_station.json")),
+    ):
+        MockConfigEntry(domain=DOMAIN, data=CONFIG).add_to_hass(hass)
+        flow = config_flow.AirlyFlowHandler()
+        flow.hass = hass
+
+        result = await flow.async_step_user(user_input=CONFIG)
+
+        assert result["errors"] == {CONF_NAME: "name_exists"}
+
+
+async def test_create_entry(hass):
+    """Test that the user step works."""
+
+    with patch(
+        "airly._private._RequestsHandler.get",
+        return_value=json.loads(load_fixture("airly_valid_station.json")),
+    ):
+        flow = config_flow.AirlyFlowHandler()
+        flow.hass = hass
+
+        result = await flow.async_step_user(user_input=CONFIG)
+
+        assert result["type"] == data_entry_flow.RESULT_TYPE_CREATE_ENTRY
+        assert result["title"] == CONFIG[CONF_NAME]
+        assert result["data"][CONF_LATITUDE] == CONFIG[CONF_LATITUDE]
+        assert result["data"][CONF_LONGITUDE] == CONFIG[CONF_LONGITUDE]
+        assert result["data"][CONF_API_KEY] == CONFIG[CONF_API_KEY]

tests/fixtures/airly_no_station.json

@@ -0,0 +1,642 @@
+{
+	"current": {
+		"fromDateTime": "2019-10-02T05:53:00.608Z",
+		"tillDateTime": "2019-10-02T06:53:00.608Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	},
+	"history": [{
+		"fromDateTime": "2019-10-01T06:00:00.000Z",
+		"tillDateTime": "2019-10-01T07:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T07:00:00.000Z",
+		"tillDateTime": "2019-10-01T08:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T08:00:00.000Z",
+		"tillDateTime": "2019-10-01T09:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T09:00:00.000Z",
+		"tillDateTime": "2019-10-01T10:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T10:00:00.000Z",
+		"tillDateTime": "2019-10-01T11:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T11:00:00.000Z",
+		"tillDateTime": "2019-10-01T12:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T12:00:00.000Z",
+		"tillDateTime": "2019-10-01T13:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T13:00:00.000Z",
+		"tillDateTime": "2019-10-01T14:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T14:00:00.000Z",
+		"tillDateTime": "2019-10-01T15:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T15:00:00.000Z",
+		"tillDateTime": "2019-10-01T16:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T16:00:00.000Z",
+		"tillDateTime": "2019-10-01T17:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T17:00:00.000Z",
+		"tillDateTime": "2019-10-01T18:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T18:00:00.000Z",
+		"tillDateTime": "2019-10-01T19:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T19:00:00.000Z",
+		"tillDateTime": "2019-10-01T20:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T20:00:00.000Z",
+		"tillDateTime": "2019-10-01T21:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T21:00:00.000Z",
+		"tillDateTime": "2019-10-01T22:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T22:00:00.000Z",
+		"tillDateTime": "2019-10-01T23:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-01T23:00:00.000Z",
+		"tillDateTime": "2019-10-02T00:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T00:00:00.000Z",
+		"tillDateTime": "2019-10-02T01:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T01:00:00.000Z",
+		"tillDateTime": "2019-10-02T02:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T02:00:00.000Z",
+		"tillDateTime": "2019-10-02T03:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T03:00:00.000Z",
+		"tillDateTime": "2019-10-02T04:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T04:00:00.000Z",
+		"tillDateTime": "2019-10-02T05:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T05:00:00.000Z",
+		"tillDateTime": "2019-10-02T06:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}],
+	"forecast": [{
+		"fromDateTime": "2019-10-02T06:00:00.000Z",
+		"tillDateTime": "2019-10-02T07:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T07:00:00.000Z",
+		"tillDateTime": "2019-10-02T08:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T08:00:00.000Z",
+		"tillDateTime": "2019-10-02T09:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T09:00:00.000Z",
+		"tillDateTime": "2019-10-02T10:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T10:00:00.000Z",
+		"tillDateTime": "2019-10-02T11:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T11:00:00.000Z",
+		"tillDateTime": "2019-10-02T12:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T12:00:00.000Z",
+		"tillDateTime": "2019-10-02T13:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T13:00:00.000Z",
+		"tillDateTime": "2019-10-02T14:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T14:00:00.000Z",
+		"tillDateTime": "2019-10-02T15:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T15:00:00.000Z",
+		"tillDateTime": "2019-10-02T16:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T16:00:00.000Z",
+		"tillDateTime": "2019-10-02T17:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T17:00:00.000Z",
+		"tillDateTime": "2019-10-02T18:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T18:00:00.000Z",
+		"tillDateTime": "2019-10-02T19:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T19:00:00.000Z",
+		"tillDateTime": "2019-10-02T20:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T20:00:00.000Z",
+		"tillDateTime": "2019-10-02T21:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T21:00:00.000Z",
+		"tillDateTime": "2019-10-02T22:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T22:00:00.000Z",
+		"tillDateTime": "2019-10-02T23:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-02T23:00:00.000Z",
+		"tillDateTime": "2019-10-03T00:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-03T00:00:00.000Z",
+		"tillDateTime": "2019-10-03T01:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-03T01:00:00.000Z",
+		"tillDateTime": "2019-10-03T02:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-03T02:00:00.000Z",
+		"tillDateTime": "2019-10-03T03:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-03T03:00:00.000Z",
+		"tillDateTime": "2019-10-03T04:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-03T04:00:00.000Z",
+		"tillDateTime": "2019-10-03T05:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}, {
+		"fromDateTime": "2019-10-03T05:00:00.000Z",
+		"tillDateTime": "2019-10-03T06:00:00.000Z",
+		"values": [],
+		"indexes": [{
+			"name": "AIRLY_CAQI",
+			"value": null,
+			"level": "UNKNOWN",
+			"description": "There are no Airly sensors in this area yet.",
+			"advice": null,
+			"color": "#999999"
+		}],
+		"standards": []
+	}]
+}