Time windows for controllable loads

(Professional accounts only)

If you have controllable loads, you can use this route to determine time windows in which switching processes can be automated based on the solar production forecast.

https://api.forecast.solar/:apikey/timewindows/:lat/:lon/:az/:dec/:kw
https://api.forecast.solar/:apikey/timewindows/:lat/:lon/:dec1/:az1/:kwp1/:dec2/:az2/:kwp2
https://api.forecast.solar/:apikey/timewindows/:lat/:lon/:dec1/:az1/:kwp1/:dec2/:az2/:kwp2/:dec3/:az3/:kwp3
https://api.forecast.solar/:apikey/timewindows/:lat/:lon/:dec1/:az1/:kwp1/:dec2/:az2/:kwp2/:dec3/:az3/:kwp3/:dec4/:az4/:kwp4

(URL parameters)

The following scenarios can be covered:

1. Appliances that need to be switched on for a certain amount of time without interruption (dishwasher, washing machine, etc.).
2. Appliances that need to be provided with a certain amount of watt hours (battery, EV wall box).
3. Scenario 1 & 2 can be combined, if a time window is to be found in which a certain watt hours is also needed, e.g. for a dryer.
4. Appliances with known constant power consumption that can be switched on and off at any time, without a minimum running time (e.g. cartridge heater).

For scenarios 1, 2 & 3, the earliest and latest possible time windows in the course of the day that meet the criteria are determined respectively. Also the best time window with the most watt hours is determined.

All parameters are optional and defaults to 0, so if no parameters are specified at all, the only time window is just sunrise to sunset, with the max. watts and max. watt hours of the day.

Only watts above this value is considered usable.

baseload= (in watts)

For scenario 4, add the required watts to your normal base load here.

If a time window is then found, the required watts should be available above your normal base load.

For scenario 1 & 3

period= (in minutes)

For scenario 2 & 3

watthours= (in watt hours)

(planned)

For scenario 2 & (possibly) 4

For example, if you plan to charge an electric vehicle and know when you need it, you can set an end time by which the windows should be calculated.

end= (HH:MM in 24h format, 00:00 … 23:59)

• If the end time is after your local time, the end time is considered for today.
• If the end time is before your local time, the end time is considered for the next day.
  • It will work for the next day in Germany only after 2 PM after the exchange prices for the next day have been set.

Set of time windows in the result section of the response.

  [ { start: ..., end: ..., watts: ... watthours: ... }, ... ]

• start and end of the found time window
• max. excepted watts above base load in this time window
• excepted watt hours above needed for base load in this time window

If minimum window required (scenario 1 or 3):

• The earliest possible time window for each day
• The best time window with max. watt hours for each day (only if watts hours are higher than in first and latest time window)
• The latest possible time window for each day

If no minimum time window length is required (scenario 2 or 4):

• All time windows above base load, min. 15 minutes

  For the current day, only time windows for the rest of the day are calculated.

[
    ...
    {
        "start": "2023-08-11 06:00:00",
        "end": "2023-08-11 20:30:00",
        "watts": 5870,
        "watthours": 52704
    },
    ....
]

baseload=1000

[
    ...
    {
        "start": "2023-08-11 06:00:00",
        "end": "2023-08-11 18:45:00",
        "watts": 4870,
        "watthours": 38988
    },
    ....
]

baseload=1000&period=120

[
    ...
    {
        "start": "2023-08-11 06:00:00",
        "end": "2023-08-11 08:00:00",
        "watts": 2348,
        "watthours": 2649
    },
    {
        "start": "2023-08-11 11:15:00",
        "end": "2023-08-11 13:15:00",
        "watts": 4870,
        "watthours": 9591
    },
    {
        "start": "2023-08-11 16:45:00",
        "end": "2023-08-11 18:45:00",
        "watts": 2008,
        "watthours": 2157
    },
    ....
]

baseload=1000&period=120&watthours=5000

[
    ...
    {
        "start": "2023-08-11 07:15:00",
        "end": "2023-08-11 09:15:00",
        "watts": 3550,
        "watthours": 5166
    },
    {
        "start": "2023-08-11 11:15:00",
        "end": "2023-08-11 13:15:00",
        "watts": 4870,
        "watthours": 9591
    },
    {
        "start": "2023-08-11 15:15:00",
        "end": "2023-08-11 17:15:00",
        "watts": 3456,
        "watthours": 5018
    },
    ....
]

?baseload=1000

• 06:30 - 14:45, max. excess power abt. 6500 W
• 15:30 - 16:30, max. excess power abt. 200 W

?baseload=1000&period=120

• earliest 06:30 - 08:30, max. excess power abt. 4500 W
• optimal 10:30 - 12:30, max. excess power abt. 6500 W
• latest 12:45 - 14:45, max. excess power abt. 4000 W

?baseload=1000&period=120&watthours=7000

• 10:00 – 12:00, max. excess power abt. 7500 W, abt. 8 kWh

?baseload=7000 (1000 + 6000)

• 10:45 – 12:00, max excess power 6500 W above base base load