02. Definitie van een object

In het ZIP-bestand bevinden zich XML-bestanden. Elk XML-bestand bevat een definitie van één object in XML-formaat.

Een xml bestand heeft de structuur zoals gespecificeerd in het XSD bestand welke hieronder gedownload kan worden:

• Versie 3 (huidige versie)
• Versie 2
• Versie 1

Aangeraden wordt om een programma als XMLSpy te gebruiken om dit bestand te bestuderen.

Hieronder vindt u een overzicht welke nodes u per object in dit XML-formaat kunt aantreffen met daarbij een korte beschrijving.

AreaTotals

Deze node bevat oppervlakteinformatie over de verschillende delen van het object, waaronder van kelderruimte, woonkamer en opslagruimten. Woonoppervlakte is terug te vinden onder de node LivableArea.

Attachments

Deze node bevat informatie over bijlagen bij een object. Hieronder vallen foto's, video's, kaarten en ander soortig materiaal.

Elke bijlage (Attachment) heeft twee eigenschappen, welke kunnen veranderen wanneer de bijlage wordt bijgewerkt. Indien één van beide eigenschappen veranderd zijn, dient de bijlage opnieuw opgehaald te worden:

• Hash
• ModificationDateTime

Wanneer de Hash van een bijlage gewijzigd is, weet u dat de bijlage zelf gewijzigd is en u deze dus opnieuw moet downloaden naar uw eigen server.

ClimatControl

Deze node bevat informatie over de aanwezige verwarming in het object en toegekende energielabels. Informatie over energielabels is te vinden in de nodes EnergyCertificate/HasEnergyCertificate en EnergyCertificate/EnergyClass. Of er een cvketel aanwezig is, is te vinden in de node Heating (HeatingAllocation is type CENTRAL). De leeftijd van de cvketel is te vinden in de node Heating/YearOfManufacture, het type cvketel in de node Heating/TypeOfBoiler. Of het electrisch, gas of anderszins gestookte cvbetreft, in terig te vinden in de node Heating/EnergySource. De eigenaar van de verwarmingsinstallatie is terug te vinden in Heating/Ownership. Of het een combiketel betreft staat in de node Heating/IsCombiBoiler. Voor meer informatie rond specifieke boilertypes controleer je het type boiler (Heating/TypeOfBoiler) en dan de gewenste eigenschap.

Construction

Deze node bevat informatie over de periode waarin het object gebouwd is. Daarnaast wordt in de node IsNewState vermeld of het de 'nieuw' status heeft. Of een object in aanbouw is, vind je in de node IsUnderConstruction. ConstructionYearFrom bevat het jaartal waarin met de bouw is gestart. ConstructionYearTo bevat het jaar waarin de bouw is afgerond. Deze gegevens kunnen ook ontbreken, maar dan zou de globalere ConstructionPeriod mogelijk nog ingevuld kunnen zijn. Onder de nodes Reconstruction en RenovationYear kun je respectievelijk terugvinden of er renovatie of herbouw heeft plaatsgevonden en wanneer dit is gebeurd.

Informatie over het dak kan teruggevonden worden in de node Roof. Hier is terug te vinden welk type dak het betreft, welke materialen zijn gebruikt (Roof/RoofMaterials), wat de staat van het dak is (Roof/RoofEvaluation) en eventuele opmerkingen (Roof/RoofComments). Indien er dakisolatie aanwezig is, bevat de node IsolationTypes het type ROOF. Voor dubbelglas is er een node Glazing/GlazingType van het type DOUBLE, voor gedeelde glasisolatie bevat Glazing/GlazingType type PARTLY_DOUBLE.

Indien het ecobouw betreft, bevat node IsolationTypes een type ECO_CONSTRUCTION. Hier worden ook andere isolatietypen vermeld. Opmerkingen over isolatie zijn te vinden in node IsolationComment.

Contact

Deze node bevat informatie over de makelaar die bemiddeld in de verhuur/verkoop van het object. Deze informatie bestaat uit bedrijfsinformatie, informatie over het betrokken kantoor en de verantwoordelijke contactpersoon.

Counts

Deze node bevat enkele cijfermatige feiten over het object, zoals het aantal verdiepingen, het aantal aanwezige (slaap)kamers, garages en tuinen. Aantal kamers vind je terug onder de node CountOfRooms, aantal slaapkamers onder de node CountOfBedrooms, aantal badkamers onder de node CountOfBathrooms en het aantal toiletten onder de node CountOfToilettes.

Current

Deze node bevat informatie over de actuele (verhuur) status, verwachte huuropbrengst en de huidige bestemming. Of een object gedeeltelijk is verhuurd, is terug te vinden in de node IsPartiallyRented.

Descriptions

Deze node bevat de advertentietekst en omschrijvingen van de aanwezige verdiepingen. Een omschrijving kan in meerdere talen voorkomen. Daarnaast wordt in de node MultilanguageStringType/Encoding vermeld, wat de encoding van de tekst is (PLAINTEXT of HTML).

Elke omschrijving (Description) is mogelijk beschikbaar in één of meedere talen. Indien bij een omschrijving geen specifieke taal vermeld is, dan betreft het een omschrijving in de standaard taal. De standaard taal van een object kan worden opgezocht in de node LocalizationInfo/Language.

Dimensions

Deze node bevat informatie over de afmetingen van het object, zoals de inhoud en de perceeloppervlakte. Perceeloppervlakte kun je terugvinden in de node RealEstateProperty/Dimensions/Lot.

Evaluations

