Overzicht
Services voor het opzoeken van Belgische adressen, straten en gemeenten, gebaseerd op de drie regionale authentieke bronnen van Brussel, Vlaanderen en Wallonië.
Kerndiensten van de instellingen
SubdomeinReferentiesysteem en terminologie
TypologieService & API
Service ownerBOSA
2023
Waarvoor dient het?
De BeSt Address-services van FOD BOSA bieden je adres-services op federaal niveau aan die adresinformatie afkomstig uit de 3 regionale authentieke bronnen bundelen. Ieder gewest (het Vlaamse Gewest, het Brusselse Hoofdstedelijk Gewest en het Waalse Gewest) beschikt immers over een eigen authentieke bron van adresgegevens voor zijn grondgebied, met daarin de nodige gegevens voor het eenduidig lokaliseren van percelen en de daarop aanwezige constructies zoals huizen of industriële gebouwen.
Functionele beschrijving
De BeSt Address-services exploiteren de BeSt Address-gegevens (codificatie van geogerefereerde straat- en adresgegevens in België) en omvatten file transfer services (File services), REST-webservices en een Docker image.
Ze bieden volgende functionaliteiten:
File services
- Full Download, voor het Belgisch grondgebied, van volgende bestanden:
- Adressen (Addresses)
- Straatnamen (streetNames)
- Gemeenten (Municipalities)
- Deelgemeenten (partOfMunicipalities)
- Postcode-informatie (postalInfo)
- Downloaden van Mutatiebestanden
(Gepland in de loop van 2026 voor Vlaanderen; in test voor Wallonië en Brussel)
REST-service BeSt Address
- Resources
- Address: opzoeken van adresinformatie op basis van 1 of meerdere parameters (ID, postal code, REFNIS code, municipality name, postID, municipalityID, streetID, street name, GPS-coördinaten of Lambert binnen een bepaalde straal, status)
- Streets: opzoeken van straatinformatie op basis van 1 of meerdere parameters (ID, name, postal code, REFNIS code, postID, municipalityID, status)
- Municipalities: opzoeken van gemeente-informatie op basis van 1 of meerdere parameters (ID, name, postal code, REFNIS code, postID)
- Postalinfos: opzoeken van postcode-informatie op basis van 1 of meerdere parameters (ID, name, postal code)
Docker image
- BeSt-in-a-box: creëren van een Docker container gehost op een eigen platform, bevattende:
- De databank met BeSt-address (‘Belgian Streets and Addresses’) adresgegevens
- De REST-service BeSt Address
Opmerkingen:
Elk adresobject dat door een BeSt-service wordt geleverd, bevat een unieke sleutel die uit 3 delen bestaat: Namespace, Object-ID en Version-ID. De Namespace is een constante en bevat een verwijzing naar de regio en het type object (bijv. adres, straatnaam, gemeente...): voorbeeld.
Om te verwijzen naar een adres in een database, bijvoorbeeld een adres in iemands pensioendossier, moet je de volledige BeSt ID gebruiken (Namespace + Object-ID + Version-ID).
BeSt ID's kunnen veranderen, bijvoorbeeld bij een administratieve adreswijziging, zoals een verandering van straatnaam of hernummering van een straat. In dat geval blijft voor Brussel en Wallonië het Object-ID van de straat of het adres constant maar neemt de versie toe, waardoor wel het BeSt ID in zijn geheel (Namespace + Object-ID + Version-ID) verandert omdat de versie verandert. Voor Vlaanderen wordt in zo'n geval een nieuw Object-ID toegekend.
Voor Vlaanderen is geen partOfMunicipality-informatie beschikbaar omdat Vlaanderen niet meer met deelgemeenten werkt; deze zijn geaggregeerd in postalInfoName.
Enkel voor Vlaanderen is postalInfoName ingevuld.
Elk individueel appartement heeft zijn eigen BeSt ID.
Technische beschrijving
File services zijn beschikbaar via
- een afgeschermde SFTP-server (momenteel enkel Full Download in XML-formaat)
- de website BOSA Open data (momenteel enkel Full Download in XML- en CSV-formaat)
Alle webservices zijn van het REST-type (JSON-formaat).
Doelpubliek
Doelgroepen zijn zowel overheden (federale, gewestelijke…) als bedrijven die Belgische adressen, straten en gemeenten nodig hebben voor het goed functioneren van hun business.
We onderscheiden twee types gebruikers:
- Organisaties die hun eigen on-premise adresdatabank raadplegen, bouwen die op door gebruik te maken van
- de Full Downloadbestanden voor de initialisatie van de databank
- de dagelijkse Mutatiebestanden om die databank up-to-date te houden
- Organisaties die adresgegevens raadplegen in de geconsolideerde BOSA-adresdatabank, maken gebruik van de REST-service BeSt Address
Integratievoorwaarden
De Files services en Best-in-a-box zijn voor iedereen toegankelijk via de Open data-website van BOSA.
De REST-API BeSt Address is toegankelijk
- ofwel een 'open' toegang aan bedrijven (zonder inloggegevens)
- ofwel via de BOSA service-integrator voor openbare administraties (met inloggegevens).
Documentatie
-
Gebruikersdocumentatie en procedure voor toegang tot BeSt-services
De gebruikersgidsen kan je terug vinden onder de tab 'Technische Info'.
- SocSec API Gateway used for BOSA services
Andere interessante componenten
Contact
Contact: ReuseOperational@smals.be
