Inputuitleg voor versie 01-07-2024

Deze pagina gaat over de invoerfuncties voor de eindpunten die bedoeld zijn voor versie 01-07-2024. Er wordt een volledige uitleg gegeven van de functies, en ook de structuur van de invoer en de blokk

Overzicht

Deze pagina beschrijft de JSON-structuur die vereist is voor het indienen van eigendomsgegevens bij de API. Elke sectie van de JSON komt overeen met verschillende aspecten van een eigendom, waaronder kamers, keukenfuncties, parkeren, sanitaire voorzieningen en meer.

A. Zelfstandige woning

Algemene eigenschappen van een eigenschap

• house_type: Type van het huis.

• build_year: Jaar waarin het gebouw is gebouwd.

• energy_label: Energielabel NTA 8800 (uitgegeven na 1 januari 2021) of energielabel NEN 7120 (uitgegeven vóór 1 januari 2021).

• energy_index_existence: Geeft aan of er een energie-index beschikbaar is. Als deze waarde True is, wordt de energie-index gebruikt voor de berekening van de punten en moet de gebruiker een geldige energie-index invoeren.

• energy_index: Numerieke waarde die de energie-efficiëntie weergeeft.

• energy_performance_compensation: Controleer hier de definitie om te bepalen of deze waarde waar of onwaar moet zijn.

• energy_valuation_date: Datum van vaststelling van het energielabel in het formaat "ddmmjjjj".

• energy_label_type : Het type energielabel. Als het 'NTA 8800' OF 'NEN 7120' is

• disability_costs: Kosten die verband houden met aanpassingen voor gehandicapten.

• disabled_people: Aantal personen met een beperking dat in de woonruimte woont.

• monument: Geeft aan of het gebouw een nationaal, provinciaal of gemeentelijk monument is, of helemaal geen monument.

• doorbell: Geeft aan of er een deurbel is die aan de vereisten voldoet.

• woz_value: Taxatie volgens de WOZ (Waardering Onroerende Zaken).

• woz_valuation_year: Jaar van de WOZ-waardering.

• usable_surface_area: Totale bruikbare oppervlakte in vierkante meters.

• corop_area_amsterdam_or_utrecth: Geeft aan of het pand zich in het COROP-gebied Amsterdam of Utrecht bevindt.

• care_home: Geeft aan of het gebouw als verzorgingshuis wordt gebruikt.

Blokken

1. 'rooms' blokken

Overzicht

Het rooms blokken is gestructureerd om elke kamer in het pand te detailleren die geen keuken of sanitaire ruimte is.

Binnenkenmerken

• type_of_room: Maakt onderscheid tussen twee typen: 'room' en 'other'. Controleer hier de vereisten voor elke categorie.

• attic_without_fixed_staircase: Als de ingevoerde kamer (geclassificeerd met type 'other') een zolder is, dan moet deze feature true zijn als deze geen vaste trap heeft, anders false.

• surface_area: Geeft het binnenoppervlak van de kamer in vierkante meters aan.

• shared_addresses: Geeft aan hoeveel adressen toegang hebben tot en gebruiksrecht hebben voor de kamer.

• heated: Geeft aan of de kamer verwarming heeft.

• cooled: Geeft aan of de kamer airconditioning of koelsystemen heeft.

Als alleen uw adres toegang en gebruiksrecht heeft tot de kamer, dan moet de 'shared_addresses'-functie de waarde 1 krijgen.

Flexibiliteit: Gebruikers kunnen zoveel kamers toevoegen als nodig is in het 'rooms'-blok, elk met zijn eigen gedetailleerde specificaties.

Voorbeeldstructuur van 3 kamers in het 'rooms'-blok, in de invoer:

