Documentation

This service allows to extract historical forecast weather data from October 7, 2017 for any location on the globe.

We provide historical 16-day forecasts with 1-hour step, please find detailed description in the "Product structure" and "Fields in History Forecast Bulk" sections.

History Forecast Bulk provides an archive of previous forecasts starting from October 7, 2017.

By using this service, you can receive data on previously made 16-day forecasts for any coordinates on the globe.

There are two formats this can be provided in: CSV and JSON.

The examples of data can be found in the "Sample data and examples" section.

Please contact us when requesting data for a large number of locations. We’ll prepare and export the data for you.

Historical forecast data is available from 7 October 2017.

A 16-day forecast is a set of values for weather parameters for each of the 16 days ahead.

There are 4 model recalculation cycles available for each day. Each time when recalculation happens, the new forecast is generated (it updates values of weather parameters in the forecast). It means that for each day, starting from 7 October 2017, you will have four 16-day forecasts.

Forecasts are updated at these times: 00:00 UTC, 06:00 UTC, 12:00 UTC, 18:00 UTC.

To learn what weather data are included, please click here.

A 16-day forecast is a set of values for weather parameters that are available in 1-hour steps for 16 days ahead.

Thus, each day will have the following structure:

Please be aware that older historical forecasts will have different time steps:

History Forecast Bulk are available in CSV and JSON.

To request History Forecast Bulk for your locations, please follow these steps:

1. Go to the OpenWeatherMap Marketplace and choose "New History Forecast Bulk" product.
2. Select locations. There are 4 ways to set your locations:
• Click on the map. Click on the map and the pin will be set on the chosen location. Click on the "Add location" to add this location into your order or click on another place on the map.
• Input location name. Click on the search line, input location name and choose it from the dropdown list. The chosen location will be displayed on the map, click on the "Add location" tab to add this location into your order.
• Input coordinates. Click on the search line, choose "By coordinate" option, enter latitude and longitude to the form and push the "Enter" button on your keyboard. The chosen location will be displayed on the map, click on the "Add location" tab to add this location into your order.
• Import coordinates via CSV file. Click on the search line, choose "Import" option and follow the detail instruction on the form to download your CSV file with a list of coordinations.
3. Weather parameters, measurement units and the format of the downloadable output file can be also configurable per your preferences.
4. Click on the "Confirm order" button and check your oreder details.
5. To complete the checkout process, please click on the "Checkout" button and proceed to payment.

After the successful payment you will be able to find your order in two ways:

1. You will also receive a letter to your email with the link to download your current order.
2. All purchases can be found in your personal account, in the "Order" section.

• latLatitude of the location, decimal (−90; 90)
• lonlon Longitude of the location, decimal (-180; 180)
• forecastForecast related information
  • forecast_dtForecast calculation time in unix timestamp
  • list
    • dtTime for which the corresponding forecast part was calculated in unix timestamp
    • main
      • tempTemperature, Celsius
      • pressureAtmospheric pressure (on the sea level), hPa
      • humidityHumidity, %
      • dew_pointTemperature of the dew point, Celsius
      • grnd_pressureAtmospheric pressure (on the surface), hPa
    • wind
      • speedWind speed, metre/sec
      • degWind direction, degrees (meteorological)
    • clouds
      • allCloudiness, %
    • precipitation
      • hoursnumber of hours for which precipitation values are calculated
      • rainRain, mm
      • snowSnow water equivalent, mm
      • rateIntensity, mm/s
      • convectiveConvective precipitation, mm
      • iceIce pellets, mm
      • fr_rainFreezing rain, mm
      • snow_depthDepth of snow, m
      • probabilityProbability of precipitation, %
      • accumulatedAccumulated volume of precipitation, mm

• forecast dt unixtime Forecast calculation time in unix timestamp
• forecast dt iso Forecast calculation time in ISO format
• slice dt unixtime Time for which the corresponding forecast part was calculated in unix timestamp
• slice dt iso Time for which the corresponding forecast part was calculated in ISO format
• lat Latitude of the location, decimal (−90; 90)
• lon Longitude of the location, decimal (-180; 180)
• temperature Temperature, Celsius
• dew_point Temperature of the dew point, Celsius
• pressure Atmospheric pressure (on the sea level), hPa
• ground_pressure Atmospheric pressure (on the surface), hPa
• humidity Humidity, %
• clouds Cloudiness, %
• wind_speed Wind speed, metre/sec
• wind_deg Wind direction, degrees (meteorological)
• rain Rain, mm
• snow Snow water equivalent, mm
• ice Ice pellets, mm
• fr_rain Freezing rain volume, mm
• convective Convective precipitation, mm
• snow_depth Depth of snow, m
• accumulated Accumulated volume of precipitation, mm
• hours Number of hours for which precipitation values are calculated
• rate Precipitation intensity, mm/s
• probability Probability of precipitation, %

Here you can find and download examples of History Forecast bulk files in JSON and CSV formats.

In this section you can find and download example of History Forecast bulk files in JSON format.

You can download sample of files History Forecast bulk in JSON format using link below:

JSON

Please find below an example of data in JSON format for one measurement.

In this section you can find and download example of History Forecast bulk files in CSV format.

You can download sample of files History Forecast bulk in CSV format using link below:

CSV

Please find below an example of data in CSV format in tabular format.