Op 24 januari 2022 werd versie 2022.01.24 van het Gebouwen- en Adressenregister beschikbaar. Volgende zaken zijn toegevoegd, aangepast of geoptimaliseerd:

Nieuwe functionaliteit: v2 read endpoints

• De v2 read endpoints zijn in productie. Deze read endpoints zijn een vernieuwde versie van de v1 read endpoints en zijn conform aan het OSLO-model. Hieronder kan u de verschillende v2 read endpoints vinden:
  • Vraag een gemeente op (v2): https://api.basisregisters.vlaanderen.be/v2/gemeenten/{objectid}
  • Vraag een lijst met gemeenten op (v2): https://api.basisregisters.vlaanderen.be/v2/gemeenten
  • Vraag postinfo voor een postcode op (v2): https://api.basisregisters.vlaanderen.be/v2/postinfo/{objectid}
  • Vraag een lijst met postinfo over postcodes op (v2): https://api.basisregisters.vlaanderen.be/v2/postinfo
  • Vraag een straatnaam op (v2): https://api.basisregisters.vlaanderen.be/v2/straatnamen/{objectid}
  • Vraag een lijst met straatnamen op (v2): https://api.basisregisters.vlaanderen.be/v2/straatnamen
  • Vraag een adres op (v2): https://api.basisregisters.vlaanderen.be/v2/adressen/{objectid}
  • Vraag een lijst met adressen op (v2): https://api.basisregisters.vlaanderen.be/v2/adressen
  • Vraag een gebouw op (v2): https://api.basisregisters.vlaanderen.be/v2/gebouwen/{objectid}
  • Vraag een lijst met gebouwen op (v2): https://api.basisregisters.vlaanderen.be/v2/gebouwen
  • Vraag een gebouweenheid op (v2): https://api.basisregisters.vlaanderen.be/v2/gebouweenheden/{objectid}
  • Vraag een lijst met gebouweenheden op (v2): https://api.basisregisters.vlaanderen.be/v2/gebouweenheden
  • Vraag een perceel op (v2): https://api.basisregisters.vlaanderen.be/v2/percelen/{objectid}
  • Vraag een lijst met percelen op (v2): https://api.basisregisters.vlaanderen.be/v2/percelen
• Wat wilt conform aan het OSLO-model zeggen?
  • Door informatie conform aan het OSLO-model te ontsluiten, kan deze vlot gecombineerd worden met datasets op het wereldwijde web. Contextuele informatie wordt aan de response van de endpoints gekoppeld waardoor ze geschikt zijn om te gebruiken in Linked Data toepassingen.
  • Meer informatie over OSLO kan u hier vinden.
• Wat is het verschil tussen de v1 en de v2 endpoints?
  • Het content-type van v2 is ‘application/ld+json’. Van v1 was dit default ‘application+json’, maar ‘application/xml’ was ook mogelijk.
  • Er zijn 2 velden bijgekomen, namelijk @context en @type.
    • Het @context veld bevat de linked-data context van het endpoint. Dit is een URI naar de JSON-LD file.
    • Het @type veld bevat het linked-data type van het endpoint.
  • De geometrievelden bij ‘Vraag een adres op (v2)’, ‘Vraag een gebouw op (v2)’ en ‘Vraag een gebouweenheid op (v2)’ zijn gewijzigd. De coördinaten van het object staan vanaf nu in het gml-formaat en alle velden die met geometrie te maken hebben zijn samengevoegd onder 1 veld.
• Op de documentatiepagina(opent in nieuw venster) kan u de uitleg van deze nieuwe endpoints samen met de bestaande endpoints terugvinden. Om duidelijk aan te geven of het een v1 of een v2 endpoint is, hebben we achteraan de titels gewerkt met (v1) voor versie 1 en (v2) voor versie 2.
• Op termijn gaan de v1 endpoints uitgefaseerd worden en is het de bedoeling dat u de v2 endpoints aanroept. Gebruikt u vandaag de dag (nog geen) v1 endpoints en wilt u overschakelen naar onze gebouwen- en adressenregister endpoints? Gelieve ons te contacteren voor advies op het volgende e-mailadres: digitaal.vlaanderen@vlaanderen.be

Advies bij gebruik

• Anonieme service requests zullen in de toekomst (in aantal) beperkt worden. Vraag dus een ‘API key’ aan(opent in nieuw venster) om ook in de toekomst optimaal gebruik te kunnen maken van onze API’s. Er zal wel tijdig gecommuniceerd worden wanneer anonieme requests ingeperkt worden; dat is vandaag nl. nog niet het geval.

Technische componenten

Klik op het versienummer om de code aanpassingen te zien voor elk onderdeel.

Wenst u niet langer deze releasecommunicatie te ontvangen? Schrijf u dan hier uit(opent in nieuw venster). U kan er ook voor kiezen enkel de algemene communicatie van het gebouwen- en adressenregister te ontvangen. Als u dit wilt, schrijf u dan hier in(opent in nieuw venster).