Deze node bevat informatie over beoordelingen van het object, waaronder wat de algemene status van het object is, of het object kindvriendelijk is en of het houden van huisdieren is toegestaan. Of het object beschermd is, vind je in de node IsProtected, of het een monument betreft in HasMonumentalProtection. De kwaliteit van de woning kun je terugvinden in de node ComfortQuality (LUXURY, NORMAL, SIMPLE). Daarnaast is er nog de algemene conditie van de woning in node BuildingCondition.

Of een object geschikt is voor gehandicapten en/of ouderen, is respectievelijk terug te vinden in de nodes ForSpecialTargetAudience en IsQualifiedForSeniors.

Zaken GIW certificaten, certificaat aangepaste woning, bouwkundige keuring, brandveiligheidscertificaat, huisgarantie en politiekeurmerk zijn terug te vinden onder de node Certifications.

Facilities

Deze node bevat informatie over de aanwezige faciliteiten in het object. Er wordt een zeer uitgebreide lijst van mogelijke faciliteiten ondersteund, waaronder:

Airco, Alarm, Attick, BackYard, Balcony, Bathroom, Bedroom, BuildingHasElevator, BuiltInLight, Cable_TV, etc.

Of er een garage aanwezig is, vind je bijvoorbeeld door te controleren op een node Garage. De subnode Garage/Available geeft vervolgens aan of een garage wel of niet beschikbaar is.

Over de keuken kun je informatie vinden onder de nodes Kitchen en KitchenType.

Of er een tuin aanwezig is vind je in de node Garden. Of er een balkon aanwezig is, vind je in de node Balcony. Opmerkingen over een aanwezig balkon zijn te vinden in de subnode Balcony/Comments. Indien schuur aanwezig, dan is er een node StorageRoom aanwezig. Voor opmerkingen over bijgebouwen kijk je naar StorageRoom/Comments.

Zo is er ook informatie te vinden over buitenzonwering (OutdoorAwnings), Fransbalkon (FrenchBalcony), rolluiken (RollerBlinds),  zwembad (SwimmingPool) en buitenkraan (WaterConnection).

Financials

Deze node bevat informatie over de prijscondities die gelden voor het object, zowel voor huur als koopobjecten.

Voor koopobjecten geldt, dat de verkoopprijs vermeldt wordt in de node PurchasePrice en de verkoopcondities (kosten koper, vrij op naam, etc.) in de node PurchaseCondition. In de node PriceCode vind je het onderscheid tussen ASKING_PRICE (vraagprijs) en FIXED_PRICE (vaste prijs).

Voor huurobjecten geldt, dat de huurprijs vermeldt wordt in de node RentPrice, waarbij uit de node RentPriceType kan worden afgeleid voor welke periode (maand, jaar, etc.) deze van toepassing is.

Of een woning (deels) gestofferd is, is terug te vinden in de node FurnitureType.

Garages

Deze node bevat informatie over de garages die bij het object horen. Details over de aanwezige parkeerplaats(en), waaronder de afmetingen, de parkeercapaciteit en het type (GARAGEBOX, CARPORT, PARKING_PLACE), zijn te vinden onder de subnodes van deze node.

Gardens

Deze node bevat informatie over de aanwezige tuin(en) bij het object, waaronder afmetingen, oriëntatie en of er een aparte ingang is.

LocalizationInfo

Deze node bevat locatie gebaseerde informatie over het object, zoals de basistaal (Language) en munteenheid (Currency) waarin prijzen zijn vermeld. Verder bevat LocalizationInfo informatie over de cultuur van de makelaar in de node Culture. Deze node bevat een culture in het formaat 'xx-YY', welke aangeeft hoe waardes in deze Xml geinterpreteerd dienen te worden.

Location

Deze node bevat informatie over de locatie van het object, waaronder het adres.  

Offer

Deze node bevat informatie over de acceptatievoorwaarden van het object, waaronder of het te koop is (IsForSale), te huur (IsForRent) of te pacht (IsForPacht). Verder is in deze node vermeld, hoe de acceptatie (Acceptance, AcceptanceDate, AcceptanceDescription) voor het object geregeld is. Informatie over de aanvaarding kun je terugvinden in de nodes Acceptance, AcceptanceDate en AcceptanceDescription. Openhuis is terug te vinden in de node OpenHouse. In de subnode(s) OpenHouse/OpenHouseEvent vind je de datum (Date) en een titel (Title) met eventuele vertalingen.

PropertyInfo

Deze node bevat informatie over de objectinformatie zelf en hoe deze te behandelen. Zo kan worden aangegeven dat het object vertrouwelijk is en dus niet op een publieke portal getoond mag worden (Confidential), wanneer de informatie voor het laatst is bewerkt (ModificationDate) en wat de huidige status is (Status). Indien de node Ignore de waarde 'True' heeft, moet dit object volledig genegeerd worden. Het is de bedoeling dit object niet in uw systeem op te nemen. Indien de node TemporaryHideProperty de waarde 'True' heeft, kunt u het object normaal verwerken. Het is echter de bedoeling, dat u dit object tijdelijk niet op een publieke portal vermeldt.

Surroundings

Deze node bevat informatie over de omgeving van het object, waaronder nabijgelegen snelwegen, scholen en andere publieke voorzieningen. Bijvoorbeeld “nabij stadscentrum” is het geval wanneer City/NearTo de waarde ‘True’ bevat. Hetzelfde is van toepassing op school (School), winkellocatie (ShopLocation) en openbaar vervoer (PublicTransport).

ThirdPartyMedias

Deze node bevat informatie over externe bijlagen bij het object, waaronder bijvoorbeeld video's gehost op YouTube.

Type 

Deze node bevat informatie over het type object, waaronder welke type object het betreft en of het permanent bewoonbaar is.