Changelog
Changelog of the deploy of the Sustainability API in format iteration (1.01) and (expected) release date (year, month and day).
Last updated
Changelog of the deploy of the Sustainability API in format iteration (1.01) and (expected) release date (year, month and day).
Last updated
Correctie toegevoegd voor het berekende jaarlijkse gasverbruik "gas_usage", gebaseerd op statistische gemiddelden van huizen in Nederland.
Twee nieuwe 400 error reacties toegevoegd wanneer de gebruiker niet de vereiste parameters van een custom kost of een verbeteringskost opgeeft.
"detail": "For a given custom cost make sure the parameter 'value' is provided."
"detail": "For a given improvement cost make sure all four parameters: 'material', 'work', 'saving_material' and 'saving_work' are provided."
Toegevoegd BENG1 current en potential outputs.
Input "target_label" is verwijderd uit de criteria voor het toepassen van aanvullende maatregel informatie.
Toevoeging "points" output per maatregel. Deze punten worden gebruikt om de "comfortscore" te berekenen. Zie .
EPOnline versie-update van V3 naar V4.
De berekening van de huidige maatregelen bijgewerkt om aanvullende maatregelen informatie op te nemen voor een betere nauwkeurigheid, als er geen maatregel input van de gebruiker is.
Wijzigingen in de input "exclude_measure". Waarden [1001, 1002, 2001, 2002] zijn nu beschikbaar, waarde [8009] is verwijderd.
Gebruikerswaarde voor invoer zonnepanelen wordt nu correct meegenomen in de berekening van de resultaten per maatregelen
De berekening van de opgewekte elektriciteit van pv-panelen in de resultaten per maatregelen is aangepast
Een bug in de berekening van de gaskosten is opgelost
HRe/WKK-ketel is verwijderd als optie voor installatiemaatregel
De aangepaste waarde voor gasverbruik geldt nu ook voor de output "ResultaatPerMaatregel" in het geval van een hybride warmtepomp.
Bug opgelost bij het verwerken van aangepaste invoer WP -zonnepanelen die onjuiste resultaten veroorzaken.
Berekeningsfactor aangepast van de energieoutput van zonnepanelen op BENG2. Verlaagd van 4.756 naar 4.21 om de lokale zonnepanalen input per m2 beter te laten aansluiten.
Bug opgelost waarbij correctie voor gasverbruik op basis van geleverde waarde niet werd toegepast in het geval van een hybride warmtepomp.
Probleem opgelost met incidenteel inconsistente resultaten veroorzaakt door inconsistente verwerking van de nieuwe kostentabel
Toevoeging "city_heating" huidige en potentiële verbruik outputs, het jaarlijkse warmteverbruik in GJ.
Toevoeging "floor_surface", "flat_roof_surface", "pitched_roof_surface", "wall_surface", "glass_living_room_surface", "glass_bedrooms_surface" outputs
Er is een probleem opgelost waarbij "custom_costs" niet correct werden verwerkt
Toevoeging electricity_savings output, de jaarlijkse besparing op het elektriciteitsverbruik in kWh voor de specifieke maatregel.
Toevoeging gas_savings output, de jaarlijkse besparing op het gasverbruik in m^3 voor de specifieke maatregel.
Error codes bijgewerkt in document voor 400 Address Not Found (voorheen 301) en 400 No Measures (voorheen 311)
Toevoeging watt_panels input om invoer solar_panels veld te interpreteren als wattpiek capaciteit zonnepanelen. Voorbeeld invoer: "solar_panels": 15000, "watt_panels": 0
Toevoeging /bag endpoint voor opvragen verduurzamingadvies o.b.v. BAG ID (VBO)
Huisnummer letter toevoegingen worden nu zowel gezocht in kapitalen (A) als onderkast (a) gezocht
Toevoegen huidige elektriciteitsverbruik is nu mogelijk via het optionele invoerveld: "electricity_usage". Met het bestaande invoerveld "gas_usage" kun je nu het complete beeld aan huidig energieverbruik opvoeren.
Fixed issue where the custom "gas_usage" input was not properly accounted for the "saving" results per measure.
Optimized general performance of the API call to 2 seconds on average
Added optional boolean "eco_delta: 0" input to deactivate fetching of the Ecovalue output. Which will then display "null" for this value. This results in a ~ 1 second performance improvement per API call
Added feature to overwrite solar panel watt peak per square meter with "solarpanel_watt_peak"
Added default watt peak output solar panels to 212
API output now showing gas and energy prices used as well as the solarpanel watt peak performance per square meter:
Set a minimum number of solar panels to be adviced when provided as measure via the function: minimum_solar_panels Warning: in some cases this might result into NOT suggesting solar panels as measure at all
Added function to set a minimum requirement for insulation when suggest a (hybrid) heatpump via the input feature "heatpump_insulation_req": 0, 1, 2 or 3. Default is 0. This feature can be used to ensure a heatpump (Installation 7 or 8, 30, 31) is only returned as a measure when all insulation levels (wall, floor, roof) satisfy the 'heatpump_insulation_req' input. In other words: when 'heatpump_insulation_req' is 2, a heatpump is only considered as a resulting measure when Wall insulation, Floor insulation and Roof insulation all have at least a value of 2 (=good).
New optional parameter build_year (from 1000 and to 2030) to parse as input. With an accompanying error 303 message: "Build year not found in database. Use build_year parameter."
New optional parameter inner_surface_area (greater than 0). New response for 303 error: "Inner surface area not found in database. Use inner_surface_area parameter instead."
New optional parameter fetch_definitive_label
- used as flag to fetch the label, its validity and norm type from EP-online. Default is 0.
More robust handling of possible Ecovalue delta model downtime.
Mitigation of non-uniform build years, incl. an option to specify year in input.
Input a budget "max_investment" with no target energylabel "target_label" will assume utilizing max budget with search criteria the lowest annual yearly energy costs "search_criteria: 1"
Issue resolved with input of an adjusted cost table
Added a function for creating a strict search function for the target energy label. This function is called "energylabel_strict" and has a boolean syntax, where 0=yes and 1=no. When given energy label A as target and strict search is yes, the advice will search up to the lower bound of the A label
Added the ability to input search criteria where the target is lowest BENG2 value which relates to the energy label. Example: "search_criteria: 4"
Added BENG2 current and potential
Added BENG2 percentual impact per measure
Fixed an issue with input cost table
Optimized performance
Add parameter input of heat usage for which Stadsverwarming is assumed as Installation when heat usage is added to a request
Added input
Added output
Added gas- and electricity usage of potential situation to the output
Change API to NTA 8800 norm and altum.ai/sustainability as endpoint
Added Ventilation as output measure
Target label is now a minimum instead of maximum
Definitive Energy label output is now fetched live from EP-online
Added GET function to fetch based on BAG /sustainability?bagid=
Added error code 303: "detail": "House type not found in database. Use house_type parameter instead."
Fixed a bug regarding cost table input
Fixed a bug in a module which caused the service to generate an error
Example of the "improvement_costs" below:
Small bug fixed in regard to suggesting wall insulation for objects built before 1930.
It is possible to insert the house-type and overwrite the default. The new parameter is optional and if not present in the input, the house-type from the database will be used.
A more accurate source is used for the default housing type, which will improve the quality of the advice
The specified inner surface area as input is also given as output from the API, in addition to being used for the calculations
There is a fix for an issue with house numbers as input where these are entered as eg "12a" which caused an error in the application
Nieuwe optionele parameter "replace_windowframes" - gebruikt om extra verbeteringskosten per glasgerelateerde codes 50002, 50003, 50103, 50203 toe te voegen bij het vervangen van glas en raamkozijnen. De kosten kunt u zien in de PDF bij . Activeer met "replace_windowframes" : 1
De kosten van de maatregelen zijn sinds 1 januari 2024 veranderd. Zie
Exclude specific measures instead or next to a category of measures with the function .
Added possibility to input and overwrite default costs uses for finding measures, calculating investments, savings and return on investments: