From 96d1c338918bc2015a8783cd66f066fab3a4f95f Mon Sep 17 00:00:00 2001 From: "J.P. Krauss" Date: Sun, 4 Feb 2024 08:15:02 -0800 Subject: [PATCH] Add AirNow Troubleshooting Instructions (#31231) Co-authored-by: Franck Nijhof --- source/_integrations/airnow.markdown | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/source/_integrations/airnow.markdown b/source/_integrations/airnow.markdown index 137c2a247d3..b3ffa7f78c3 100644 --- a/source/_integrations/airnow.markdown +++ b/source/_integrations/airnow.markdown @@ -24,6 +24,16 @@ To generate an AirNow API key, go to the [AirNow Developer Tools Page](https://d {% include integrations/config_flow.md %} +## Troubleshooting + +The EPA AirNow API is often flaky and will occasionally not return any results for a particular location. This will prevent the integration from being added to Home Assistant, but the situation is usually temporary and will resolve itself later. + +If the integration continues to report "No results found for that location" and cannot be added to Home Assistant, please do the following before submitting a bug report. + +First, navigate to the [AirNow Current Observations By Lat/Lon](https://docs.airnowapi.org/CurrentObservationsByLatLon/query) page, enter the same latitude/longitude and station radius, select `application/json` as the output format, select "Build" and then "Run". + +If the query returns a result other than `[]`, open a bug report and include the query result (you may sanitize the data to remove your latitude and longitude, but please do not remove any fields). This information will help a lot to figure out the source of the issue. +
The AirNow API allows 500 data updates per hour, but since observations are only updated hourly, the default update rate is set to 2 per hour and should not trigger rate limiting. If you use this API key for other purposes, ensure the total request rate does not exceed 500 per hour.