Differences
This shows you the differences between two versions of the page.
Previous revision | |||
— | api:estimate [2024/02/15 12:09] (current) – [Example] knutkohl | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ===== Solar production estimate ===== | ||
+ | |||
+ | Get solar production estimate for specific location (defined by **latitude** and **longitude**) and a specific plane orientation (defined by **declination** and **azimuth**) for an installed **module power**. | ||
+ | |||
+ | ===== Historic solar production ===== | ||
+ | |||
+ | '' | ||
+ | |||
+ | ===== Clear sky solar production ===== | ||
+ | |||
+ | If there were no clouds it would be a clear sky. '' | ||
+ | |||
+ | ===== URL parameters ===== | ||
+ | |||
+ | :!: Please check **always** if your **location and plane parameters are valid** before you go live! You can do this with the [[api: | ||
+ | |||
+ | * **'': | ||
+ | * **'': | ||
+ | * **'': | ||
+ | * **'': | ||
+ | * **'': | ||
+ | * **'': | ||
+ | |||
+ | Please see the examples below. | ||
+ | |||
+ | **'': | ||
+ | * ''< | ||
+ | * ''< | ||
+ | |||
+ | **Azimuth** | ||
+ | |||
+ | :!: Please note that e.g. Home Assistant uses internal a '' | ||
+ | |||
+ | {{: | ||
+ | |||
+ | For the lazy ones, if you have an exact '' | ||
+ | |||
+ | You can poke around with the [[http:// | ||
+ | |||
+ | To find your azimuth, please refer to these [[:Find your azimuth|instructions]]. | ||
+ | |||
+ | ====== Account models ====== | ||
+ | |||
+ | (Documentation here use the '' | ||
+ | |||
+ | ===== Public ===== | ||
+ | |||
+ | * **1** plane can be accessed by an API call | ||
+ | * only '' | ||
+ | |||
+ | https:// | ||
+ | |||
+ | ===== Personal / Personal Plus ===== | ||
+ | |||
+ | * **1** (Personal) or combined data of **2** (Personal Plus) planes can be accessed by an API call | ||
+ | * '' | ||
+ | |||
+ | https:// | ||
+ | https:// | ||
+ | ===== Professional / Professional Plus ===== | ||
+ | |||
+ | * Combined data of up to **3** (Professional) or **4** (Professional Plus) planes can be accessed by one API call | ||
+ | * '' | ||
+ | |||
+ | https:// | ||
+ | https:// | ||
+ | https:// | ||
+ | https:// | ||
+ | |||
+ | ====== Responses ====== | ||
+ | |||
+ | ===== Watts, Watt hours over day, Watt hours per period, Watt hours per day ===== | ||
+ | |||
+ | There are also routes available to query only the watts, watt hours, watt hours per period or watt hours per day. | ||
+ | |||
+ | https:// | ||
+ | https:// | ||
+ | https:// | ||
+ | https:// | ||
+ | |||
+ | The same for Personal and Professional accounts with API key | ||
+ | |||
+ | https:// | ||
+ | https:// | ||
+ | https:// | ||
+ | https:// | ||
+ | |||
+ | ===== Content ===== | ||
+ | |||
+ | The response have in the '' | ||
+ | |||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | :!: For '' | ||
+ | |||
+ | ====== Example ====== | ||
+ | |||
+ | Get solar production estimate per day as [[: | ||
+ | |||
+ | <code bash> | ||
+ | curl -H ' | ||
+ | </ | ||
+ | |||
+ | <code csv> | ||
+ | 2016-02-08; | ||
+ | 2016-02-09; | ||
+ | 2016-02-10; | ||
+ | 2016-02-11; | ||
+ | 2016-02-12; | ||
+ | 2016-02-13; | ||
+ | 2016-02-14; | ||
+ | 2016-02-15; | ||
+ | </ | ||
+ | |||
+ | Get solar production estimate as [[: | ||
+ | |||
+ | <code bash> | ||
+ | curl https:// | ||
+ | </ | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | ... | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | ... | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | ... | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | ... | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | ... | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | ... | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | }, | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | The '' | ||