Radiation API Parameters

Instantaneous Fluxes: Clear Sky Radiation | Diffuse Radiation | Direct Radiation | Global Radiation | Mean Global Radiation over the Last 10 Years
Accumulated Energy: Accumulated Energy (Direct, Diffuse, Global and Clear Sky Radiation)
Radiation on tilted surfaces:Radiation on tilted surfaces (Direct and Global)

Note: All radiation parameters are normalized on one square meter. The effective unit therefore is W/m² or J/m², respectively.

Clear Sky Radiation: Instantaneous Flux

Gives the instantaneous flux of clear sky radiation in Watts per square meter.

clear_sky_rad:W

Examples

Show the expected instantaneous flux of clear sky radiation for the next two days.

https://api.meteomatics.com/2024-12-03T00:00:00ZP2D:PT1H/clear_sky_rad:W/47.412164,9.340652/html

Diffuse Radiation: Instantaneous flux

Gives the instantaneous flux of diffuse radiation in Watts per square meter.

diffuse_rad:W

It is also possible to get the mean, maximum or minimum of the diffuse radiation for an indicated time interval.

diffuse_rad_<measure>_<interval>:W

Available measures: mean, min, max

Available intervals: 5min, 10min, 15min, 20min, 30min, 1h, 2h, 3h, 6h, 12h

Examples

Show the five days forecast for diffuse radiation.

https://api.meteomatics.com/2024-12-03T00:00:00ZP5D:PT1H/diffuse_rad:W/50,10/html

Direct Radiation: Instantaneous Flux

Gives the instantaneous flux of direct radiation in Watts per square meter.

direct_rad:W

The mean, maximum or minimum of the direct radiation for an indicated time interval is given by:

direct_rad_<measure>_<interval>:W

Available measures: mean, min, max

Available intervals: 5min, 10min, 15min, 20min, 30min, 1h, 2h, 3h, 6h, 12h

Examples

Show the five-day forecast for direct radiation.

https://api.meteomatics.com/2024-12-03T00:00:00ZP5D:PT1H/direct_rad:W/50,10/html

Global Radiation: Instantaneous Flux

Gives the instantaneous flux of global radiation (diffuse + direct radiation) in Watts per square meter.

global_rad:W

It is also possible to get the mean, maximum or minimum of the direct radiation for an indicated time interval.

global_rad_<measure>_<interval>:W

Available measures: mean, min, max

Available intervals: 5min, 10min, 15min, 20min, 30min, 1h, 2h, 3h, 6h, 12h

Examples

Show the five-day forecast for global radiation.

https://api.meteomatics.com/2024-12-03T00:00:00ZP5D:PT1H/global_rad:W/50,10/html

Mean Global Radiation over the Last 10 Years

Gives the mean global radiation over the last 10 years on a certain date at a specific location.

global_rad_10y_mean:W

Examples:

Compare the mean global radiation of the last ten years with the global radiation of 2022.

Current situation:
https://api.meteomatics.com/2024-12-03T12:00:00ZP100D:P2D/global_rad_10y_mean:W,global_rad:W/50,10/html

The global radiation in winter compared to the 10 years mean:

validdate;global_rad_10y_mean:W;global_rad:W
2021-10-01T12:00:00Z;423.8;610.1
2021-11-01T12:00:00Z;280.5;103.4
2021-12-01T12:00:00Z;128.2;41.0
2022-01-01T12:00:00Z;102.3;158.2
2022-02-01T12:00:00Z;143.7;77.8

Current situation:
https://api.meteomatics.com/2024-12-03T12:00:00ZP4M:P1M/global_rad_10y_mean:W,global_rad:W/50,10/csv

Accumulated Energy

Gives the accumulated energy of direct, diffuse, global or clear sky radiation in Ws, Wh or J per square meter.

<type>_rad_<interval>:<unit>

Available type: global, direct, diffuse, clear_sky

Available intervals: 5min, 10min, 15min, 20min, 30min, 1h, 2h, 3h, 6h, 12h, 24h

Available units: Ws, Wh, J

Examples

Show the direct, diffuse and global radiation accumulated over one hour intervals for the next five days.

https://api.meteomatics.com/2024-12-03T00:00:00Z--2024-12-08T00:00:00Z:PT1H/direct_rad_1h:J,diffuse_rad_1h:J,global_rad_1h:J,clear_sky_rad_1h:J/52.652,7.865/html