"rooms": [
    {
      "type_of_room": "room",
      "attic_without_fixed_staircase": false,
      "surface_area": 10.0,
      "shared_addresses": 1,
      "heated": true,
      "cooled": true
    },
    {
      "type_of_room": "room",
      "attic_without_fixed_staircase": false,
      "surface_area": 10.0,
      "shared_addresses": 1,
      "heated": true,
      "cooled": true
    },
    {
      "type_of_room": "other",
      "attic_without_fixed_staircase": false,
      "surface_area": 10.0,
      "shared_addresses": 1,
      "heated": true,
      "cooled": false
    }
  ]

2. 'kitchen' blokken

Overzicht

Het kitchen blokken legt gedetailleerde configuraties en kenmerken van keukenopstellingen binnen het pand vast. Dit omvat het specificeren van het type en de functionaliteit van de keuken, samen met een lijst met apparaten en functies die de mogelijkheden en aantrekkingskracht van de keuken definiëren.

Binnenfuncties

• type_of_room: Geeft aan of de keuken op basis van deze vereisten is gecategoriseerd als 'kamer' of 'anders'.

• open_kitchen: Deze functie moet waar zijn als de keuken zich in een open ruimte bevindt die is verbonden met een andere kamer en het geen op zichzelf staande kamer is. Bekijk hier alle vereisten voor een open keuken.

• surface_area: Geeft het binnenoppervlak van de keuken in vierkante meters aan.

• countertop_length: Meet de lengte van de aanrechtbladen van de keuken.

• shared_addresses: Aantal adressen dat toegang heeft tot en gebruiksrecht heeft voor de keuken.

• heated: Geeft aan of de keukenruimte is uitgerust met verwarming.

• cooled: Geeft aan of de keukenruimte is uitgerust met koelsystemen.

• kitchen_features: Een uitgebreide lijst met keukenapparaten en -functies, waaronder:

  • extractor_system

  • induction_hob

  • ceramic_hob

  • gas_hob

  • refrigerator

  • freezer

  • oven_electric

  • oven_gas

  • microwave

  • dishwasher

  • extra_cupboard_space_per_60cm

  • one_hand_mixer_tap

  • one_hand_mixer_tap_with_boiling_function

  • thermostatic_mixer_tap

  • thermostatic_mixer_tap_with_boiling_function

Als alleen uw adres toegang en gebruiksrecht tot de keuken heeft, moet de functie 'shared_addresses' de waarde 1 krijgen.

Flexibiliteit: Gebruikers kunnen zoveel keukens toevoegen in het 'keuken'-blok als nodig is, elk met zijn eigen gedetailleerde specificaties. Dit is handig voor panden met meerdere keukens.

Voorbeeldstructuur van 3 keukens in het 'keuken'-blok, in de invoer:

"kitchen": [
    {
      "type_of_room": "room",
      "open_kitchen": false,
      "surface_area": 10,
      "countertop_length": 2.5,
      "shared_addresses": 1,
      "heated": true,
      "cooled": true,
      "kitchen_features": {
        "extractor_system": 1,
        "induction_hob": 1,
        "ceramic_hob": 1,
        "gas_hob": 1,
        "refrigerator": 1,
        "freezer": 1,
        "oven_electric": 1,
        "oven_gas": 1,
        "microwave": 1,
        "dishwasher": 1,
        "extra_cupboard_space_per_60cm": 1,
        "one_hand_mixer_tap": 1,
        "one_hand_mixer_tap_with_boiling_function": 1,
				"thermostatic_mixer_tap": 1, 
        "thermostatic_mixer_tap_with_boiling_function": 1
      }
    },
		{
      "type_of_room": "room",
      "open_kitchen": false,
      "surface_area": 10,
      "countertop_length": 1.5,
      "shared_addresses": 1,
      "heated": true,
      "cooled": true,
      "kitchen_features": {
        "ceramic_hob": 2,
        "freezer": 1,
        "extra_cupboard_space_per_60cm": 2
      }
    },
		 {
      "type_of_room": "room",
      "open_kitchen": true,
      "surface_area": 10,
      "countertop_length": 0.5,
      "shared_addresses": 1,
      "heated": true,
      "cooled": true,
      "kitchen_features": {
        "oven_electric": 2,
        "dishwasher": 1,
        "one_hand_mixer_tap_with_boiling_function": 2
      }
    }
  ]

