GitHub - BJReplay/EPA_AirQuality_HA: HACS custom integration for VIC AU EPA Air Quality

Share your Projects! Custom Integrations
1

Hi All

Very early alpha release of a HACS custom integration to read the Victorian (Australian) EPA air quality information.

This is the same data that is reported at EPA AirWatch | Environment Protection Authority Victoria

You’ll need an API key - sign up at https://portal.api.epa.vic.gov.au/, go to Products at Products: List - Microsoft Azure API Management - developer portal, select Environment Monitoring at Products: Details - Microsoft Azure API Management - developer portal, give your subscription a name (name doesn’t matter - say “homeassistant” and subscribe.

From your profile https://portal.api.epa.vic.gov.au/profile you’ll be able to see your API keys. You’ll need an API key to get this up and running.

Install the integration like any other HACS custom integration (install, restart HA, install integration, configure).

By default, it picks up your location from HACS and finds the nearest station for you.

Find it here: GitHub - BJReplay/EPA_AirQuality_HA: A Home Assistant custom component for reading air quality data from the EPA Victoria (Australia) Environment Monitoring API

Feedback / issues preferred on github rather than here.

No translations or strings yet but should work.

Example yaml for the card below is at EPA_AirQuality_HA/sample-card.yaml at 7aeb66d4759bd94875c8387a2f03092d8b86fd0c · BJReplay/EPA_AirQuality_HA · GitHub and if you put the images in your www folder, it should work

image

Thanks to @autoSteve for inspiration and code to steal, @bremor and @Makin-Things for the GitHub - bremor/bureau_of_meteorology: Custom component for retrieving weather information from the Bureau of Meteorology. integration which was so helpful as another example of a polling cloud integration, and @loryanstrant who inspired this with this article: https://www.loryanstrant.com/2023/07/23/track-air-quality-with-home-assistant-and-epa-data/

2 Likes
2

Oh wow, this just came up on my Google search looking for a more local air quality source. Recognized your username from using the Solcast thing already. Adding it & getting it setup now. I’ll be back if I have anything problems to report. This will be so helpful going into Vic’s fire season.

Edit: I’m currently stuck on they didn’t send an email to verify my account after I signed up. Not in spam etc

3

It’s been a while since I signed up, so I don’t recall how long it normally takes.

The developer portal sits behind Microsoft b2b / b2c login, from memory.

I thought about embedding my API key into the integration, but I don’t want to risk violating T&Cs.

4

Report issues on github, please - I don’t spend a lot of time here :rofl:.