Documentation

Solar Irradiance History Bulk allows you to retrieve an archive of historical solar radiation data for selected locations in a convenient, downloadable format.

• Data archive available for 47+ years (from January 1, 1979)
• Includes Global Horizontal Irradiation (GHI), Direct Normal Irradiation (DNI), and Diffuse Horizontal Irradiation (DHI)
• Time intervals: 15-minute and 1-hour
• Output formats: JSON and CSV

Solar data is generated using advanced meteorological models. More details about the underlying technology are available in the Solar Irradiance technology section.

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

1. Go to the OpenWeatherMap Marketplace and choose the "Solar Irradiance History 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 a 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 a list of coordinates via CSV file. Click on the search line, choose "Import" option and follow the detailed instruction on the form to download your CSV file with a list of coordinations.
3. Set the time period for the uploaded solar irradiance archive.
4. Configure list of solar irradiance indexes, time interval and the format of the downloadable output file per your preferences.
5. Click on the "Place order" button and check your order details.
6. 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 receive a letter to your email with the link to download your current order.
2. All purchases can be also found in your personal account, in the "Order" section.

The output includes location metadata, timestamps, and solar radiation parameters. JSON and CSV formats contain the same fields.

• dt Date corresponding to the start of the time interval for which energy is summed up, Unix, UTC
• dt_iso Date corresponding to the start of the time interval for which energy is summed up, ISO format
• timezone Shift in seconds from UTC
• lat Latitude of the location,decimal (−90; 90)
• lon Longitude of the location,decimal (-180; 180)
• ghi_cloudy_sky - Global Horizontal Irradiation. Energy (Wh/m²)
• dni_cloudy_sky - Direct Normal Irradiation. Energy (Wh/m²)
• dhi_cloudy_sky - Diffuse Horizontal Irradiation. Energy (Wh/m²)
• ghi_clear_sky - Global Horizontal Irradiation. Energy (Wh/m²)
• dni_clear_sky - Direct Normal Irradiation. Energy (Wh/m²)
• dhi_clear_sky - Diffuse Horizontal Irradiation. Energy (Wh/m²)
• ghi_cloudy_sky_avg - Global Horizontal Irradiance. Avg power (W/m²)
• dni_cloudy_sky_avg - Direct Normal Irradiance. Avg power (W/m²)
• dhi_cloudy_sky_avg - Diffuse Horizontal Irradiance. Avg power (W/m²)
• ghi_clear_sky_avg - Global Horizontal Irradiance. Avg power (W/m²)
• dni_clear_sky_avg - Direct Normal Irradiance. Avg power (W/m²)
• dhi_clear_sky_avg - Diffuse Horizontal Irradiance. Avg power (W/m²)
• ghi_cloudy_sky_max - Global Horizontal Irradiance. Max power (W/m²)
• dni_cloudy_sky_max - Direct Normal Irradiance. Max power (W/m²)
• dhi_cloudy_sky_max - Diffuse Horizontal Irradiance. Max power (W/m²)
• ghi_clear_sky_max - Global Horizontal Irradiance. Max power (W/m²)
• dni_clear_sky_max - Direct Normal Irradiance. Max power (W/m²)
• dhi_clear_sky_max - Diffuse Horizontal Irradiance. Max power (W/m²)

Here you can find and download example of Solar Irradiance History bulk file in JSON and CSV format.

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

JSON

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

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.