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 diensten aan op federaal niveau die adres informatie, 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)
- en postcode-informatie (postalInfo)
- Downloaden van Mutatiebestanden
(Gepland Q1 2026 voor Vlaanderen; in test voor Wallonië en Brussel)
REST-services
- BeSt Address
- Address: opzoeken van adres informatie op basis van 1 of meerdere parameters (ID, postal code, REFNIS code, municipality name, postID, municipalityID, streetID, street name, gps of Lambertcoördinaten (binnen een bepaalde straal), status)
- Streets: opzoeken van straat informatie 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)
- GeoCircle: opzoeken van alle adressen binnen een bepaalde straal van een opgegeven geografische coördinaat
Docker image
- BeSt-in-a-box: creëren van een Docker container gehost op een eigen platform, bevattende:
- Een databank met BeSt-address (‘Belgian Streets and Addresses’) adresgegevens
- Een REST-webservice
Opmerkingen:
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.
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.
De Files services en Best-in-a-box zijn voor iedereen toegankelijk via de Open data-website van BOSA.
De REST-service biedt een 'open' toegang aan bedrijven (zonder inloggegevens) in een omgeving die gescheiden is van degene voor openbare services (met inloggegevens).
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-webservices
Integratievoorwaarden
Voor de Full Download en het downloaden van de Mutatiebestanden via de BOSA sFTP-server dien je een gebruikers ID en paswoord aan te vragen.
De bestanden worden ter beschikking gesteld via een afgeschermde sFTP-omgeving van BOSA: het IP-adres van de partner moet aan BOSA-zijde worden toegevoegd.
Voor de integratie van de REST-services dien je een client ID en secret aan te vragen.
De service Best-in-a-box is een gratis Docker image, zonder toegangsvoorwaarden.
Documentatie
-
Gebruikersdocumentatie en procedure voor toegang tot BeSt-services
De gebruikersgidsen kan je terug vinden onder de tab 'Technische Info'.
- BOSA Federated API Marketplace
Andere interessante componenten
Contact
Contact: ReuseOperational@smals.be
