Pagina-vergelijking

...

De locatie van een stooktoestel dient te worden bepaald aan de hand van de kleinst te bepalen functioneel zelfstandige eenheid van een gebouw (gebouweenheid) op een bestaand adresin een gebouw, of een gemeenschappelijk deel ervan.  Meestal verwijst een adres naar zo’n eenheid. Voor de toekenning hiervan, dient te worden gebruik gemaakt van de beschikbare basisregisters die Digitaal Vlaanderen ter beschikking stelt:

• Het Adressenregister voor de toekenning van de installatie aan het bestaand adres;

• Het Gebouwenregister voor de toekenning van het gebouw of de gebouweenheid.

Het Adressenregister voorziet de adresseerbare objecten in het Gebouwenregister gebouweenheden van adressen. De bevoegdheid voor adrestoekenningen ligt bij de 300 Vlaamse gemeenten (bij CRAB-decreet). Het Adressenregister zal volgde eind 2023 het CRAB als authentieke bron op voor adressen vervangen en kan vandaag reeds beschouwd worden als en is het referentieregister voor adressen in het Vlaamse Gewest.

...

Elke Gebouweenheid beschikt over een gebouweenheidStatus en een geometrie ‘punt’ dat gelijk kan zijn aan het Adrespunt of de centroïde van een Gebouw. De puntgeometrie van de Gebouweenheid ligt altijd binnen polygoongeometrie van het Gebouw.

Een gebouweenheid heeft ook een functie. Vandaag is deze enkel gekend voor het gemeenschappelijk deel in een gebouw.  In de toekomst zullen ook functies als "wonen", "handel", … ingevuld worden voor elke gebouweenheid.

In vele gevallen is de nauwkeurigheid van de locatie van een stooktoestel tot op het niveau van de gebouweenheid te bepalen.  Indien de GebouweenheidsID niet aanwezig is in het Gebouwenregister, dan neemt VEKA genoegen met de nauwkeurigheid van een lager niveau: het GebouwID.  Sowieso is de toekenning van een AdresID uit het Adressenregister een absolute, minimale vereiste.

...

Voor de toekenning van het Adres, Gebouw en Gebouweenheid kan gebruik gemaakt worden van Basisregisters Vlaanderen API, waarvan de huidige meest recente versie dateert van 7 maart 2023. .  Deze API is gedocumenteerd en : https://docs.basisregisters.vlaanderen.be/docs/api-documentation.html

De API van Basisregisters Vlaanderen is anoniem raadpleegbaar: https://api.basisregisters.vlaanderen.be.

...

...

De read endpoints zijn in 2 versies raadpleegbaar: v1 en v2. Het verschil tussen beiden en hoe ze getoond kunnen worden in de browser wordt uitgelegd in de API documentatie.

WMS en WFS webdiensten

WebMapServices (WMS) en WebFeatureServices (WFS) zijn interfaces voor de aanlevering van geografische data over het internet.  Dit kunnen zowel vectoriële data zijn (WFS) als rasterdata (WMS).

Digitaal Vlaanderen stelt deze WMS- en WFS webdiensten op basis van het Adressen-en Gebouwenregister beschikbaar . Deze zijn en raadpleegbaar via https://www.vlaanderen.be/digitaal-vlaanderen/onze-oplossingen/gebouwen-en-adressenregister/gebruik-en-achtergrondinformatie . De beschikbare WMS- en WFS webdiensten zijn raadpleegbaar via https://www . vlaanderen.be/digitaal-vlaanderen/onze-oplossingen/gebouwen-en-adressenregister/gebruik-en-achtergrondinformatie

Op https://www.vlaanderen.be/digitaal-vlaanderen/onze-oplossingen/gebouwen-en-adressenregister/release-notes kunt u een overzicht terugvinden van de releases.

Uitgeschreven Use Case

Veel voorkomende vragen - Digitaal Vlaanderen

Veel voorkomende vragen over het Adressen- en Gebouwenregister kunt u terugvinden via https://overheidbasisregisters.vlaanderen.be/overheid.vlaanderen.be/gebouwenregister-faqveelgestelde-vragen.

Hierin kunt u onder meer terugvinden:

• Hoe u Gebouwen en Gebouweenheden op een kaart kan visualiseren aan de hand van de WMS

• Hoe u de REST API van Digitaal Vlaanderen kan uitproberen

• Hoe u het testbestand kan gebruiken

• Hoe u gebouwen kunt terugvinden aan de hand van hun adres

