Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revisionBoth sides next revision
api:estimate [2019/12/30 16:22] – [URL parameters] knutkohlapi:estimate [2021/05/26 11:10] – knutkohl
Line 11: Line 11:
 ===== Clear sky solar production ===== ===== Clear sky solar production =====
  
-If there were no clouds it would be a clear sky. `clearsky` thus calculates the theoretically possible production.+If there were no clouds it would be a clear sky. ''clearsky'' thus calculates the theoretically possible production. 
 + 
 +===== URL parameters ===== 
 + 
 +  * **''apikey''** - personal **API key** for registered users 
 +  * **''lat''** - **latitude** of location, ''-90'' (south) ... ''90'' (north) 
 +  * **''lon''** - **longitude** of location, ''-180'' (west) ... ''180'' (east) 
 +  * **''dec''** - plane **declination**, ''0'' (horizontal) ... ''90'' (vertical) 
 +  * **''az ''**  - plane **azimuth**, ''-180'' ... ''180'' (-180 = north, -90 = east, 0 = south, 90 = west, 180 = north) 
 +  * **''kwp''** - installed **modules power** in ''kilo watt'' 
 + 
 +**''lat''** and **''lon''** can also given as **''<degrees>,<arc minutes>,<arc seconds>''**, e.g. ''12,10,34'' == ''12.17611'' 
 + 
 +You can poke around with the [[http://swagger.forecast.solar/?url=https://api.forecast.solar/swagger.yaml|Swagger Editor]] to build proper request URLs.
  
 ===== Public ===== ===== Public =====
Line 36: Line 49:
   https://api.forecast.solar/:apikey/estimate/:lat/:lon/:dec1/:az1/:kwp1/:dec2/:az2/:kwp2/:dec3/:az3/:kwp3   https://api.forecast.solar/:apikey/estimate/:lat/:lon/:dec1/:az1/:kwp1/:dec2/:az2/:kwp2/:dec3/:az3/:kwp3
  
-===== URL parameters ===== 
- 
-  * **''apikey''** - personal **API key** for registered users 
-  * **''lat''** - **latitude** of location, ''-90'' (south) ... ''90'' (north) 
-  * **''lon''** - **longitude** of location, ''-180'' (west) ... ''180'' (east) 
-  * **''dec''** - plane **declination**, ''0'' (horizontal) ... ''90'' (vertical) 
-  * **''az ''**  - plane **azimuth**, ''-180'' ... ''180'' (-180 = north, -90 = east, 0 = south, 90 = west, 180 = north) 
-  * **''kwp''** - installed **modules power** in ''kilo watt'' 
- 
-You can poke around with the [[http://swagger.forecast.solar/?url=https://api.forecast.solar/swagger.yaml|Swagger Editor]] to build proper request URLs. 
 ===== Watts, Watt hours, Watt hours day ===== ===== Watts, Watt hours, Watt hours day =====
  
Line 151: Line 154:
 </code> </code>
  
-The ''watt_hours'' data will **reset to 0 at day change**!+The ''watt_hours'' data will simulate a daily electricity meter and therefor **resets to 0 at day change**!