BeSt Address

Overzicht

Service voor het opzoeken van Belgische adressen, straten en gemeenten, gebaseerd op de drie regionale authentieke bronnen van Brussel, Vlaanderen en Wallonië

De BeSt Address-services van FOD BOSA bieden je adres diensten op federaal niveau aan 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 zowel file transfer services (File services) als webservices.

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 april 2024)

REST services

• 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

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...). Bijvoorbeeld  https://data.vlaanderen.be/id/straatnaam/ 70689 2014-11-24T21:45:11.130
• 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.
• Voor Wallonië is de postalInfoName niet ingevuld. Andere regio's vullen hier een aaneenschakeling van alle namen die met dezelfde postcode overeenkomen in.
• Een appartementsgebouw heeft een eigen BeSt ID, naast de individuele appartementen die ook elk een eigen BeSt ID hebben.

Technische beschrijving

File services zijn beschikbaar via

• een afgeschermde SFTP-server (momenteel enkel Full Download)
• het BOSA Open data platform (momenteel enkel Full Download)

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.

Overheden kunnen zowel de File services (via SFTP-protocol en via het Open data platform) als de REST-services gebruiken, terwijl bedrijven enkel de File services (via het Open dataplatform) kunnen gebruiken.

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

Contact: ReuseOperational@smals.be

Documentatie

• Gebruikersdocumentatie en procedure voor toegang tot BeSt-services