validdate;direct_rad_1h:J;diffuse_rad_1h:J;global_rad_1h:J;clear_sky_rad_1h:J
 2022-03-16T00:00:00Z;0.0;0.0;0.0;0.0
 2022-03-16T01:00:00Z;0.0;0.0;0.0;0.0
 2022-03-16T02:00:00Z;0.0;0.0;0.0;0.0
 2022-03-16T03:00:00Z;0.0;0.0;0.0;0.0
 2022-03-16T04:00:00Z;0.0;0.0;0.0;0.0
 2022-03-16T05:00:00Z;0.0;0.0;0.0;0.0
 2022-03-16T06:00:00Z;2965.0;23140.1;26105.1;3519.1
 2022-03-16T07:00:00Z;50384.4;168132.2;218516.6;228394.2
 2022-03-16T08:00:00Z;194015.9;396125.2;590141.1;766738.6
 2022-03-16T09:00:00Z;592573.0;485906.3;1078479.4;1337159.1
 2022-03-16T10:00:00Z;1417102.5;280026.2;1697128.8;1806171.5
 2022-03-16T11:00:00Z;1599306.5;316030.6;1915337.2;2117778.8
 2022-03-16T12:00:00Z;1565935.9;309465.1;1875401.0;2242661.1
 2022-03-16T13:00:00Z;1404631.5;299538.5;1704169.9;2169970.3
 2022-03-16T14:00:00Z;1387089.5;274095.5;1661185.0;1905985.2
 2022-03-16T15:00:00Z;1005443.1;347874.3;1353317.4;1474803.0
 2022-03-16T16:00:00Z;661201.8;242430.4;903632.2;923491.9
 2022-03-16T17:00:00Z;245344.8;143181.8;388526.6;353364.4
 2022-03-16T18:00:00Z;31110.6;36162.2;67272.9;26815.8
 2022-03-16T19:00:00Z;0.0;0.0;0.0;0.0
 2022-03-16T20:00:00Z;0.0;0.0;0.0;0.0
 2022-03-16T21:00:00Z;0.0;0.0;0.0;0.0
 2022-03-16T22:00:00Z;0.0;0.0;0.0;0.0
 2022-03-16T23:00:00Z;0.0;0.0;0.0;0.0
 2022-03-17T00:00:00Z;0.0;0.0;0.0;0.0
 2022-03-17T01:00:00Z;0.0;0.0;0.0;0.0

Radiation on tilted surfaces

Gives the instantaneous flux, the minimum, maximum or mean flux over a time interval or the accumulated energy of direct or global radiation on a tilted surface with a certain orientation.

Instantaneous flux

<type>_rad_tilt_<tilt angle>_orientation_<orientation angle>:W

Min, max or mean flux for an indicated time interval

<type>_rad_tilt_<tilt angle>_orientation_<orientation angle>_<measure>_<interval>:W

Accumulated energy

<type>_rad_tilt_<tilt angle>_orientation_<orientation angle>_<interval>:<unit>

Available type: global, direct

Available intervals: 5min, 10min, 15min, 20min, 30min, 1h, 2h, 3h, 6h, 12h, 24h

Available units: Ws, Wh, J

The convention for the orientation: 180° means exposition to the south, 0° to the north, 90° to the east and 270° to the west

It's also possible to specify a tracking type:

<type>_rad_tracking_type_<tracking type>_tilt_<tilt angle>_orientation_<orientation angle>:W

<type>_rad_tracking_type_<tracking type>_tilt_<tilt angle>_orientation_<orientation angle>_<measure>_<interval>:W

<type>_rad_tracking_type_<tracking type>_tilt_<tilt angle>_orientation_<orientation angle>_<interval>:<unit>

Examples

Show the expected instantaneous flux of global radiation on a surface with 20° tilt and north-eastern orientation for the next seven days.

https://api.meteomatics.com/2024-12-03T00:00:00ZP7D:PT1H/global_rad_tilt_20_orientation_45:W/47.412164,9.340652/html
Show the expected accumulated direct radiation on a surface with 35° tilt and southern orientation for the next seven days.

https://api.meteomatics.com/2024-12-03T00:00:00ZP7D:PT24H/global_rad_tilt_35_orientation_180_24h:Ws/47.412164,9.340652/html