Technische informatie BeStAdd


DIGITAAL VLAANDEREN

Technische informatie BeStAdd

BeStAdd

In het BeStAdd register zijn bij de adresgegevens identificatoren opgeslagen op verschillende niveau’s, waaronder:

  • Gemeente

  • Straat

  • Adres

Daar de authentieke bronnen van de Belgische adressen, de gewesten zijn, zijn de numerieke identificatoren uniek binnen deze gewesten. Om de identificatoren op te splitsen per gewest is een namespace toegevoegd. Dit is vertaald naar “Naamruimte” in de MAGDA XSD en heeft de vorm van een uri. Zo zal er een uri zijn voor Vlaanderen, Wallonië en Brussel. Op het einde van deze uri zal het type object geïdentificeerd zijn.

Gegevens van adres-locaties kunnen over de tijd veranderen. Zo kan een straat van naam veranderen omwille van een fusie van gemeenten of kunnen in een straat de huisnummers aangepast worden. Daardoor kunnen de gegevens van een adres veranderen, maar wijst het adres nog steeds naar dezelfde locatie. Om dit te kunnen doen is een versie toegevoegd aan de verschillende objecten.

Het volledige object bevat dus volgende eigenschappen

  • Identificator

  • Namespace

  • Versie

In de MAGDA XSDs wordt een BeStAdd adres-identificator gespecificeerd door volgende structuur

image-20240313-163046.png

BeStAdd is geïntroduceerd met focus op machine-tot-machine communicatie. Dit wil zeggen dat enkel ids (identificatoren) kunnen gebruikt worden en geen directe verwijzingen naar adressen op zich.

Voorbeeld

Vlaams AdressenRegister formaat

Bron : https://api.basisregisters.vlaanderen.be/v2/adressen/326762

"identificator": { "id": "https://data.vlaanderen.be/id/adres/326762", "naamruimte": "https://data.vlaanderen.be/id/adres", "objectId": "326762", "versieId": "2023-11-01T12:59:11+01:00" },

MAGDA GeefPersoon formaat

<VerwijstNaar> <LokaleIdentificator>326762</LokaleIdentificator> <Naamruimte>https://data.vlaanderen.be/id/adres</Naamruimter> <VersieIdentificator>2023-11-01T12:59:11+01:00</VersieIdentificator> </VerwijstNaar>

Belgische adressen

OSLO adres

OSLO definieert het schema waarop een adres kan gedefinieerd worden, niet de data!

In de persoondiensten wordt voor de adressen die een Belgisch adres kunnen bevatten een OSLO schema gebruikt. Dit zijn

Straatnaam en gemeentenaam kunnen in deze adresstructuur voorkomen in twee verschillende plaatsen.

Plaats

Gestandaardiseerd

Niet gestandaardiseerd

Plaats

Gestandaardiseerd

Niet gestandaardiseerd

Benaming gemeente

Gemeentenaam

NietGestandaardiseerdeGemeentenaam

Benaming straat

Straatnaam

NietGestandaardiseerdeStraatnaam

Wanneer toepassen?

Mogen alleen ingevuld zijn indien de gemeentenaam en de straatnaam van een officieel erkende bron komen. Dit kan je zien doordat VerwijstNaar dan is ingevuld.

Indien er geen zekerheid is dat de gemeente- of straatnaam van een officieel erkende bron komen. In dit scenario zal VerwijstNaar dan ook niet ingevuld zijn.

De vlag om aan te tonen dat adresgegevens van een officieel erkende bron komen wordt aangetoond met de aanwezigheid van het BeStAdd adresId. Dit zit in het MAGDA schema in het VerwijstNaar element.

image-20240314-085337.png
BeStAdd adresID

Indien het element “VerwijstNaar” is ingevuld zijn we zeker dat de adresgegevens officieel zijn en de gemeente- en straatnaam de juiste spelling hebben voor de opgegeven taal. De “niet gestandaardiseerde” gemeente- en straatnaam zullen dan niet ingevuld zijn.

Daar de gemeentenaam en straatnaam ook taal-afhankelijk zijn hebben ze ook een taal attribuut.

image-20240314-084305.png
Het element met de officiële straatnaam

 

Zie ook de OSLO adressenstructuur onderaan https://vlaamseoverheid.atlassian.net/wiki/spaces/MG/pages/1118175668/Verschillen+met+vorige+versie#OSLO-adressenstructuur

Afhankelijk van de planning bij RR en KSZ (zie timing op https://vlaamseoverheid.atlassian.net/wiki/spaces/MG/pages/6654067105 ) zullen BeStAdd identificatoren worden doorgestuurd vanuit de bron. Indien MAGDA een BeStAddID ontvangt zullen bij de Belgische adressen de gemeente- en straatnaam niet in de NietGestandaardiseerdeGemeentenaam en NietGestandaardiseerdeStraatnaam elementen ingevuld zijn maar wel in de Gemeentenaam/String en Straatnaam/String elementen.

PAS, INDIEN NODIG, UW MAPPING AAN OM HIER REKENING MEE TE HOUDEN!


Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid

uitgegeven door Digitaal Vlaanderen