05. Het datamodel

De Connector levert op dit moment Real Estate Properties (panden) en Relations (relaties).

Algemeen

De panden uit de Connector komen van verschillende Content Providers. Dit zijn niet alleen leveranciers van Nederlandstalige software pakketten maar ook Content Providers die software leveren aan makelaars uit Oostenrijk, Italië en Kroatië.

Om de gegevens van de verschillende leveranciers te kunnen ontvangen en zonder verlies aan Media Partners aan te kunnen leveren is de Connector meertalig opgezet en wordt de land en cultuur specifieke informatie van het makelaarskantoor van het pand meegeleverd.

Locatie specifieke gegevens

Bij een pand wordt de cultuur (Culture), de geldeenheid (Currency) en de taal (Language) van het makelaarskantoor meegeleverd.

Aan de hand van de cultuur bepaalt de Media Partner hoe de gegevens geïnterpreteerd moeten worden. Geldt in een bepaalde cultuur bijvoorbeeld dat de breedte van een kamer niet de afstand tussen de muren is maar gemeten vanaf het hart van de muren dan is de opgegeven breedte van een kamer dus volgens deze standaard.

De valuta geeft aan welke valuta er gehanteerd moet worden voor de interpretatie van de prijzen. Prijzen bij een pand zijn dus altijd in één valuta. Indien er op een Portal prijzen van panden in meerdere valuta's weergegeven moeten worden dan is de Media Partner dus zelf verantwoordelijk voor de correcte omrekening.

Tot slot bepaalt de taal de standaard taal van de makelaar. Teksten, zoals de advertentietekst, kunnen in meerdere talen aangeleverd worden. Per 'vertaling' wordt de taal van de betreffende vertaling weergegeven. Is er echter geen taal gespecificeerd dan is dit (volgens de makelaar) de standaard tekst, en deze tekst is dus in de standaard taal van het betreffende makelaarskantoor.

Vertalingen

Zoals hierboven staat beschreven kunnen teksten in meerdere talen worden aangeleverd. Welke dat zijn hangt af van

ID's

Elk pand, elke relatie en elk makelaarskantoor heeft zijn eigen unieke ID. In de Connector worden hier integers voor gebruikt. Er worden nooit ID's hergebruikt.

Bij een pand, een relatie en een makelaarskantoor kunnen "foreign ID's" worden meegegeven. Dit zijn de ID's waaronder het betreffende pand, relatie of makelaarskantoor bij de betreffende Content Provider. De Connector doet niets met deze "foreign ID's", behalve ontvangen van de Content Provider en doorsturen naar de Media Partner. De "foreign ID's" kunnen gebruikt worden bij het debuggen; de Media Partner en de Content Partner kunnen dan onderling contact hebben over een bepaald pand, een relatie en/of een makelaarskantoor en daarbij naar hetzelfde pand, relatie of kantoor verwijzen door gebruik te maken van deze "foreign ID's". De 'Origin' geeft aan wie de Content Provider is geweest; en 'VM' staat hier voor Kolibri (voorheen Venum).

Bij communicatie met de Connector gebruikt de Media Partner dus nooit foreign ID's.

Datums

Datums en tijden die door de Connector worden aangeleverd zijn altijd in UTC. Dit geldt dus ook voor datums. Een 'einddatum voorbehoud' is op een bepaald moment in tijd. Dit is één moment, waar je ook maar in de wereld bent. Vandaar dat bij een datum ook de tijd geleverd wordt.

Het datamodel van een Real Estate Property

De gegevens van een Real Estate Property zijn gegroepeerd in 24 verschillende blokken. Afhankelijk van de rechten van een Media Partner wordt een blok wel of niet aangeleverd, of worden enkele nodes wel of niet aangeleverd. Hieronder een schematisch overzicht van een Real Estate Property met daaronder per blok een korte toelichting.

AreaTotals 

Deze node bevat oppervlakte informatie over de verschillende delen van het object, waaronder van kelderruimte, woonkamer en opslagruimten. De 'gebruiksoppervlakte Wonen' ("Wat is de bewoonbare oppervlakte achter de voordeur van de woning") is terug te vinden onder de node RealEstateProperty/AreaTotals/EffectiveArea. De 'woonoppervlakte' is te vinden onder de node RealEstateProperty/AreaTotals/LivingArea.

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

