Planned router maintenance at the hoster,
the API may be not accessible during the maintenance period.

Estimated: 2024-12-04, 04:30 - 06:30 CET
Unfortunately, the API is temporarily out of service due to maintenance work.
However, we will be back online shortly.

Features

Forecast.Solar provides data based on your location, the declination and orientation of your solar panels

Solar production

(All plans)

The always weather based solar production forecast, historic averages and clear sky optimum provides watt powers and kilo watt energy data.

Weather

(Professional account upwards)

The weather forecast provide sky coverage amount, textual weather condition and icon URL, temperature and some wind information.

Time windows

(Professional account upwards)

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

Chart

(Professional account upwards)

Draw a daily solar production forecast chart with simple Javascript snippets.

Solar production, weather and time windows data are provided for up to 7 days with a resolution of 1 hour down to 15 minutes.

If you then checked the documentation and you like it, register an account for more features.

Calculation model

For the forecast, these 2 data points are mainly used in each case:
- historic irradiation data from PVGIS per plane combined with -
- weather forecast data per location from several weather services -

From the actual weather forecast for the location (with a possible offset because there are not so many stations around), we use e.g. the cloud coverage factor and the temperature forecasts, the cloud coverage is the most important, the temperature is relevant in hot summers when the modules can have > 70 °C which lowers the performance.

Data coverage

The figure shows the areas covered by the Photovoltaic Geographical Information System (PVGIS) solar radiation databases and therefor by Forecast.Solar. With the latest update PVGIS 5.2 almost the entire world is now covered!

Restful API

The API can deliver responses in JSON, CSV or XML

The Swagger compatible API definition is available in YAML.

Example: Get solar production estimate

You can easy build and test the required URLs with the Swagger-UI.

Request

https://api.forecast.solar/_your_API_key_/estimate/54.9/25.3/37/0/1

Response (professional account, 15 minutes resolution)

{
    "result": {
        "watts": {
            "2019-06-22 05:15:00": 17,
            "2019-06-22 05:30:00": 22,
            "2019-06-22 05:45:00": 27,
            ...
            "2019-06-29 20:15:00": 14,
            "2019-06-29 20:30:00": 11,
            "2019-06-29 20:45:00": 7
        },
        "watt_hours": {
            "2019-06-22 05:15:00": 0,
            "2019-06-22 05:30:00": 6,
            "2019-06-22 05:45:00": 12,
            ...
            "2019-06-29 20:15:00": 2545,
            "2019-06-29 20:30:00": 2548,
            "2019-06-29 20:45:00": 2550
        },
        "watt_hours_day": {
            "2019-06-22": 2626,
            "2019-06-23": 2918,
            "2019-06-24": 2526,
            "2019-06-25": 2866,
            "2019-06-26": 2892,
            "2019-06-27": 1900,
            "2019-06-28": 2199,
            "2019-06-29": 2550
        }
    },
    "message": {
        "type": "success",
        "code": 0,
        "text": ""
    }
}

Charts

You can direct draw chart for solar production estimate using the Forecast.Solar widget.

(Professional account upwards)

Chart for the geographical midpoint of Germany at  51°9'N,10°27'E  with a declination of 37°, looking south with 10 kilo watt peak installated.

Today

/chart/0/1442fd2d.js

Without given title or subtitle, no title is printed and the subtitle defaults to date
Tomorrow

/chart/1/1442fd2d.js?title=Forecast+for+{date}

Title with date placeholder, no subtitle is printed

It is also possible to show charts of the historic average data and the theoretic data for clear sky conditions.

Todays historic average production

/chart/history/1442fd2d.js?title=Historic+data

Title without date placeholder, subtitle defaults in this case to the date
Todays theoretical clear sky production

/chart/clearsky/1442fd2d.js?subtitle={place}

No title given but subtitle with placeholder

Please refer to the documentation for details and check also the example page.

The Script URL was build with: https://api.forecast.solar/demo-key/chart/51.15/10.45/37/0/10

Registration

You should consider to register an account, for features and rate limits compare plans in detail.

With the paid subscription models, all the functions listed below can be explored for 14 days without risk.

If you don't want to use your paid subscription after the exploration period, you can cancel the subscription any time during the exploration period and no costs will be charged.

With a subscription you will have a Self-Service area to see some information about your account and find/reset your API key if needed. (Login is the PayPal subscription Id and your PayPal email address)


After you have subscribed, you will automatically receive 2 emails to the primary email address that is stored at PayPal:

If you do not receive the email from Forecast.Solar promptly, do NOT try to make another subscription, check your SPAM folder! You can also go direct to the Self-Service to find your API key.

Please note:

  • Please double check if your location and plane parameters definitions are correct!
    You should always do this with the given check routes for locations and planes!
  • Always test with the public API before make a subscription!
  • If it looks like the PayPal registration page is hanging, please check whether an AdBlocker is active.

Account models

Public

Free for life

This works without API key for free, no subscription needed.
(You will not receive an API key for a donation.)

Best for users without loggers to get a quick idea about coming solar production.

