HALOWERKSolarwerk
building heat demand
Computes a transparent planning estimate for space-heating demand. The method is not DIN, VDI, GEG or PHPP and must not be used as regulatory proof. It combines transmission heat loss from each envelope component, ventilation heat loss from heated volume and air changes, monthly heating degree days from the nearest DWD 1991-2020 temperature-normal station, stated internal gains and optional domestic hot water.
POST https://solar.halowerk.com/building-heat-demandEingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| lat | number | Ja | Latitude in Germany; the DWD normal dataset used here covers Germany. |
| lon | number | Ja | |
| heated_floor_area_m2 | number | Ja | |
| heated_volume_m3 | number | Ja | |
| envelope | array | Ja | |
| ventilation | object | Nein | |
| thermal_bridge_w_k | number | Nein | |
| profile | object | Nein | |
| domestic_hot_water_kwh_year | number | Nein | |
| system_efficiency | number | Nein | |
| max_station_distance_km | number | Nein |
Vollständiges Eingabeschema anzeigen
{
"type": "object",
"required": [
"lat",
"lon",
"heated_floor_area_m2",
"heated_volume_m3",
"envelope"
],
"additionalProperties": false,
"examples": [
{
"lat": 52.52,
"lon": 13.405,
"heated_floor_area_m2": 145,
"heated_volume_m3": 365,
"envelope": [
{
"name": "external walls",
"area_m2": 168,
"u_value_w_m2k": 0.22
},
{
"name": "roof",
"area_m2": 118,
"u_value_w_m2k": 0.16
},
{
"name": "ground floor",
"area_m2": 92,
"u_value_w_m2k": 0.25
},
{
"name": "windows",
"area_m2": 31,
"u_value_w_m2k": 0.95
}
],
"ventilation": {
"air_changes_per_hour": 0.45,
"heat_recovery_efficiency": 0.15
},
"profile": {
"indoor_temp_c": 20,
"heating_base_temp_c": 15,
"internal_gains_w": 350
},
"domestic_hot_water_kwh_year": 1800,
"system_efficiency": 0.92,
"max_station_distance_km": 70
}
],
"properties": {
"lat": {
"type": "number",
"minimum": 47,
"maximum": 56,
"description": "Latitude in Germany; the DWD normal dataset used here covers Germany."
},
"lon": {
"type": "number",
"minimum": 5,
"maximum": 16
},
"heated_floor_area_m2": {
"type": "number",
"minimum": 5,
"maximum": 100000
},
"heated_volume_m3": {
"type": "number",
"minimum": 10,
"maximum": 1000000
},
"envelope": {
"type": "array",
"minItems": 1,
"maxItems": 40,
"items": {
"type": "object",
"required": [
"name",
"area_m2",
"u_value_w_m2k"
],
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"area_m2": {
"type": "number",
"minimum": 0.1,
"maximum": 100000
},
"u_value_w_m2k": {
"type": "number",
"minimum": 0.01,
"maximum": 8
}
}
}
},
"ventilation": {
"type": "object",
"additionalProperties": false,
"properties": {
"air_changes_per_hour": {
"type": "number",
"minimum": 0,
"maximum": 5,
"default": 0.5
},
"heat_recovery_efficiency": {
"type": "number",
"minimum": 0,
"maximum": 0.95,
"default": 0
}
}
},
"thermal_bridge_w_k": {
"type": "number",
"minimum": 0,
"maximum": 100000,
"default": 0
},
"profile": {
"type": "object",
"additionalProperties": false,
"properties": {
"indoor_temp_c": {
"type": "number",
"minimum": 5,
"maximum": 30,
"default": 20
},
"heating_base_temp_c": {
"type": "number",
"minimum": 0,
"maximum": 25,
"default": 15
},
"internal_gains_w": {
"type": "number",
"minimum": 0,
"maximum": 100000,
"default": 0
}
}
},
"domestic_hot_water_kwh_year": {
"type": "number",
"minimum": 0,
"maximum": 1000000,
"default": 0
},
"system_efficiency": {
"type": "number",
"minimum": 0.5,
"maximum": 1.5,
"default": 1
},
"max_station_distance_km": {
"type": "number",
"minimum": 1,
"maximum": 200,
"default": 80
}
}
}Veröffentlichtes Eingabebeispiel
{
"lat": 52.52,
"lon": 13.405,
"heated_floor_area_m2": 145,
"heated_volume_m3": 365,
"envelope": [
{
"name": "external walls",
"area_m2": 168,
"u_value_w_m2k": 0.22
},
{
"name": "roof",
"area_m2": 118,
"u_value_w_m2k": 0.16
},
{
"name": "ground floor",
"area_m2": 92,
"u_value_w_m2k": 0.25
},
{
"name": "windows",
"area_m2": 31,
"u_value_w_m2k": 0.95
}
],
"ventilation": {
"air_changes_per_hour": 0.45,
"heat_recovery_efficiency": 0.15
},
"profile": {
"indoor_temp_c": 20,
"heating_base_temp_c": 15,
"internal_gains_w": 350
},
"domestic_hot_water_kwh_year": 1800,
"system_efficiency": 0.92,
"max_station_distance_km": 70
}Ergebnis & Dokumentation
Maschinenlesbare Dokumentation dieses Hubs
Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.
Weitere Endpunkte dieses Hubs
- Solarwerk0,003 USDC
autonomy forecast
POSThttps://solar.halowerk.com/autonomy-forecastDaily energy balance and straight run-down from the figures supplied. Solar input is caller data in watt-hours per day; nothing is fetched and no weather is assumed. Time to empty means time to the reserve floor, not to zero. Idle draw and
- Solarwerk0,004 USDC
battery cycle
POSThttps://solar.halowerk.com/battery-cycleIntegrates the supplied current over time by the trapezoidal rule, so the result is only as good as the sampling interval; gaps longer than the stated max_gap_seconds are excluded and reported. Sign convention: positive current is charging,
- Solarwerk0,003 USDC
clear sky yield
POSThttps://solar.halowerk.com/clear-sky-yieldThis is an astronomical and geometric calculation, not a forecast. It assumes a cloudless sky and states the models used; real yield is lower whenever there is cloud, haze, snow, soiling or high cell temperature. The system_derate factor co