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
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 |
|---|---|---|
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.
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.
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!