Cadastre

De kadastrale gegevens worden beschreven in de node 'Cadastre'. Deze node wordt meestal niet aangeleverd aan een Media Partner. Informatie over eigen grond erfpacht en recht van opstal is terug te vinden onder CadastrallInformations/CadastralInformation/Ownership/Type.

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 cv-ketel aanwezig is, is te vinden in de node Heating (HeatingAllocation is type CENTRAL). De leeftijd van de cv-ketel is te vinden in de node Heating/YearOfManufacture, het type cv-ketel in de node Heating/TypeOfBoiler. Of het elektrisch, gas of anderszins gestookte cv betreft, 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 meerdere talen. Indien bij een omschrijving geen specifieke taal vermeld is, dan betreft het een omschrijving in de standaard taal. De standaard taal van een pand kan worden opgezocht in de node LocalizationInfo/Language.

Dimensions

Deze node bevat informatie over de afmetingen van het object, zoals de inhoud (RealEstateProperty/Dimensions/Content) en de perceeloppervlakte (RealEstateProperty/Dimensions/Land/Area).

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) gestoffeerd is, is terug te vinden in de node FurnitureType.

Floors

Deze node bevat gedetailleerde informatie over de inrichting van het pand over de verschillende verdiepingen. Per verdieping worden de verschillende ruimtes gespecificeerd en per ruimte de verschillende voorzieningen. Deze uiterst gedetailleerde informatie wordt lang niet door alle makelaars ingevoerd en is voor de meeste Media Partners te gedetailleerd en dus overbodig.

Een zolder is ook een verdieping. In de subnode Floor/AtticFixStair wordt gespecificeerd of er een vaste trap is en hoeveel kamers er zijn. Informatie over aanwezige keukens zijn te vinden onder de subnode Floor/Rooms/Room/KitchenTypes.

Of in de badkamer een toilet aanwezig is, kan afgeleid worden uit Floor/Rooms/Room/BathroomFacilities, indien de verdiepingsinformatie beschikbaar is.

Dakterras is een type kamer. Deze kan worden teruggevonden in Floor/Rooms/Room/Type met de waarde ROOF_TERRACE. Afmetingen worden aangegeven in Floor/Rooms/Room/Dimensions.

Balkon is een type kamer. Deze kan worden teruggevonden in Floor/Rooms/Room/Type met de waarde BALCONY. Oriëntatie wordt aangegeven in Floor/Rooms/Room/Orientation.

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 geïnterpreteerd 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. 

De node MandateDate geeft de (UTC) datum waarop het pand in opdracht is gekomen.

Surroundings

Deze node bevat informatie over de omgeving van het pand, waaronder nabijgelegen snelwegen, scholen en andere publieke voorzieningen.

ThirdPartyMedias

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

Transaction

De node 'Transaction' bevat gegevens over de verkoop of verhuur van het pand. Wanneer is het pand verkocht/verhuurd (Date), wat is de transport datum (ContractDate) en wat is de einddatum van een eventueel voorbehoud (WaivingOfTerminationTo). De eventueel gerealiseerde verkoopprijs kun je terugvinden in de node RealisedPrice.

Type

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

In Nederland / Kolibri kennen we hoofd- en subtypes, soorten en kenmerken om nog beter te specificeren wat er nu precies aangeboden wordt. Deze onderverdeling is land/cultuur/branche organisatie afhankelijk. De Connector verwerkt aanbod voor verschillende software leveranciers met klanten uit verschillende landen en verschillende culturen. Het vastleggen/bepalen van de hiërarchie/onderverdeling van types, soorten, etc. is niet aan de Connector. Om geen enkel detail verloren te laten gaan verwerkt de Connector de pandtypes 'platgeslagen', dus zonder hiërarchie. De node 'RealEstateProperty/Type/PropertyTypes' kan dus meerdere types bevatten.

Een woonhuis van het soort villa, type vrijstaand en kenmerk semi bungalow zal dus de typen 'HOUSE', 'VILLA' en 'DETACHED_HOUSE' en 'SEMI_BUNGALOW'.

Is er niets meer bekend dan dat de woning enkel een woonhuis is, dan is 'HOUSE' het enige type wat aangeleverd zal worden. De Connector kan geen garanties geven over de aanwezigheid van de verschillende types; die verantwoordelijkheid ligt bij de software leverancier.