Aperçu
Services de recherche d'adresses, rues et communes belges, basés sur les trois sources authentiques régionales de Bruxelles, Flandre et Wallonie.
Services métiers des institutions
Sous-domaineSystème de référence et terminologie
TypologieService & API
Service ownerBOSA
2023
Quelle en est l'utilité ?
Les services BeSt Address du SPF BOSA vous offrent des services d'adresses au niveau fédéral qui regroupent les informationss d'adresses provenant des 3 sources régionales authentiques. Chaque région (Région flamande, Région de Bruxelles-Capitale et Région wallonne) dispose de sa propre source authentique de données d'adresses pour son territoire, contenant les données nécessaires pour localiser sans ambiguïté les parcelles de terrain et les structures présentes sur celles-ci, telles que les maisons ou les bâtiments industriels.
Description fonctionnelle
Les services BeSt Address exploitent les données BeSt Address (codification des données géoréférencées sur les rues et les adresses en Belgique) et comprennent des services de transfert de fichiers (File services), des services web REST et une image Docker.
Ils offrent les fonctionnalités suivantes :
File services
- Téléchargement complet (Full Download), pour le territoire belge, des fichiers suivants :
- Adresses (Addresses)
- Noms de rue (streetNames)
- Communes (Municipalities)
- Anciennes communes rattachées à la commune (partOfMunicipalities)
- Informations relatives aux codes postaux (postalInfo)
- Téléchargement de fichiers de mutations
(prévu courant 2026 pour la Flandre; en cours de test pour la Wallonie et Bruxelles)
Service REST BeSt Address
- Ressources
- Address : recherche d'informations sur les adresses en fonction d'un ou plusieurs paramètres (ID, postal code, REFNIS code, municipality name, postID, municipalityID, streetID, street name, coordonnées GPS ou Lambert dans un certain rayon, status)
- Streets : recherche d'informations sur les rues en fonction d'un ou plusieurs paramètres (ID, name, postal code, REFNIS code, postID, municipalityID, status)
- Municipalities : recherche d'informations sur les communes en fonction d'un ou plusieurs paramètres (ID, name, postal code, REFNIS code, postID)
- Postalinfos : recherche d'informations sur les codes postaux en fonction d'un ou plusieurs paramètres (ID, name, postal code)
Image Docker
- BeSt-in-a-box : créer un Docker container hébergé sur une de vos plateformes, contenant :
- La base de données d’adresses BeSt Address (« Belgian Streets and Addresses »)
- Le service web REST BeSt Address
Remarques :
Pour faire référence à une adresse dans une base de données, par exemple à une adresse dans le dossier de pension d'une personne, vous devez utiliser l'ID BeSt complet (Namespace + Object-ID + Version-ID).
Les BeSt ID peuvent changer, par exemple dans le cas d'un changement d'adresse administrative, comme un changement de nom de rue ou la renumérotation d'une rue. Dans ce cas, pour Bruxelles et la Wallonie, l'Object-ID de la rue ou de l'adresse reste constant mais la version augmente, ce qui modifie le BeSt ID dans son ensemble (Namespace + Object-ID + Version-ID). Pour la Flandre, un nouvel Object-ID est attribué à ce cas.
Pour la Flandre, aucune donnée partOfMunicipality n'est disponible car la Flandre ne travaille plus avec des sous-communes; celles-ci sont agrégées dans postalInfoName.
postalInfoName est complété uniquement pour la Flandre.
Chaque appartement individuel possède son popre BeSt ID.
Description technique
Les File services sont disponibles via
- un serveur SFTP protégé (actuellement uniquement en téléchargement complet au format XML)
- le site de BOSA Open data (actuellement uniquement en téléchargement complet au format XML et CSV)
Tous les services web sont de type REST (format JSON).
Public cible
Les groupes cibles sont aussi bien les gouvernements (fédéraux, régionaux) que les entreprises qui ont besoin d'adresses, de rues et de communes belges pour le bon fonctionnement de leurs activités.
Nous distinguons deux types d'utilisateurs :
- Les organisations qui travaillent avec leur propre base de données d'adresses et la construisent en utilisant
- les fichiers de téléchargement complet pour l'initialisation de la base de données
- les fichiers de mutations quotidiens pour maintenir cette base de données à jour
- Les organisations qui consultent les données d'adresse dans la base de données d'adresses consolidées BOSA en utilisant le service REST BeSt Address
Conditions d'intégration
Les Files services et Best-in-a-box sont accessibles à tout le monde, via le site web Open data de BOSA.
L'API REST BeSt Address est accessible
- soit en accès "ouvert" aux entreprises (sans identifiants)
- soit via l’intégrateur de services BOSA pour les administrations publiques (avec identifiants).
Documentation
-
Documentation utilisateur et procédure d'accès aux services BeSt
Vous trouverez les guides d'utilisation sous l'onglet "Informations Techniques".
- SocSec API Gateway used for BOSA services
Autres composants intéressants
Contact
Contact : ReuseOperational@smals.be