3. 'sanitary' blokken

Overzicht

Het sanitary blokken is ontworpen om gedetailleerde informatie over de sanitaire installaties in het pand vast te leggen, met de nadruk op badkamers, doucheruimtes en soortgelijke faciliteiten.

Binnenkenmerken

• type_of_room: Geeft aan of het sanitair op basis van deze vereisten is gecategoriseerd als 'kamer' of 'anders'.

• surface_area: Geeft het binnenoppervlak van het sanitair in vierkante meters aan.

• heated: Of de ruimte is uitgerust met verwarming.

• cooled: Of de ruimte koelfaciliteiten heeft.

• shower_facility: Beschrijft het type douchefaciliteiten dat beschikbaar is, met de keuze tussen 'bad', 'douche' of 'douche/bad'.

• toilet: Geeft het aantal toiletten in de sanitaire ruimte aan.

• wall_hung_toilet: Geeft het aantal aan de muur hangende toiletten in de sanitaire ruimte aan. Als er bijvoorbeeld maar één toilet is en het aan de muur hangt, moet deze feature 1 zijn en de toiletfeature 0.

• shared_addresses: Hoeveel adressen hebben toegang tot en gebruiksrecht van de sanitaire ruimte.

• sanitary_features: Gedetailleerde kenmerken van sanitaire voorzieningen en voorzieningen, waaronder:

  • washbasin: Aantal wasbakken.

  • multi_person_washbasin: Aantal wasbakken voor meerdere personen.

  • cupboard_space: Geeft aan of er extra opbergruimte beschikbaar is.

  • power_outlet: Aantal beschikbare stopcontacten.

  • build_in_cupboard: Aantal ingebouwde kasten.

  • complete_separation_of_shower: Aantal douches die volledig van het bad kunnen worden gescheiden.

  • bath_with_bubble_function: Aantal baden met bubbelfunctie.

  • one_hand_mixer_tap: Aantal mengkranen die met één hand kunnen worden bediend.

  • thermostatic_mixer_tap: Aantal thermostatische mengkranen die een constante temperatuur behouden.

  • towel_radiator: Aantal handdoekradiatoren.

Als alleen uw adres toegang en gebruiksrecht heeft tot het sanitair, dan moet de functie 'shared_addresses' de waarde 1 krijgen.

Flexibiliteit: Gebruikers kunnen zoveel sanitaire voorzieningen toevoegen in het blok 'sanitair' als nodig is, elk met zijn eigen gedetailleerde specificaties. Dit is handig voor panden met meerdere sanitaire voorzieningen.

Voorbeeldstructuur van 2 sanitaire voorzieningen in het blok 'sanitair', in de invoer:

"sanitary": [
    {
      "type_of_room": "room",
      "surface_area": 10,
      "heated": true,
      "cooled": true,
      "shower_facility": "shower/bath",
      "toilet": 2,
      "wall_hung_toilet": 1,
      "shared_addresses": 1,
      "sanitary_features": {
        "washbasin": 1,
        "multi_person_washbasin": 2,
        "cupboard_space": true,
        "power_outlet": 3,
        "build_in_cupboard": 1,
        "complete_separation_of_shower": 2,
        "bath_with_bubble_function": 0,
        "one_hand_mixer_tap": 0,
        "thermostatic_mixer_tap": 0,
        "towel_radiator": 0
      }
    },
		{
      "type_of_room": "room",
      "surface_area": 10,
      "heated": true,
      "cooled": true,
      "shower_facility": "shower/bath",
      "wall_hung_toilet": 2,
      "shared_addresses": 2,
      "sanitary_features": {
        "washbasin": 4,
        "power_outlet": 9,
        "bath_with_bubble_function": 1,
        "one_hand_mixer_tap": 1
      }
    }
  ]

