USAQI
· v1.11
About
A widget that calculates and shows the USAQI (Air Quality Index) by pulling data from the PurpleAir API. https://www.purpleair.com/map
REQUIRED SETUP: You must obtain, configure, and add your own (Free!) PurpleAir API key to the widget's settings before use.
1. Review this PurpleAPI blog post: https://community.purpleair.com/t/creating-api-keys/3951
2. Sign in and generate an API key: https://develop.purpleair.com/keys
3. Enter your API key into the USAQI widget settings in your phone
Frequently Asked Questions:
* Can I force refresh the AQI information? Yes. Scroll through the widget views until you get to the Debug view (the one that shows your last GPS coordinates) and press the Select button (usually the one on the top-right).
* Can you add support for my Garmin device? Yes. Use the Contact Developer link to let me know what device you'd like me to add support for.
* Why do I see an error about an invalid API key? This is likely because your didn't enter your PurpleAir API key into the widget settings on your phone. Double check the key.
* Why do I see an error about BLE Connection Unavailable? Your device isn't able to connect to your phone to access the PurpleAir API. Try syncing your device to your phone and trying again.
* Why do I see an error about Payment Required? This is because you didn't setup your PurpleAir API key correctly. You must assign your API key to a project to utilize your points.
* Why do I see an error about not getting Sensor Data from the API? This might be because there aren't any PurpleAir sensors near you. You might be able to increase the sampling distance in the app Settings (default: 15km) to find sensors that are farther away.
* Can I extend the time that AQI results are cached on my device? Yes, this is a configurable timeframe in the app settings on your phone. Set the number of minutes you want to cache the results - up to 1 month!
* Can I disable the vibration notification? Yes, go into the app settings on your phone and toggle the switch for the vibration setting.
Information about Personal Data Handling:
This widget will use your device's GPS location information to identify an area around you from which to query information from nearby PurpleAir sensors. The coordinates are only sent to the PurpleAir and not collected by or shared to any other parties. For more information, see PurpleAir's privacy policy.
Note: The AQI calculation is based on the United State's Environmental Protection Agency's calculations. These may not be the same as your country's AQI calculations.
Air quality data from PurpleAir.com
Wind icons created by riajulislam - Flaticon.com
What's new
New in v1.11
- Fixed a crash caused by bad PurpleAir data
New in v1.10
- Added support for:
- D3 Mach 2
- Fenix 8 Pro
- Venu 4
New in v1.9
- Added an optional vibrate when AQI results are received (for supported devices)
- Fixed a bug related to the new backlight timer
- Fixed a bug where force refreshing didn't trigger the spinning progress bar
New in v1.8
- Backlight stays on longer while data is loading (max 50 seconds)
New in v1.7
- Added a configurable AQI cache lifetime in the App Settings (default is 30 mins)
New in v1.6
- Added support for:
- Approach S50
- Descent G2
- Forerunner 570
- Forerunner 970
- Instinct 3 AMOLED
- Vivoactive 6
New in v1.5
- Fixed a crash in the DetailView when an AQI hasn't been calculated yet.
- Added a spinning progress bar to the MainView when GPS is being obtained and the API queried.
New in v1.4
- Fixed a bug regarding displaying GPS precision. h/t B.T.
New in v1.3
- Added support for Fenix 8 & variants
- The Debug and Credits views now use vector fonts for better formatting on supported devices
New in v1.2
- Fixed a logic bug for areas with more than 0 but fewer than 3 healthy sensors nearby. h/t H.S.
- Added status messages to clarify what the widget is doing (E.g. acquiring GPS, querying API, etc.)
- Added live GPS location to the Debug view
New in v1.1:
- Updated AQI breakpoints for 2024 US EPA guidelines https://www.airnow.gov/announcement/5494/
- Added support for:
- Approach S60+
- D2 & variants
- Descent Mk3 & variants
- FR 165 & newer
- MARQ Gen2 & variants
- Venu 2 & variants
- epix and newer
- Fenix 5 and newer
- Quatix 6 and variants
- Tactix 7 & variants
New in v1.0.3:
- Made USAQI available in all countries!
- Added support for Fenix 7 Pro & variants
New in v1.0.2:
- Added support for Fenix 6 & variants, Fenix 7 & variants, FR 245 & variants
- Added a timestamp with age of last AQI reading
- Fixed up text formatting for watch faces with different dimensions
New in v1.0.1:
- Added support for FR 955 & variants