In June, we announced the new weather conditions endpoint which went into public beta initially. Since then, we’ve made several improvements to this endpoint which results in much-improved conditions information with the release of our AerisWeather API v1.14. Check out the release history to review the complete list of improvements in this API release.
The most popular usage of our new conditions endpoint is to obtain the weather conditions occurring right now for any given location. In this case, just query the conditions endpoint without time parameters or include the for=now parameter: /conditions/minneapolis,mn.
Alternatively, use the for parameter: /conditions/minneapolis,mn?for=now.
Since we’re now utilizing recent radar information and nearby observations with this data set, you will notice improved conditions and accuracy with this API release.
Our initial beta release of the conditions endpoint supported weather conditions within the past 24 hours. We have since expanded the available data sources, allowing the conditions endpoint to provide hourly gap-free data for any point globally for the past 30 days.
Historical conditions are also available back through 2011, though limited to regions where data is available. Over the coming weeks, we will be expanding our hourly gap-free global coverage through the past 10 years of the weather conditions archive!
For example, to obtain the weather conditions for Minneapolis, MN at noon yesterday:
Or the conditions three days ago at 2:12 pm:
Alternatively, the conditions on May 9th, 2018 at 9:46 pm:
Hourly weather conditions are available historically for up to 24 hours at a time. For example, you can return today’s hourly conditions:
Or, return data for a specific date, such as May 9, 2019:
Note that the historical add-on may be required to go beyond the current day.
Complimenting the conditions endpoint is the new conditions/summary endpoint. This new summary endpoint assists in summarizing the hourly conditions by day or across a custom timeframe.
For example, to obtain a daily summary for today:
Or return the daily summary for yesterday:
Check out our blog on the conditions/summary endpoint for more information on its capabilities!
With all of the great improvements to the conditions endpoint, we recommend checking it out for use in your custom applications. The conditions endpoint is available to AerisWeather API Premium users as well as during our free developer trial. Check out the new conditions API and tell us how you’re using it!