4. 'toilet' blokken

Overzicht

Het toilet blokken geeft gedetailleerde informatie over de toiletvoorzieningen afzonderlijk, met de nadruk op specifieke kenmerken die de bruikbaarheid en normen van toiletinstallaties in het pand definiëren.

Binnenkenmerken

• type_of_room: Geeft aan of de toiletruimte op basis van deze vereisten is gecategoriseerd als 'ruimte' of 'anders'.

• surface_area: Het binnenoppervlak van de toiletruimte in vierkante meters.

• heated: Geeft aan of er verwarming in de toiletruimte is.

• cooled: Geeft aan of er koelsystemen in de toiletruimte zijn geïnstalleerd.

• wall_hung_toilet: Een boolean die aangeeft of het toilet aan de muur is bevestigd.

• washbasin: Het aantal beschikbare wastafels.

• shared_addresses: Geeft aan hoeveel eenheden of appartementen deze toiletvoorziening delen.

Als alleen uw adres toegang en gebruiksrecht heeft tot het sanitair, dan moet de 'shared_addresses'-functie de waarde 1 krijgen.

Flexibiliteit: Gebruikers kunnen zoveel toiletruimtes toevoegen in het 'toilet'-blok als nodig is, elk met zijn eigen gedetailleerde specificaties. Dit is handig voor panden met meerdere toiletruimtes.

Voorbeeldstructuur van 1 toiletruimte in het 'toilet'-blok, in de invoer:

 "toilet": [
    {
      "type_of_room": "room",
      "surface_area": 35,
      "heated": true,
      "cooled": false,
      "wall_hung_toilet": 1,
      "washbasin": 2,
      "shared_spaces": 1,
      "shared_addresses": 1
    }
  ]

5. 'outdoor' blokken

Overzicht

Het outdoor blokken is ontworpen om gedetailleerde informatie vast te leggen over buitenruimtes die bij het pand horen. Deze ruimtes kunnen tuinen, patio's, balkons of andere open ruimtes zijn die deel uitmaken van de indeling van het pand.

Binnenkenmerken

• surface_area: De totale oppervlakte van de buitenruimte in vierkante meters.

Als er meer dan 1 buitenruimte is met dezelfde kenmerken, bijvoorbeeld twee ruimtes die beide voldoen aan de vereisten om een ​​buitenruimte te zijn en ze worden beide gedeeld door hetzelfde aantal adressen, kan de oppervlakte van deze 2 ruimtes worden opgeteld en worden ingevoerd als één waarde voor de 'surface_area'-functie. Als de ruimtes worden gedeeld door een verschillend aantal adressen, kunnen ze worden toegevoegd als twee verschillende blokken binnen het 'outdoor'-blok.

• shared_addresses: Geeft het aantal adressen aan dat toegang heeft tot en gebruiksrecht heeft op de specifieke buitenruimte.

Als alleen uw adres toegang heeft tot en gebruiksrecht heeft op de buitenruimte, moet de 'shared_addresses'-functie de waarde 1 krijgen.

Flexibiliteit: Gebruikers kunnen zoveel buitenruimtes toevoegen aan het 'outdoor'-blok als nodig is, elk met zijn eigen gedetailleerde specificaties. Dit is handig voor eigendommen met meerdere buitenruimtes.

Voorbeeldstructuur van 1 buitenruimte in het blok 'buiten', in de invoer:

"outdoor": [
    {
      "surface_area": 50.0,
      "shared_addresses": 1
    }
  ]

6. 'parking' blokken

Overzicht

Het parking blokken is ontworpen om belangrijke informatie vast te leggen over de parkeerfaciliteiten die beschikbaar zijn bij het pand

Structuur en functionaliteit

