How soon will it rain? How intense will it be? As of today, these questions can now be answered with the release of our new Minutely Precipitation support!
Last year, we introduced the conditions endpoint that provides current weather conditions for any global location. Since, we’ve continued to enhance this endpoint and expanded our global historical access through 2011. Now we are excited to announce the conditions endpoint can now support Minutely Precipitation forecasts.
Minutely Precipitation provides the forecast precipitation rate in 1-minute intervals for the next 60 minutes. AerisWeather generates these high-resolution forecasts by continuously running custom models based on recent radar, satellite, and several other datasets.
The minutely precipitation forecasts provide the following attributes:
The minutely precipitation forecasts are available within the United States, Puerto Rico, Canada, Australia, Japan, South Korea, Ireland, the UK, Germany, and other countries in western Europe.
The Minutely Precipitation data has been integrated into the conditions endpoint, providing up to 60 minutes of precipitation forecasts in 1-minute intervals. To query conditions for Minutely Precipitation, add filter=minutelyprecip to your query. For example:
For the Minutely Precipitation for Minneapolis, MN
1 |
/conditions/minneapolis,mn?filter=minutelyprecip |
The api will return a result similar to the following:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 |
{ "periods":[ { "timestamp":1621456500, "dateTimeISO":"2021-05-19T15:35:00-05:00", "precipMM":0, "precipIN":0, "snowCM":0, "snowIN":0, "weatherPrimary":"Mostly Cloudy", "weatherPrimaryCoded":"::BK", "icon":"mcloudy.png", "isDay":true }, { "timestamp":1621456560, "dateTimeISO":"2021-05-19T15:36:00-05:00", "precipMM":0.51, "precipIN":0.02, "snowCM":0, "snowIN":0, "weatherPrimary":"Isolated Showers", "weatherPrimaryCoded":"IS:VL:RW", "icon":"mcloudyr.png", "isDay":true }, { "timestamp":1621456620, "dateTimeISO":"2021-05-19T15:37:00-05:00", "precipMM":0.65, "precipIN":0.03, "snowCM":0, "snowIN":0, "weatherPrimary":"Isolated Showers", "weatherPrimaryCoded":"IS:VL:RW", "icon":"mcloudyr.png", "isDay":true } ] } |
The attributes returned by the API include:
Attribute | Description |
---|---|
timestamp | The Unix timestamp in seconds of the forecast minute. |
dateTimeISO | The ISO date/time of the forecast minute. |
precipMM / precipIN | The forecast precipitation rate/intensity in mm/hour and inches/hour |
snowCM / snowIN | The forecast snowfall rate in cm/hour and inches/hour |
weatherPrimary | The forecast weather |
weatherPrimaryCoded | The coded version of the forecast weather. |
isDay | Boolean value if the forecast minute is during the daytime. |
Review the documentation for a complete description of the attributes and the conditions endpoint.
The minutely Precipitation is in 1-minute intervals by default. You can also request the data in 5, 10, 15, or other minute-based interval. To obtain the data in other intervals, append #min to the filter parameter, where # is the interval value in minutes. The value must be an integer and can only be between 0-60. The API will respond with the precipitation forecast in the specified interval for up to the next hour.
For example, to obtain the precipitation forecast for Miami, FL in 5-minute intervals:
1 |
/conditions/miami,fl?filter=minutelyprecip,5min |
Or the precipitation forecast in 10-minute intervals for Toronto, Canada:
1 |
/conditions/toronto,on,ca?filter=minutelyprecip,10min |
Start offering enhanced, down-to-the-minute precipitation forecasts with the new Minutely Precipitation feature. The minutely precipitation forecasts are part of the conditions endpoint and available to AerisWeather API Premium users and users of our free developer trial. Check out the new minutely precipitation forecasts and tell us how you’re using it!
No comments yet.
Be the first to respond to this article.