Gedaan met laden. U bevindt zich op: Gebouwenregister/Adressenregister Release 2023.04.05 (productie) Nieuwsberichten

Gebouwenregister/Adressenregister Release 2023.04.05 (productie)

Release-update
4 april 2023

Op 5 april 2023 wordt versie 2023.04.05 van het Gebouwen- en Adressenregister beschikbaar. Volgende zaken zijn toegevoegd, aangepast of geoptimaliseerd:

Belangrijke wijziging

Wij willen u graag op de hoogte stellen van een belangrijke update met betrekking tot onze adresmatch service. Vanaf 1 november 2023 zal adresmatch v1 niet meer up-to-date zijn als gevolg van de migratie van CRAB naar het Gebouwen- en Adressenregister. Om ervoor te zorgen dat u de meest recente adresgegevens blijft ontvangen, is het dus belangrijk om vóór deze datum over te stappen naar de nieuwe endpoints.

We begrijpen dat het migratieproces enige tijd kan vergen. Daarom hebben we besloten om adresmatch v1 tot 1 maart 2024 beschikbaar te houden, zodat u voldoende tijd heeft om over te stappen naar het nieuwe endpoint adresmatch v2.

Nieuwe functionaliteit: Adresmatch beschikbaar op v2 endpoint

Wat is hetzelfde gebleven tov adresmatch v1?

  • De logica achter de fuzzy matching.
  • De responses die als resultaat worden teruggestuurd.

Wat is er uit adresmatch v2 verwijderd dat in adresmatch v1 zat?

  • De query parameter ‘kadStraatcode’.
  • De query parameter ‘rrStraatcode’.
  • De query parameter ‘index’.
  • Het response veld ‘adresseerbareObjecten’. Er werd hiervoor een alternatief voorzien. Dit kan u vinden onder toevoegingen.

Wat is het verschil tussen adresmatch v2 en adresmatch v1?

  • Het content-type van v2 is ‘application/ld+json’. Van v1 was dit default ‘application+json’, maar ‘application/xml’ was ook mogelijk.
  • De geometrievelden 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.

Wat is er in adresmatch v2 toegevoegd dat niet in adresmatch v1 zit?

  • Het veld ‘links’. In dit veld zit een lijst van gerelateerde resources om te achterhalen wat de gelinkte objecten zijn aan het adres. Momenteel worden er 2 URL’s getoond.
    • URL 1: URL die alle gebouweenheden gaat tonen die gekoppeld zijn aan dit adres objectId.
    • URL 2: URL die alle percelen gaat tonen die gekoppeld zijn aan dit adres obejctId.
    • Op termijn zal er een nieuwe API zijn waarin de adreskoppelingen per adres zullen getoond worden.
  • Het veld @context. Dit veld bevat de linked-data context van het endpoint. Dit is een URI naar de JSON-LD file.
  • Het veld @type. Dit veld bevat het linked-data type van het endpoint.

Advies bij gebruik

De read endpoints zijn anoniem raadpleegbaar echter is er een beperking aanwezig op het aantal verzoeken dat u tegelijkertijd kan versturen naar deze endpoints. Wanneer u een API key meegeeft dan zal u meer requests kunnen versturen. Voor de feed endpoints is het verplicht om een API key mee te geven. Als u dit namelijk niet doet dan krijgt u een errormelding 401 als response terug. Om dus optimaal gebruik te maken van de endpoints vraagt u best een API key aan. Dit kan door uw gegevens in volgende link achter te laten: Vraag hier uw API key aan.(opent in nieuw venster)