• Hoe u een adres van een andere bron in verband kan brengen met een authentiek adres in het Adressenregister

• Hoe u een adressuggestie in uw toepassing kunt implementeren

• Hoe u keuzelijsten voor adresformulieren kan creëren

• De betekenis en het belang van de ‘homoniemtoevoeging’

Veel voorkomende vragen - Use Case VEKA

Wat is het verschil tussen WMS en WFS en waar gebruik je ze best voor?

WMS (Web Map Service) en WFS (Web Feature Service) zijn REST interfaces (OGC standaarden) om geografische data op te vragen en om op een kaart te kunnen visualiseren en bevragen:

• De WMS van het Adressen- en Gebouwenregister laat toe gebouwen en gebouweenheden (per status) op kaart te visualiseren en objecten aan te klikken op pixelniveau voor meer informatie. Hiermee vraag je als het ware kaartmateriaal op als een afbeelding (tiff/png/jpg).  Een WMS is interessant om als achtergrond informatie te gebruiken.

• De WFS laat toe de objecten in het Adressenregister geometrisch te bevragen. Op deze data is het mogelijk om queries en selecties uit te voeren. Het gebruik van een WFS is dus interactiever en noodzakelijk voor gebruikersinteracties zoals selecties. Deze WFS is een service die zowel vectoriële informatie (die gevisualiseerd kan worden op de kaart) als attribuutgegevens (zoals bv adresgegevens) via XML teruggeeft als antwoord op een call.

• Voor de meest complete informatie hoe deze REST services te gebruiken wordt verwezen naar de OGC website of de documentatie van GeoServer:

  • https://www.ogc.org/standard/wms/

  • https://www.ogc.org/standard/wfs/

  • https://docs.geoserver.org/latest/en/user/services/wms/reference.html#getmap

  • https://docs.geoserver.org/latest/en/user/services/wfs/reference.html#getfeature

Hoe kan je deze data inladen in een webapplicatie? 

Deze data kan ingeladen worden in tal van GIS-software.

In het geval er een webapplicatie gebruikt wordt om de beschreven use case uit te werken, is bijvoorbeeld het gebruik van de gratis open source JavaScript bibliotheken OpenLayers of Leaflet mogelijk. Als er gewerkt wordt met een desktop applicatie kan bijvoorbeeld de open source Java bibliotheek GeoTools gebruikt worden.

Hiermee kan je embedded, interactieve kaarten opmaken en tonen via je web- of desktopapplicatie.  Standaard zorgen deze libraries voor de eindgebruiker de mogelijkheid om te navigeren in de kaart, kaartvoorstellingen aan te passen, gebruik te maken van verschillende kaartlagen, vectoriële data te kunnen selecteren of attribuutgegevens op te vragen van een geselecteerde vector.  Op welke manier deze bibliotheken deze functionaliteiten aanbieden is terug te vinden in hun specifieke documentatie, handige quickstarts, tutorials API documentatie met een aantal voorbeelden om zelf interactieve kaarten op te stellen.

Meer informatie, zoals developer guides, kan gevonden worden op onderstaande links:

• JS libs:

  •    https://openlayers.org/

  •   https://leafletjs.com/

• Java lib: 

  •   https://www.geotools.org/

Waar vind ik de catalogi die leiden tot deze WMS- en WFS data van het Gebouwen- en Adressenregister?

De catalogus die leiden tot deze WMS- en WFS data kan je hier vinden:

• https://www.vlaanderen.be/datavindplaats/catalogus/wms-adressenregister

• https://www.vlaanderen.be/datavindplaats/catalogus/wms-gebouwenregister

• https://www.vlaanderen.be/datavindplaats/catalogus/wfs-adressenregister

• https://www.vlaanderen.be/datavindplaats/catalogus/wfs-gebouwenregister 

Om de gebouwen op te roepen op een kaart én deze interactief te maken, wordt gebruik gemaakt van de WFS endpoint:

• https://geo.api.vlaanderen.be/Gebouwenregister/wfs

Met behulp van de GetCapabilities operator kan een gebruiker deze service ontdekken. Zo krijgt deze toegang tot de metadata, de beschikbare WFS operaties en parameters:

• https://geo.api.vlaanderen.be/Gebouwenregister/wfs?request=GetCapabilities

Met de GetFeature operator kan je een selectie aan vectorobjecten ophalen van de databron. Hier zullen nog enkele parameters moeten ingevuld worden zoals:

• version

  • Voor WFS volstaat versie 2.0.0

  • &version=2.0.0

