| Verduurzaming API | Duurzaamheidsadviezen genereren | Inschatten huidig en potentieel NTA 8800 energielabel | /pages/-Lw4sX1s4eyK0HCmL9r0 | |
| Woningwaarde API | Marktwaarderingen van woningen | Accuratesse indicator voor marktwaarde toepassing | /pages/-Lw4hEyfrZi_P4btoqCq | |
| WOZ API | Haal de laatste WOZ-waarde op uit het WOZ-waardeloket | De WOZ API kan zoeken op adres of het BAG-ID | /pages/-MLNtRHsuACIhIKxG1qg | |
| Interactieve referentie API | Vind relevante recente transacties om de waardering te ondersteunen | Gebruik als taxateur uitgebreide configureerbare functies om tot 30 vergelijkbare verkopen te vinden | /pages/pMCABUk9yu2h78PISwjM | |
| Kadaster transactie API | Haal de transactiegegevens zoals prijs op bij het Kadaster | PING vrij voor beschikbaarheid van de transactie | /pages/-MhMyhJrqm7Rd5GLJsPV | |
| Conditie score API | Schatting van de conditiescore van badkamers en keukens | Krijg een onbevooroordeelde score van 1 tot 5 | /pages/nQWGDP5Gy0APxeuc65R5 |
Een geclassificeerde keukenafbeelding met een betrouwbaarheidsscore van 97,97% en een staatsscore van 3,96 op 5. Bijna "Good".
| ⭐ | Disrepair | /files/Hs0Us3PA8MYtlRfNcAU8 | |
| ⭐⭐ | Poor | /files/AqAwhfIsCoTBUj5gYpGE | |
| ⭐⭐⭐ | Average | /files/9IYjbFyASg6DDeVMOeCr | |
| ⭐⭐⭐⭐ | Good | /files/NbhK8LVAnKERmJI0GxyG | |
| ⭐⭐⭐⭐⭐ | Excellent | /files/zAQumnvAGWOQZQc27H7f |
| ⭐ | Disrepair | /files/F3qTPD9b0EdiztPm1guD | |
| ⭐⭐ | Poor | /files/AOl2h5rIGyLBQvBk7p1d | |
| ⭐⭐⭐ | Average | /files/c70YnkMOx87qT7wOzRgt | |
| ⭐⭐⭐⭐ | Good | /files/9e2Km9nGWDaE0Vde3XjL | |
| ⭐⭐⭐⭐⭐ | Excellent | /files/VMZTBX55yA14b76l7m47 |
Illustratie van de postmethode met afbeeldings-URL van de Conditie score API.
Illustratie van de postmethode met het uploaden van afbeeldingsbestanden van de Conditie score API.
| balcony-garden | /files/MXWkXp0YWzllzx6culXm | ||
| street | /files/VdEYz435dUwAhi92ySRn | ||
| view | /files/0Qx9sfXQihAq2cd3puMY | ||
| no_building | /files/tuFhFQlkyjgn7jlB8Vsr | ||
| facade | /files/SpXpnthDE0v1GneqouZp | ||
| building_part | /files/y9N8vaNTDvSrzcMLyoFL |
De voorspelde beeldklasse is 'outdoor' met een betrouwbaarheid van 100%, de eerste scèneklasse is 'balcony-garden' met een betrouwbaarheid van 36,92% en de tweede scèneklasse is 'facade' met een betrouwbaarheid van 59,15%.
| living_room | /files/meyRuXAIrEyZruEVB6Xi | ||
| kitchen | /files/sKAlcU0aZp0Ml3drGiJN | ||
| bathroom | /files/NSAwiznRkYfwtGnlBMyr | ||
| bedroom | /files/rC2cEtnqIWfE4IObPEzk | ||
| other_room | hall_corridor | /files/rdMSScM8XCDG3cRjBnCN | |
| other_room | room (empty room) | /files/qdYJO77UAQ3mmANpR6g7 | |
| other_room | scullery | /files/n1Q515VvEQGFvooLeD7n |
De voorspelde beeldklasse is 'indoor' met een betrouwbaarheid van 99,9%, de kamerklasse is 'other_room' met een betrouwbaarheid van 96,18% en de subklasse van de kamer is 'hall_corridor' met een betrouwbaarheid van 87,85%.
{
"Output": {
"Image_Class": "outdoor",
"ConfidencePercent_Image_Class": "99.99",
"Scene_Class1": "facade",
"ConfidencePercent_Scene_Class1": "93.89"
}
}
OR
{
"Output": {
"Image_Class": "outdoor",
"ConfidencePercent_Image_Class": "100.0",
"Scene_Class1": "balcony-garden",
"ConfidencePercent_Scene_Class1": "36.92",
"Scene_Class2": "facade",
"ConfidencePercent_Scene_Class2": "59.15"
}
}
OR
{
"Output": {
"Image_Class": "indoor",
"ConfidencePercent_Image_Class": "100.0",
"Room_Class": "bedroom",
"ConfidencePercent_Room_Class": "99.22"
}
}
OR
{
"Output": {
"Image_Class": "indoor",
"ConfidencePercent_Image_Class": "99.9",
"Room_Class": "other_room",
"ConfidencePercent_Room_Class": "96.18",
"Room_Subclass": "hall_corridor",
"ConfidencePercent_Room_Subclass": "87.85"
}
}
| Feature | Voorbeeld | Uitleg |
|---|---|---|
| Image_Class | indoor | De basisklasse van de afbeelding, die de verdere categorisering bepaalt. |
| ConfidencePercent_Image_Class | 99.2 | Hoeveel vertrouwen (in%) het model heeft dat de afbeelding tot de voorspelde afbeeldingsklasse behoort |
| Room_Class | other_room | De kamer die in de afbeelding wordt geïdentificeerd, als de afbeelding 'indoor' is. Als de klasse 'other_room' is, vindt er een verdere categorisering plaats. |
| ConfidencePercent_Room_Class | 96.1 | Hoeveel zekerheid (in%) het model heeft dat de afbeelding tot de voorspelde kamerklasse behoort |
| Room_Subclass | hall_corridor | De verdere categorisering is op de afbeelding toegepast om de subklasse van de kamer te vinden, als de hoofdklasse van de kamer 'other_room' is. |
| ConfidencePercent_Room_Subclass | 82.16 | Hoeveel zekerheid (in%) het model heeft dat de afbeelding tot de voorspelde kamersubklasse behoort |
| Scene_Class1 | facade | De eerste grote scèneklasse die in de afbeelding werd geïdentificeerd, beschrijft de buitenscène van het huis. |
| ConfidencePercent_Scene_Class1 | 70.5 | Hoeveel vertrouwen (in%) het model heeft dat de afbeelding tot de voorspelde scèneklasse behoort |
| Scene_Class2 | balcony-garden | De tweede grote scèneklasse werd in de afbeelding geïdentificeerd en beschrijft de buitenscène van het huis. Het wordt geïdentificeerd als het vertrouwen voor de 1e scèneklasse onder de 70% valt |
| ConfidencePercent_Scene_Class2 | 75.2 | Hoeveel vertrouwen (in %) het model heeft dat de afbeelding ook tot een tweede scèneklasse behoort |
0: indien geïnteresseerd in visuele gelijkenis
1: als je niet geïnteresseerd bent in visuele gelijkenis
| | date\_limit | Number | Tussen 6 en 60 maanden zoekgeschiedenis van transacties. Standaard: 60 | | housetype\_to\_search | List | Functie om alleen te zoeken op bepaalde woningtypes, zie [pagina](/taxeren-en-waarderen/interactieve-woningreferentie-api/woningtypes). | | include\_listings | Boolean |0: indien alleen Kadasterreferenties de voorkeur hebben
1: indien zowel vermelding als Kadasterreferenties de voorkeur hebben
Visual similar properties
| Matrix house-type single-family home | Vrijstaande woning | Vrijstaande doelgroepwoning | 2-onder-1-kapwoning | Geschakelde 2-onder-1-kapwoning | Geschakelde woning | Tussenwoning | Hoekwoning | Eindwoning | Eengezinswoning |
|---|---|---|---|---|---|---|---|---|---|
| Vrijstaande woning | Comparable | Comparable | Better | Better | Much better | Much better | Much | Much better | Much better |
| 2-onder-1-kapwoning | Lesser | Lesser | Comparable | Comparable | Better | Better | Better | Better | Much better |
| Geschakelde 2-onder-1-kapwoning | Lesser | Lesser | Comparable | Comparable | Better | Better | Better | Better | Better |
| Geschakelde woning | Much less | Much less | Lesser | Lesser | Comparable | Comparable | Comparable | Comparable | Better |
| Halfvrijstaande woning | Lesser | Lesser | Comparable | Comparable | Comparable | Better | Better | Better | Better |
| Tussenwoning | Much less | Much less | Much less | Lesser | Lesser | Comparable | Lesser | Comparable | Comparable |
| Hoekwoning | Much less | Much less | Lesser | Lesser | Lesser | Better | Comparable | Comparable | Better |
| Eindwoning | Much less | Much less | Lesser | Lesser | Lesser | Comparable | Comparable | Comparable | Comparable |
| Eengezinswoning | Much less | Much less | Lesser | Lesser | Lesser | Comparable | Lesser | Comparable | Comparable |
| Feature | Voorbeeld | Uitleg |
|---|---|---|
| StrictStreet | 0 | |
| StrictBuurt | 1 | 1: als de gevonden referentiewoningen zich in dezelfde straat bevinden als het doel 0: anders |
| StrictWijk | 0 | 1: als de gevonden referentiewoningen zich in dezelfde wijk bevinden als het doel 0: anders |
| StrictEnergyLabel | 0 | 1: als de gevonden referentiewoningen hetzelfde energielabel hebben als de doelstelling 0: anders |
| ComparableHouseType | 1 | 0: als de gevonden referentiehuizen alle mogelijke matches accepteren 1: als de gevonden referentiewoningen alleen de vergelijkbare woningtypen accepteren 2: als de gevonden referentiehuizen het vergelijkbare + beter en minder accepteren Kijk hier |
| ComparableInnerSurfaceArea | 0 | 0: als de gevonden referentiewoningen geen limiet hebben bij het zoeken naar binnenoppervlakte 1: als de gevonden referentiewoningen zich in een venster van 10% van het doel bevinden 2: als de gevonden referentiewoningen zich in het 20% venster van het doel bevinden 3: als de gevonden referentiewoningen zich in een venster van 30% van het doel bevinden |
| ComparableBuildYear | 1 | 0: als de gevonden referentiewoningen geen limiet hebben bij het zoeken naar bouwjaar 1: als de gevonden referentiewoningen zich binnen ± 10 jaar van de doelstelling bevinden 2: als de gevonden referentiewoningen ± 20 jaar van de doelstelling liggen 3: als de gevonden referentiewoningen ± 30 jaar van de doelstelling liggen |
| ComparableDistance | 1 | 0: als de gevonden referentiewoningen in Nederland staan 1: als de gevonden referentiewoningen zich in een straal van 1 km bevinden 2: als de gevonden referentiewoningen zich in een straal van 5 km bevinden |
| DateLimit | 18 | Hoeveel maanden geleden hebben we gezocht naar verhandelde huizen. |
| Feature | Voorbeeld | Uitleg |
|---|---|---|
| Transactie | Transactie-20210830 | Uniek transactie-ID in database |
| BagID | 637010000220587 | Uniek gebouw-ID |
| PostCode | 2728KM | Postcode |
| HouseNumber | 33 | Huisnummer |
| HouseAddition | A | Huisnummertoevoeging |
| City | ZOETERMEER | Plaatsnaam |
| Street | JONAGOLDHOF | Straatnaam |
| HouseType | T | Indicatie woningtype A = Appartement |
| BuildingCode | 11 | 11 = Wonen 12 = Appartement 14 = Agrarisch 37 = Bedrijfswoning 53 = Recreatiewoning |
| OutersurfaceArea | 154 | Perceeloppervlakte van het pand |
| MoreRealEstate | J | Ja/Nee: Indicatie of transactie meerdere eigendommen bevat |
| RentedOut | N | Indicatie of woning verhuurd is |
| BusinessRight | VE | Zie hieronder |
| MutationVariety | 606 | 583 = executieverkoop 606 = gemeenschappelijke overdracht 659 = openbare verkoop |
| FamilyTransaction | N | Ja/Nee: Indicatie of de transactie een familietransactie is |
| TransactionDate | 20210830 | Formaat: YYYYMMDD |
| TransactionPrice | 505000 | Transactieprijs |
| TransactionPrixeIndexed | 542075 | Geïndexeerd naar afgelopen maand op basis van kadasterindex |
| Feature | Voorbeeld | Uitleg |
|---|---|---|
| transaction | Transaction-20210830 | Uniek transactie-ID in database |
| bag_id | 637010000220587 | Uniek gebouw-ID |
| postcode | 2728KM | Postcode |
| housenumber | 33 | Huisnummer |
| houseaddition | A | Huisnummertoevoeging |
| city | ZOETERMEER | Plaatsnaam |
| street | JONAGOLDHOF | Straatnaam |
| house_type | T | Indicatie woningtype A = Appartement |
| building_code | 11 | 11 = Wonen 12 = Appartement 14 = Agrarisch 37 = Bedrijfswoning 53 = Recreatiewoning |
| outer_surface_area | 154 | Perceeloppervlakte van het pand |
| more_real_estate | J | Ja/Nee: Indicatie of transactie meerdere eigendommen bevat |
| rented_out | N | Indicatie of woning verhuurd is |
| business_right | VE | Zie hieronder |
| mutation_variety | 606 | 583 = executieverkoop 606 = gemeenschappelijke overdracht 659 = openbare verkoop |
| family_transaction | N | Ja/Nee: Indicatie of de transactie een familietransactie is |
| buyer | "BV" | Identificatie van de juridische entiteit van de koper. null = particulier |
| seller | null | Identificatie van de juridische entiteit van de verkoper. null = particulier |
| transaction_date | 20210830 | Formaat: YYYYMMDD |
| transaction_price | 505000 | Transactieprijs |
| transaction_price_indexed | 542075 | Geïndexeerd naar afgelopen maand op basis van kadasterindex |
| Mogelijke waarde | Uitleg |
|---|---|
| VE | Eigendom |
| EVBD | Eigendom (recht van), Zakelijk recht als bedoeld in artikel 5, lid 3, onder b, van de Belemmeringenwet Privaatrecht op gedeelte van perceel |
| EVGB | Eigendom bel. met recht van (mede)gebr. en/of (mede)bew. |
| EVOD | Eigendom (recht van), Opstalrecht Nutsvoorzieningen op gedeelte van perceel |
| EVOL | Eigendom (recht van), Opstalrecht Nutsvoorzieningen |
| EVOS | Eigendom bel. met recht van opstal |
| EVVG | Eigendom bel. met recht van vruchtgebruik |
| EP | Recht van erfpacht |
| EO | Recht van erfpacht en opstal |
| EPEP | Recht van erfpacht op recht van erfpacht |
| EVEP | Eigendom bel. met recht van erfpacht |
| BK | Beklemrecht |
| BKBK | Beklemrecht, beklemrecht |
| EVBP | Eigendom bel. met B.P.-recht |
| OS | Recht van opstal |
| Name | Type | Description |
|---|---|---|
| Content-Type | string | application/json |
| x-api-key* | string | Unieke API-sleutel van Altum. Verkrijg er een via het platform https://platform.altum.ai |
| Accuratesse Indicator | Definitie |
|---|---|
| 0 | < 50% accuratesse in 20% afwijking |
| 1 | < 85% accuratesse in 20% afwijking |
| 2 | >= 85% accuratesse in 20% afwijking |
| 3 | >= 85% accuratesse in 20% afwijking en >= 70% accuratesse in 10% afwijking |
| 4 | >= 85% accuratesse in 20% afwijking en >= 80% accuratesse in 10% afwijking |
| 5 | >= 85% accuratesse in 20% afwijking en >= 85% accuratesse in 10% afwijking en >= 60% accuratesse in 5% afwijking |
| 6 | >= 90% accuratesse in 20% afwijking en >= 90% accuratesse in 10% afwijking en >= 70% accuratesse in 5% afwijking |
| 7 | >= 95% accuratesse in 20% afwijking en >= 90% accuratesse in 10% afwijking en >= 80% accuratesse in 5% afwijking |
Illustratie van invoer en uitvoer van de Woningwaarde+ API
{
"postcode": "1234AB",
"housenumber": 1,
"innersurfacearea": 123
}
{
"postcode": "1234AB",
"housenumber": 1,
"outersurfacearea": 250
}
Illustratie van input en output van de API voor inzichten in energielabels
| Feature | Voorbeeld | Uitleg |
|---|---|---|
| stratification | ('B', 'Dorpskern', 'vrijstaand', '1990-2004', '>150') | De meest complete functiestratificatie die in onze database bestaat |
| mean_sales_duration | 124.0 | De gemiddelde waarde van de verkoopduur, uitgedrukt in aantal dagen, van de huizen die tot dezelfde stratificatie behoren. |
| median_sales_duration | 144.0 | De mediaanwaarde van de verkoopduur, uitgedrukt in aantal dagen, van de huizen die tot dezelfde stratificatie behoren. |
| mean_diff_price | 28733.0 | De gemiddelde waarde van het verschil tussen transactieprijs en vraagprijs, van de huizen die tot dezelfde stratificatie behoren. |
| median_diff_price | 42000.0 | De mediaanwaarde van het verschil tussen transactieprijs en vraagprijs, van de huizen die tot dezelfde stratificatie behoren. |
| Feature | Voorbeeld | Uitleg |
|---|---|---|
| stratification | ('A', 'Dorpskern', 'vrijstaand', '1990-2004', '>150') | De meest complete functiestratificatie die in onze database bestaat |
| mean_sales_duration | 118.0 | De gemiddelde waarde van de verkoopduur, uitgedrukt in aantal dagen, van de huizen die tot dezelfde stratificatie behoren. |
| median_sales_duration | 118.0 | De mediaanwaarde van de verkoopduur, uitgedrukt in aantal dagen, van de huizen die tot dezelfde stratificatie behoren. |
| mean_diff_price | -12375.0 | De gemiddelde waarde van het verschil tussen transactieprijs en vraagprijs, van de huizen die tot dezelfde stratificatie behoren. |
| median_diff_price | -17250.0 | De mediaanwaarde van het verschil tussen transactieprijs en vraagprijs, van de huizen die tot dezelfde stratificatie behoren. |
| Feature | Voorbeeld | Explanation |
|---|---|---|
| mean_sales_duration | 6.0 | Hoeveel de gemiddelde verkoopduur, in dagen, zou veranderen als het energielabel van de woning van het huidige energielabel naar het gewenste (streef)energielabel zou gaan. |
| median_sales_duration | 26.0 | Hoeveel de gemiddelde verkoopduur, in dagen, zou veranderen als het energielabel van de woning van het huidige energielabel naar het gewenste (streef)energielabel zou gaan. |
| mean_diff_price | 41108.0 | Hoeveel het gemiddelde verschil van de (transactieprijs – vraagprijs) zou veranderen als het energielabel van de woning van het huidige energielabel naar het gewenste (streef)energielabel zou gaan. |
| median_diff_price | 59250.0 | Hoeveel het mediaan verschil van de (transactieprijs – vraagprijs) zou veranderen als het energielabel van de woning van het huidige energielabel naar het gewenste (streef)energielabel zou gaan. |
| mean_diff_price_percentage | 143.1 | Het percentage (%) verandering van het gemiddelde verschil van de (transactieprijs – vraagprijs) als het energielabel van de woning van het huidige energielabel naar het gewenste (doel) gaat. |
| median_diff_price_percentage | 141.1 | Het percentage (%) verandering van het mediaan verschil van de (transactieprijs – vraagprijs) als het energielabel van de woning van het huidige energielabel naar het gewenste (doel) gaat. |
| ecovalue | 12872 | De verhoging of verlaging van de transactieprijs, indien het energielabel van de woning, gaat van het huidige energielabel naar het gewenste (doel). |
| Feature | Example | Explanation |
|---|---|---|
| address.bag_id | 0499010002023718 | BAG ID |
| address.pand_id | 0499100002015826 | PAND ID |
| address.postcode | 1234AB | Postcode |
| address.housenumber | 1 | Huisnummer |
| address.houseaddition | B | Huisnummer toevoeging |
| address.number_of_floors | 2 | Aantal verdiepingen |
| ground_surface.ground_area | 122.03668975830078 | Oppervlakte begane grond (m2) |
| ground_surface.perimeter | 53.19795020555981 | Omtrek (m) |
| ground_surface.max_length | 13.936105098015044 | Maximale lengte van het gebouw (m) |
| ground_surface.max_width | 12.699969711612086 | Maximale breedte van het gebouw (m) |
| roof_surface.type | sloping | Type dakoppervlak (horizontal or sloping) |
| roof_surface.no_of_surfaces | 4 | Aantal dakoppervlakken |
| voor elk dakoppervlak | ||
| surfaces.orientation | WN | Oriëntatie van het dakoppervlak |
| surfaces.area | 12.652916942719283 | Oppervlakte dakoppervlak (m2) |
| surfaces.perimeter | 25.810687359706225 | Omtrek dakoppervlak (m2) |
| surfaces.roof_angle | 23.7 | Dakhelling (graden) |
| surfaces.geometry.type | Polygon | Geometrie formaat |
| surfaces.geometry.coordinates | [ 105003.892, 453604.067, 3.957 ]... | Coördinaten van het dakoppervlak |
| wall_surface.wall_area | 268.0 | Totaal muuroppervlak (m2) |
| wall_surface.shared_wall_area | 18.08 | Totaal gedeeld muuroppervlak (m2) |
| wall_surface.number_of_surfaces | 44 | Aantal muuroppervlakken |
| voor elk muuroppervlak | ||
| wall_surface.orientation | ES | Oriëntatie van het muuroppervlak |
| wall_surface.area | 0.6297902744652016 | Area of wall surface (m2) |
| wall_surface.perimeter | 4.574356150984596 | Oppervlakte muuroppervlak (m2) |
| wall_surface.geometry.type | Polygon | Geometrie formaat |
| wall_surface.geometry.coordinates | [ 105010.162, 453591.084, 1.815 ]... | Coördinaten van het muuroppervlak |
Reeks van energielabels
Deze percentages geven de nauwkeurigheid aan van de voorspellingen van onze API binnen specifieke foutmarges. Hogere percentages tonen de betrouwbaarheid en consistentie van de prestaties van onze API aan.
Deze percentages geven de nauwkeurigheid aan van de voorspellingen van onze API binnen specifieke foutmarges. Hogere percentages tonen de betrouwbaarheid en consistentie van de prestaties van onze API aan.
Deze percentages geven de nauwkeurigheid aan van de voorspellingen van onze API binnen specifieke foutmarges. Hogere percentages tonen de betrouwbaarheid en consistentie van de prestaties van onze API aan.
Deze percentages geven de nauwkeurigheid aan van de voorspellingen van onze API binnen specifieke foutmarges. Hogere percentages tonen de betrouwbaarheid en consistentie van de prestaties van onze API aan.
Deze percentages geven de nauwkeurigheid aan van de voorspellingen van onze API binnen specifieke foutmarges. Hogere percentages tonen de betrouwbaarheid en consistentie van de prestaties van onze API aan.
Deze percentages geven de nauwkeurigheid aan van de voorspellingen van onze API binnen specifieke foutmarges. Hogere percentages tonen de betrouwbaarheid en consistentie van de prestaties van onze API aan.
{
"detail": "Could not find any object with your BAG ID."
}
{
"detail": "Could not find any object with your BAG ID."
}
{
"post_code": "4709BM",
"house_number": 1,
"house_addition": "A",
"installation": 1,
"wall_insulation": 3,
"roof_insulation": 2,
"floor_insulation": 2,
"living_room_windows": 3
}
{
"bag_id": "0637010000264937",
"installation": 1,
"wall_insulation": 3,
"roof_insulation": 2,
"floor_insulation": 2,
"living_room_windows": 3
}
statistisch gebaseerd op def. BENG2 or def. energy label = 1,
aangevuld/bepaald met externe bronnen = 2, op basis van bouwregelgeving = 3, op basis van gebruikersinvoer = 4
| #### Voorbeeld resultaat ``` { "Output": { "post_code": "2771DS", "house_number": 87, "house_addition": null, "build_year": 1961, "inner_surface_area": 131, "house_type": "vrijstaand", "installation": 4, "wall_insulation": 0, "roof_insulation": 2, "floor_insulation": 2, "living_room_windows": 1, "bedroom_windows": 1, "shower": 0, "ventilation": 0, "solar_panels": 0, "solarpanel_watt_peak": 212, "CO2": 5292, "definitive_energy_label": "C", "definitive_energy_label_type": "NEN7120", "definitive_energy_label_validity_date": "2030-12", "definitive_BENG2_score": null, "current_estimated_energy_label": "C", "current_estimated_BENG1_score": 146, "current_estimated_BENG2_score": 211, "estimated_gas_usage": 3147, "estimated_energy_usage": 3686, "estimated_city_heating_usage": 0, "measures_method": 1 } } ``` # NTA 8800 Energielabel v2 API Welkom bij de documentatie van de NTA 8800 Energielabel v2 API. Deze API combineert verschillende bronnen en methoden voor nauwkeurige energielabelschattingen. ## Introductie De NTA 8800 Energielabel API v2 schat de huidige energieprestatie van Nederlandse woningen op basis van de NTA 8800-methodiek: de officiële Nederlandse standaard voor het berekenen van energielabels. Met de API kun je het huidige energielabel van een woning schatten en de aanwezige verduurzamingsmaatregelen ophalen. De API werkt met minimale adresinvoer, maar ondersteunt ook gedetailleerde woningkenmerken. Zo kun je per toepassing kiezen tussen snelheid en nauwkeurigheid. Typische toepassingen zijn verduurzamingsplatformen, vastgoedtools, woningwaarderingsmodellen en financiële applicaties die schaalbaar inzicht nodig hebben in de energieprestatie van woningen. ### Kernmogelijkheden #### Geschat energielabel berekenen De API schat het huidige energielabel van een woning op basis van beschikbare gebouwdata en voorspellende modellen die aansluiten op de NTA 8800-methodiek. Het resultaat bevat onder andere: * Geschat energielabel: A++++ t/m G * Geschatte BENG2-score: primair fossiel energiegebruik * Geschatte energieverbruikswaarden * Geschat verbruik voor gas, elektriciteit en stadsverwarming, inclusief CO₂-uitstoot * Relevante duurzaamheidsindicatoren Deze resultaten geven snel inzicht in het huidige energieprestatieniveau van een woning.Range of Energy labels
| Veld | Type | Omschrijving | Voorbeeld/Standaard |
|---|---|---|---|
| postcode* | string | Zes-cijferige postcode | 1234AB |
| housenumber* | integer | Huisnummer | 1 |
| houseaddition | string | Huisnummertoevoeging | A |
| build_year | integer | Bouwjaar | 1960 |
| roof_type | integer |
Als het platte of hellende deel meer dan 25% van het dakoppervlak beslaat, wordt type | Standaard: 1 |
| house_type | integer |
| 2 |
| inner_surface_area | float | Woonoppervlakte (m²) | 70 |
| wall_insulation | integer | Bekijk Maatregelen | 2 |
| floor_insulation | integer | Bekijk Maatregelen | 2 |
| sloped_roof_insulation | integer | Bekijk Maatregelen | 2 |
| flat_roof_insulation | integer | Bekijk Maatregelen | 2 |
| living_room_windows | integer | Bekijk Maatregelen | 2 |
| bedroom_windows | integer | Bekijk Maatregelen | 2 |
| installation | integer | Bekijk Maatregelen | Standaard: 4 |
| shower | integer | Bekijk Maatregelen | Standaard: 1 |
| cooling | integer | Is er een koelsysteem aanwezig?
| Standaard: 1 |
| ventilation | integer | Bekijk Maatregelen | 1 |
| electric_cooking | integer | Waar wordt mee gekookt?
| Standaard: 2 als installation gelijk is aan 6 of 7, anders 1. |
| inhabitants | integer | Aantal bewoners van de woning | Standaard: 3 |
| ev_charger | integer | Heeft het gebouw een laadpaal voor elektrische voertuigen?
| Standaard: 0 |
| electricity_connection_type | integer | Het aansluitingstype van het gebouw
| Standaard: 1 |
| electricity_contract_type | integer | Type elektriciteitscontract
| Standaard: 1 |
| dynamic_price_reference_year | integer | Het jaar vanaf wanneer dynamische prijzen worden gebruikt:
| Standaard: 2025 |
| netting_enabled | integer | Of de salderingsregeling wordt toegepast.
| Standaard: 1 |
| solar_panels | list | Bekijk Maatregelen | |
| number_of_solar_panels | integer | Bekijk Maatregelen | |
| battery_type | integer | Bekijk Maatregelen | |
| battery_system | integer | Bekijk Maatregelen |
{
"postcode": "2771DS",
"housenumber": 87,
"houseaddition": "",
"build_year" : 1961,
"house_type": 1,
"roof_type": 1,
"inner_surface_area": 131
}
{
"postcode": "2771DS",
"housenumber": 87,
"houseaddition": "",
"solar_panels": [{"pv_total_watt_peak":2000,
"angle":45,
"orientation":180,
"roof_type": 1},
{"pv_area": 20,
"specific_watt_peak": 150,
"angle":45,
"orientation":180,
"roof_type": 1}]
}
{
"postcode": "2771DS",
"housenumber": 87,
"houseaddition": "",
"number_of_solar_panels": 10
}
| Veld | Type | Beschrijving | Voorbeeld |
|---|---|---|---|
| warnings | list | Bekijk Waarschuwingen | |
| postcode | string | postcode | 1234AB |
| housenumber | integer | Huisnummer | 1 |
| houseaddition | string | Huisnummer toevoeging | A |
| build_year | integer | Bouwjaar | 1961 |
| inner_surface_area | integer | Woonoppervlakte (m²) | 70 |
| house_type | string | Woningtype | Vrijstaand |
| installation | integer | Bekijk Maatregelen | 4 |
| wall_insulation | integer | Bekijk Maatregelen | 2 |
| sloped_roof_insulation | integer | Bekijk Maatregelen | 2 |
| flat_roof_insulation | integer | Bekijk Maatregelen | 2 |
| floor_insulation | integer | Bekijk Maatregelen | 2 |
| living_room_windows | integer | Bekijk Maatregelen | 2 |
| bedroom_windows | integer | Bekijk Maatregelen | 1 |
| shower | integer | Bekijk Maatregelen | 1 |
| ventilation | integer | Bekijk Maatregelen | 1 |
| cooling | integer |
| 1 |
| electric_cooking | integer |
| 1 |
| solar_panels | dict | Bekijk Maatregelen | |
| CO2 | integer | De totale CO₂-uitstoot, bekijk CO₂-uitstoot. | 3084 |
| grid_import | integer | Jaarlijkse elektriciteit uit het elektriciteitsnet in kWh. | 2058 |
| grid_feed | integer | Jaarlijkse elektriciteit die aan het elektriciteitsnet wordt teruggeleverd, in kWh. | 2808 |
| electricity_need | integer | Jaarlijkse elektriciteitsvraag in kWh. | 1405 |
| definitive_energy_label | string | Definitief energielabel uit RVO’s EP-online. | A |
| definitive_energy_label_type | string | Norm waarop het definitieve energielabel is gebaseerd. | NEN7120 |
| definitive_energy_label_validity_date | string | Einddatum van de geldigheid van het opgegeven definitieve energielabel. | 2030-12 |
| definitive_BENG2_score | integer | Definitieve BENG2-score van het energielabel uit RVO’s EP-online. | 125 |
| current_estimated_energy_label | string | Geschat huidig NTA 8800-energielabel op basis van gebouwkenmerken en maatregelen. Voor measures_method 2 en 3 wordt dit voorspeld met machine learning. | A |
| current_estimated_BENG2_score | integer | Numerieke BENG2-score van het geschatte huidige NTA 8800-energielabel. | 128 |
| estimated_gas_usage | integer | Geschat gasverbruik per jaar in m³. | 2172 |
| estimated_energy_usage | integer | Geschat elektriciteitsverbruik per jaar in kWh. | 2800 |
| estimated_city_heating_usage | integer | Geschat warmteverbruik per jaar in GJ. | 1300 |
| measures_method | integer |
| 1 |
| accuracy_indicator | integer | Bekijk Nauwkeurigheidsindicator | 5 |
| Veld | Type | Omschrijving | Voorbeeld/Standaard |
|---|---|---|---|
| postcode* | string | Zes-cijferige postcode | 1234AB |
| housenumber* | integer | Huisnummer | 1 |
| houseaddition | string | Huisnummertoevoeging | A |
| position | integer | 1 = hoekappartement op de begane grond2 = tussenappartement op de begane grond3 = hoekappartement op een tussenverdieping4 = tussenappartement op een tussenverdieping5 = hoekappartement op de bovenste verdieping6 = tussenappartement op de bovenste verdieping7 = volledige bovenste verdieping (penthouse) | Standaard: 1 |
| floors | integer | Heeft de woning één of meerdere woonlagen?
| Standaard: 1 |
| back_facade | boolean | Heeft de woning een achtergevel?
| Standaard: false |
| build_year | integer | Bouwjaar | 1960 |
| inner_surface_area | float | Woonoppervlakte (m²) | 70 |
| apartment_type | integer | 1 = 'Galerijflat'
2 = 'Portiekflat'
3 = 'Maisonnette'
4 = 'Benedenwoning'
5 = 'Bovenwoning'
6 = 'Portiekwoning'
| 2 |
| wall_insulation | integer | Bekijk Maatregelen | 2 |
| floor_insulation | integer | Bekijk Maatregelen | 2 |
| roof_insulation | integer | Bekijk Maatregelen | 2 |
| living_room_windows | integer | Bekijk Maatregelen | 2 |
| installation | integer | Bekijk Maatregelen | Standaard: 4 |
| shower | integer | Bekijk Maatregelen | Standaard: 1 |
| cooling | integer | Is er een koelsysteem aanwezig?
| Standaard: 1 |
| ventilation | integer | Bekijk Maatregelen | 1 |
| electric_cooking | integer | Waar wordt mee gekookt?
| Standaard: 2 als installation gelijk is aan 6 of 7, anders 1. |
| inhabitants | integer | Aantal bewoners van de woning | Standaard: 3 |
| solar_panels | list | Bekijk Maatregelen | |
| number_of_solar_panels | integer | Bekijk Maatregelen |
{
"postcode": "3024XL",
"housenumber":227,
"houseaddition": "B",
"position": 3,
"floors": 1,
"build_year" : 1961,
"apartment_type": 1,
"inner_surface_area": 131
}
{
"postcode": "3024XL",
"housenumber":227,
"houseaddition": "B",
"position": 3,
"floors": 1,
"solar_panels": [{"pv_total_watt_peak":2000,
"angle":45,
"orientation":180},
{"pv_area": 20,
"specific_watt_peak": 150,
"angle":45,
"orientation":180}]
}
{
"postcode": "3024XL",
"housenumber":227,
"houseaddition": "B",
"number_of_solar_panels": 10
}
| Veld | Type | Omschrijving | Voorbeeld |
|---|---|---|---|
| warnings | list | Bekijk Waarschuwingen | |
| postcode | string | zes-cijferige postcode | 1234AB |
| housenumber | integer | Huisnummer | 1 |
| houseaddition | string | Huisnummer toevoeging | A |
| build_year | integer | Bouwjaar | 1961 |
| inner_surface_area | integer | Woonoppervlakte (m²) | 70 |
| apartment_type | string | Appartementtype | Portiekwoning |
| installation | integer | Bekijk Maatregelen | 4 |
| wall_insulation | integer | Bekijk Maatregelen | 2 |
| roof_insulation | integer | Bekijk Maatregelen | 2 |
| floor_insulation | integer | Bekijk Maatregelen | 2 |
| living_room_windows | integer | Bekijk Maatregelen | 2 |
| shower | integer | Bekijk Maatregelen | 1 |
| ventilation | integer | Bekijk Maatregelen | 1 |
| cooling | integer |
| 1 |
| electric_cooking | integer |
| 1 |
| solar_panels | list | Bekijk Maatregelen | |
| CO2 | integer | De totale CO₂-uitstoot, bekijk CO₂-uitstoot | 3084 |
| definitive_energy_label | string | Definitief energielabel uit RVO’s EP-online. | A |
| definitive_energy_label_type | string | Norm waarop het definitieve energielabel is gebaseerd. | NEN7120 |
| definitive_energy_label_validity_date | string | Einddatum van de geldigheid van het opgegeven definitieve energielabel. | 2030-12 |
| definitive_BENG2_score | integer | Definitieve BENG2-score van het energielabel uit RVO’s EP-online. | 125 |
| current_estimated_energy_label | string | Geschat huidig NTA 8800-energielabel op basis van gebouwkenmerken en maatregelen. Voor measures_method 2 en 3 wordt dit voorspeld met machine learning. | A |
| current_estimated_BENG2_score | integer | Numerieke BENG2-score van het geschatte huidige NTA 8800-energielabel. | 128 |
| estimated_gas_usage | integer | Geschat gasverbruik per jaar in m³. | 2172 |
| estimated_energy_usage | integer | Geschat elektriciteitsverbruik per jaar in kWh. | 2800 |
| estimated_city_heating_usage | integer | Geschat warmteverbruik per jaar in GJ. | 1300 |
| solar_panel_yield | integer | Jaarlijkse elektriciteitsopbrengst in kWh. | 1000 |
| measures_method | integer |
| 1 |
| accuracy_indicator | integer | Bekijk Nauwkeurigheidsindicator | 5 |
{
"code": "03",
"description": "wall_insulation: 2 is not allowed for build_year: 2010. Allowed values: [4]. Set wall_insulation: 4."
}
| Veld | Type | Beschrijving |
|---|---|---|
postcode | string | postcode in zeskarakterformaat, bijvoorbeeld 1234AB |
huisnummer | string | huisnummer van het object, bijvoorbeeld 1 |
huisletter | string | toevoeging aan het huisnummer, bijvoorbeeld A |
imagery_source | string | Bron van de gebruikte luchtfoto. |
annotated_image_url | string | Een openbare URL naar de afbeelding waarop de gedetecteerde zonnepanelen zijn weergegeven. |
imagery_date | date | Datum waarop de luchtfoto is gemaakt. |
num_panels_detected | integer | Het totale aantal gedetecteerde zonnepanelen (of andere objecten). |
estimation_method | string | "detected", "detected_unmasked", or "estimated" |
error_margin | int | null | ± panels of uncertainty around num_panels_detected |
detections | array | Een array van JSON-objecten, waarbij elk object een gedetecteerd zonnepaneel beschrijft, inclusief label, betrouwbaarheids-score en bounding box-coördinaten. |