• parking_type: Identificeert het type parkeergelegenheid dat wordt aangeboden.

• shared_addresses: Geeft het aantal verschillende adressen aan dat toegang en gebruiksrecht heeft.

• charging_station: Een booleaanse waarde die aangeeft of de parkeervoorziening een laadstation omvat. Het laadstation moet uitsluitend bestemd zijn voor gebruik door bewoners en bedoeld zijn voor het elektrisch opladen van een gemotoriseerd voertuig, anders dan een bromfiets, fiets met trapondersteuning of gehandicaptenvoertuig.

Als alleen uw adres toegang en gebruiksrecht tot de parkeerplaats heeft, moet de functie 'shared_addresses' de waarde 1 krijgen.

Flexibiliteit: Gebruikers kunnen zoveel parkeerplaatsen toevoegen in het blok 'parkeren' als nodig is, elk met zijn eigen gedetailleerde specificaties. Dit is handig voor panden met meerdere parkeerplaatsen.

Voorbeeldstructuur van 1 parkeerplaats in het blok 'buiten', in de invoer:

"parking": [
    {
      "parking_type": 2,
      "shared_addresses": 1,
      "charging_station": true
    }
  ]

B. Niet-Zelfstandige woning

Algemene eigenschappen van het pand

• build_year: Jaar waarin het gebouw is gebouwd.

• energy_label: Een geldig energielabel van het pand

• energy_index_existence: Geeft aan of er een energie-index beschikbaar is. Als deze waarde True is, wordt de energie-index gebruikt voor de berekening van de punten en moet de gebruiker een geldige energie-index invoeren.

• energy_index: Numerieke waarde die de energie-efficiëntie weergeeft.

• disability_costs: Kosten die verband houden met voorzieningen voor gehandicapten.

• disabled_people: Aantal gehandicapten dat in de woonruimte woont.

• monument: Geeft aan of het gebouw een nationaal, provinciaal of gemeentelijk monument is, of helemaal geen monument.

• doorbell: Geeft aan of er een deurbel is die aan de vereisten voldoet.

• glass_surface_living_room: Als het glasoppervlak in de (hoofd)woonkamer kleiner is dan 0,75 m2, moet deze functie true zijn.

• lowest_window_frame_living_room: Als het laagste raamkozijn van de (hoofd)woonkamer meer dan 1,60 m boven de vloer ligt, dan moet deze feature waar zijn.

• accessibility_via_landlord: Als de verhuurder van de onzelfstandige wooneenheid zijn hoofdverblijf heeft in de woning waarvan de onzelfstandige wooneenheid deel uitmaakt en de onzelfstandige wooneenheid of de sanitaire voorzieningen waartoe de huurder toegang en gebruiksrecht heeft, alleen via een woon- of slaapkamer van de verhuurder te bereiken zijn, dan moet deze feature waar zijn.

• woz_value: Waardering volgens de WOZ (Waardering Onroerende Zaken).

• woz_valuation_year: Jaar van de WOZ-waardering.

• usable_surface_area: Totale gebruiksoppervlakte in vierkante meters.

• corop_region: Geeft de corop-regio aan waartoe het pand behoort.

• care_home: Geeft aan of het gebouw wordt gebruikt als verzorgingshuis.

Blokken

De blokken en hun kenmerken zijn hetzelfde als de onafhankelijke woonruimtes, met uitzondering van het feit dat er in alle blokken nog een kenmerk is genaamd 'shared_spaces'.

Uitleg van de functie 'share_spaces':

Deze functie vertegenwoordigt het aantal woonruimtes dat toegang en gebruiksrecht heeft tot de bijbehorende kamer (kamer, andere, sanitair, toilet, keuken, buitenruimte, parkeerplaats).

Als alleen uw woonruimte toegang en gebruiksrecht heeft tot de bijbehorende kamer, dan moet deze functie de waarde 1 hebben.