• typename

  • Dit is de laagnaam. Voor de gebouwen binnen het gebouwenregister is dit Gebouwenregister:Gebouwen

  • &typename=Gebouwenregister:Gebouw

• srsname

  • Dit is het ruimtelijk referentiesysteem. In België is dit Lambert72 of EPSG:31370.

  • &srsname=EPSG:31370

• outputFormat

  • Hier wil je een json output

o   &outputFormat=application/json

• bbox

  • Deze is afhankelijk van de schaal van je interactieve kaart. Deze kan in het formaat zijn xmin,ymin,xmax,ymax maar best wordt deze variabel gemaakt in de code door te werken met een extent.

Dit zou ongeveer tot volgende request moeten leiden:

• ‘https://geo.api.vlaanderen.be/Gebouwenregister/wfs?service=wfs&version=2.0.0&request=GetFeature&typename=Gebouwenregister:Gebouw&srsname=EPSG:31370&outputFormat=application/json&bbox=' + extent.join(',') + ',EPSG: 31370’

Presentatie door Digitaal Vlaanderen op 24 april 2024

Alle (technische) informatie beschikbaar op https://basisregisters.vlaanderen.be

Inschrijven nieuwsbrief/release notes Gebouwen- en Adressenregister: https://analytics-eu.clickdimensions.com/cn/aqwrf/InReleaseGRAR

Digitaal Vlaanderen nieuwsbrief: https://www.vlaanderen.be/digitaalvlaanderen/nieuwsbrief-digitaal-vlaanderen

Partnerdagen 2024 meer informatie: https://www.vlaanderen.be/digitaalvlaanderen/partnerdagen-digitaal-vlaanderen

Diensten Digitaal Vlaanderen

De status van de diensten en producten van Digitaal Vlaanderen kunnen geraadpleegd worden op https://www.vlaanderen.be/digitaal-vlaanderen/status/. Hier kan je een actueel overzicht vinden die 24/7 wordt bijgewerkt.

U kan op de hoogte blijven van zowel de incidenten als gepland werk door u te abonneren op de diensten en producten die u bij Digitaal Vlaanderen afneemt via https://www.vlaanderen.be/digitaal-vlaanderen/status/abonneer-op-updates. Geplande werkzaamheden worden zoveel mogelijk buiten kantooruren (09:00-17:00) ingepland. 

Indien u een incident opmerkt die nog niet geregistreerd of gemeld staat, kan u Digitaal Vlaanderen hiervan op de hoogte brengen via de link Rapporteer een incident of een mail te sturen naar digitaal.vlaanderen@vlaanderen.be.

Voorbeeld in pseudocode

Hieronder wordt een voorbeeld gegeven hoe je met enkele endpoints een kaart kan maken in een webtoepassing. Onderstaande code is gebaseerd op JavaScript, maar blijft pseudocode. Het ophalen van een WFS-object geeft slechts een geometrie weer. Dit object kan ook gestijld worden. Onder onderstaande VectorSource kan er een stijl toegevoegd worden.

Naast deze vector zou een achtergrondkaart handig zijn, zodat een gebruiker zich kan situeren. We voegen de WMTS toe van de orthofotomozaïek van Vlaanderen (i.e. satellietfoto’s van Vlaanderen). Deze heeft als endpoint:

• https://geo.api.vlaanderen.be/OGW/wmts

 Ook hier kan met behulp van de GetCapabilities de metadata ontdekt worden om de nodige parameters af te leiden.

Om deze twee kaarten te combineren kan er een nieuwe kaartconstante gecreëerd worden. Hier kunnen ook de zoomschalen en het centercoördinaat gedefiniëerd worden. Het is dan de bedoeling om als startcoördinaat het coördinaat gevonden uit het adresID mee te geven.

Laten we als voorbeeld het adres nemen van OVAM:

• https://api.basisregisters.vlaanderen.be/v2/adressen/2447812

Hier zie je in de json dat deze als coördinaat 158255.51, 190049.18 heeft in Lambert72.

Zo is het ook mogelijk om filters toe te voegen op de WFS queries om bijvoorbeeld enkel de gerealiseerde, geplande, of gebouwen in aanbouw op te halen.

Meer informatie en voorbeelden in lijn van bovenstaand voorbeeld kan hieronder gevonden worden:

• https://openlayers.org/en/latest/examples/

• https://openlayers.org/en/latest/examples/vector-wfs.html

• https://openlayers.org/en/latest/examples/vector-wfs-getfeature.html

• https://openlayers.org/en/latest/examples/wmts.html