Public API is usable without an API key and free of charge, but if you like it, you can buy me a coffee via Ko-fi or send me something from my Amazon wishlist instead of taking out a sub­scription.

Personal

14 EUR/year

Subscription with a valid email required, access with API key, free trial of 14 days.

Provide the same features as the Public API plus:

Best for users with loggers to integrate the data automatic.

Subscribe (14 EUR/year)

Personal Plus

28 EUR/year

Subscription with a valid email required, access with API key, free trial of 14 days.

Provide the same features as the Personal API with more detailed data:

Best for users with loggers to integrate more detailed data automatic.

Subscribe (28 EUR/year)

Professional

70 EUR/year

Subscription with a valid email required, access with API key, free trial of 14 days.

Provide the same features as the Personal Plus API plus:

Best for business users with more than one plant and/or loggers to integrate the data automatic.

Subscribe (70 EUR/year)

Professional Plus

120 EUR/year

Subscription with a valid email required, access with API key, free trial of 14 days.

Provide the same features as the Professional API plus:

Subscribe (120 EUR/year)

Enterprise

On request

To scale your business according to your growth (e.g. when you reach the rate limits with a Professional Plus subscription), we recommend that you gradually take out additional subscriptions and simply distribute your API calls across multiple API keys accordingly.

Please also get in touch so that we can get an impression of your requirements.

APP developers

It is not allowed to share the API key with e.g. clients of your product! (It will also not work because of the rate limits for the API key.)

  1. If you are developing an APP that will be delivered to customers in any way, the following setup is suggested:

    • Deliver the APP with the use of the Public API by default.
    • Provide an APP setting/configuration option where an API key can be entered.
    • Your customers can now decide whether they want to take out a subscription themselves if they are interested in having more data. (This is for example the way, how the Home Assistant integration works.)
  2. If you host your APP yourself and the API key is not visible to your customers, please check out the Enterprise description above.

There are also some notes for developers in the documentation.

Integrations

Home assistant is an open source home automation that puts local control and privacy first.

The integration was introduced in Home Assistant 2021.7
(Here instructions in German language)

Solectrus is an alternative photo­voltaic dashboard that visualises the yield and consumption of a PV system.

Available on Github.

ioBroker is an open source automation IoT platform (Fog computing).

Available on Github.

The Python Package Index (PyPI) is a repository of software for the Python programming language.

Asynchronous Python client for getting solar forecast information.

KNX

KNX - the intelligent standard for building

The logic module Forecast Solar pro­vides a forecast of the PV yield of a specific site (E5 & E6).

EisBaer is a multi-protocol gateway visualization for creating intelligent, efficient and safe buildings.

Less energy consumption for more sustainable buildings and therefore lower operating costs. (Handbook)

my4e is the unofficial app for E3/DC home power stations, exclusively for iOS and WatchOS

With my4E, you can view current and historical performance data from your E3/DC home power plant easily, quickly and in detail on your iPhone or iPad, create diagrams and export data.

IP-Symcon - SMARTHOME WITHOUT COMPROMISES

For homeowners, corporations, and integrators - Design your building completely by your imagination. A smart software for your hardware. (Module on Github)

Node-RED is a programming tool for wiring together hardware devices, APIs and online services in new and interesting ways.

Forecast.solar API call to analyse and display solar forecast in Home Assistant

Solar yield forecasting using forecast.solar

Hubitat - The Home Automation As It Was Meant To Be

Hubitat driver to retrieve a solar production estimate using the public API from forecast.solar

Homey

Homey - The world's most advanced smart home platform.

Use the Solar Forecast App (Pro) to switch on electric appliances or charge a car or battery based on the forecast solar power, to maximize self-consumption.

Testimonials

Flexible tariffs and battery charging automation for winter

Simple automation for battery charging and smart use of flexible tariffs for maximum savings using Solar Assistant, Home Assistant and Forecast.Solar.

An automation can help maximise your savings. But there are many ways to make such an automation, and they all look complicated.

How to dynamically adjust the percentage of overnight charge so that it charges to 100% when low solar production is expected on the next day.

Solar Energy Concepts

Forecast Solar in Home Assistant einrichten

Direkt nach der Einrichtung meines BKWs habe ich angefangen, mich mit der Solar Forecast Funktion des Home Assistant zu beschäftigen.

Ich möchte dir zeigen, was du damit alles machen kannst und wie du es einrichtest.

Es ist nicht nur umweltfreundlich, sondern auch eine großartige Möglichkeit, deine Stromrechnung zu senken!

Alkly

Support channels

An Discord server, and an Issue tracker are available for support.

Forecast your Solar production

With the increasing share of photovoltaics in the electricity market, the importance of Solar energy forecasts. These are an important tool for the integration of Solar power into existing network structures.

The production of solar power is dependent on external influences on which man has no or only limited influence. For example, Season, time of day, weather (eg ambient temperature, sun/clouds, air turbidity).

A solar day covers the global energy supply for eight years.

Predictions about the availability of solar-generated electricity in the future support private power management, but are of great importance, above all, for commercial solar power generators and network operators.

© 2015-2024 by kk-c.dev | v3.21.1 | Photos: Flickr |