• Adresmatch v2 is vanaf nu beschikbaar in productie. Deze adresmatch v2 is een vernieuwde versie van de adresmatch v1 en voldoet aan het OSLO-model.
• URL adresmatch v2: https://api.basisregisters.vlaanderen.be/v2/adresmatch(opent in nieuw venster).
• 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: https://www.vlaanderen.be/digitaal-vlaanderen/onze-oplossingen/oslo.
• Documentatiepagina adresmatch v2 https://docs.basisregisters.vlaanderen.be/docs/api-documentation.html#operation/AddressMatchV2(opent in nieuw venster).
• Deze adresmatch v2 heeft een aantal functionele verschillen tegenover adresmatch v1. Wat er juist hetzelfde, veranderd of toegevoegd is, wordt hieronder beschreven.

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.

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)

Bekijk de code aanpassingen voor elk onderdeel(opent in nieuw venster).