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) et des services web.
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)
- et informations relatives aux codes postaux (postalInfo)
- Téléchargement de fichiers de mutations (prévu en avril 2024)
Services REST
- 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, gps ou coordonnées 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)
- GeoCircle : recherche de toutes les adresses dans un certain rayon d'une coordonnée géographique spécifiée
Remarques :
- Chaque objet adresse fourni par un service BeSt contient une clé unique composée de 3 parties : Namespace, Object-ID et Version-ID. Le Namespace est une constante et contient une référence à la région et au type d'objet (adresse, nom de rue, commune...). Par exemple, https://data.vlaanderen.be/id/straatnaam/ 70689 2014-11-24T21:45:11 130.
- 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.
- Pour la Wallonie le postalInfoName n'est pas renseigné. Les autres régions remplissent ici une concaténation de tous les noms correspondant au même code postal.
- Un immeuble d'appartements a son propre BeSt ID et chaque appartement individuel possède également son popre BeSt ID.
Description technique
Les File services sont disponibles via
- un serveur SFTP protégé (actuellement uniquement en téléchargement complet)
- la plateforme BOSA Open data (actuellement uniquement en téléchargement complet)
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.
Les gouvernements peuvent utiliser à la fois les File services (via le protocole SFTP et via la plateforme Open data) et les services REST, tandis que les entreprises ne peuvent utiliser que les File services (via la plateforme Open data).
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ée BOSA en utilisant les services Web
Conditions d'intégration
Pour le téléchargement complet et celui des fichiers de mutations via le serveur SFPT BOSA, vous devez demander un identifiant et un mot de passe.
Les fichiers sont mis à disposition via un environnement protégé de SFTP BOSA : l'adresse IP du partenaire doit être ajoutée chez BOSA.
Pour intégrer les services REST, vous devez demander un identifiant client et un secret.
Contact : ReuseOperational@smals.be
Documentation
Certains des liens ci-dessous pourraient ne pas fonctionner en raison de restrictions de sécurité.
Si vous voulez obtenir ces informations, prenez contact avec l’équipe responsable via l’adresse email spécifiée dans le paragraphe ci-dessus consacré aux conditions d’intégration.
