A big upgrade to our OnPoint API service has rolled out. This refreshed weather API was thoughtfully designed to be backward compatible with the previous iteration of the OnPoint API. There are several new features, and the removal of constraints that will greatly increase value and usability of the API.
Removal of Constraint
By far, the most requested enhancement to the OnPoint API was that we lift the “maximum 25 rows of data per request” limit. You have been heard! Queries are no longer limited to requests of 25 rows or less. You can now request of up to 1 year of data at a time using the “timestamp between” parameter. IMPORTANT: You will see significantly improved performance if you limit the “timestamp between” range to 1 month or less.
- Past weather data is now available back to 2007 for North America and 2000 Internationally.
- A new OnPoint Climatology resource is available for all accounts with the “read_climatology” capability. Climatology is the statistics of weather over a period of time in the form of means and standard deviations. Climatology can be useful in two ways. The first allows one to compare weather to what should be ‘normal’ weather for a place and time. Weather parameters such as temperature, humidity, wind and precipitation can be differenced with climatology to get a ‘departure from normal’. The second use of climatology is as a long-range forecast. Climatology gives a solid estimate of what to weather to expect for any location and any point in time. Weather Source’s OnPoint Climatology supports nearly two million points globally with climatology information on hourly and daily increments.
- A new Nowcast resource is available for all accounts with the “read_nowcast” capability. Nowcast is the current derived weather with global coverage and to-the-second precision.
- Global lat/lon data (not just US data) is now available for all accounts with the “access_points” capability. Coverage is for all global landmasses (except Antarctica) and up to 200 miles offshore. The History, Forecast, Nowcast, Climatology, and Astronomy resources all have this regionally expanded capability.
- Hourly and Daily weather forecasts are now available up to 10 days for both North America and International locations. This is increased from up to 7 days of forecast or 72 hours of forecast.
- Support has been added for the following observations: Heat Index, Mean Sea Level Pressure, Solar Radiation, Wind Chill, 80m Wind Direction, 100m Wind Direction, 80m Wind Speed, and 100m Wind Speed.
- Added convenience field groups (such as “all”, “allTemp”, “allPrecip”, and “popular”) that return logically related fields without having to exhaustively list them.
- The “limit” and “offset” parameters have been depreciated. They will continue to work, but may see a slight decrease in performance.
- The “GET /history” resource has been depreciated in favor of the “GET /points/:latitude_and_longitude/history” resource. The depreciated resource will continue to work.
- The “GET /designated_marketing_areas/:dma_id/history” resource has been depreciated in favor of the “GET /dmas/:dma_id/history” resource. The depreciated resource will continue to work.
- The “GET /history_by_postal_code” resource has been depreciated in favor of the “GET /postal_codes/:postal_code_and_country/history” resource. The depreciated resource will continue to work.
- The “GET /forecast” resource has been depreciated in favor of the “GET /points/:latitude_and_longitude/forecast” resource. The depreciated resource will continue to work.
- The “GET /astronomy” resource has been depreciated in favor of the “GET /points/:latitude_and_longitude/astronomy” resource. The depreciated resource will continue to work.
- The “timestamp_between” parameter is now restricted to a maximum range of 1 year. IMPORTANT: This will now return an error for ranges more than 1 year.