referenceData_geography belgianCities

Service om de lijst van Belgische gemeenten te raadplegen
beschikbaar in de drie landstalen

  • Service
  • Authentieke bron
  • Smals

Beschrijving

De REST-service referenceData_geography biedt, voor de resource belgianCities, volgende functionaliteiten:

  • Verkrijgen van een lijst met alle Belgische gemeenten, hoofdgemeenten of niet-gefusioneerde gemeenten
  • Verkrijgen van de Belgische gemeenten, hoofdgemeenten of niet-gefusioneerde gemeenten op basis van een - gedeeltelijke of volledige - naam van de gemeente
  • Verkrijgen van de Belgische gemeenten, hoofdgemeenten of niet-gefusioneerde gemeenten op basis van een officiële - gedeeltelijke of volledige - postcode van de gemeente
  • Verkrijgen van de Belgische gemeenten, hoofdgemeenten of niet-gefusioneerde gemeenten op basis van een officiële - gedeeltelijke of volledige - postcode en van een - gedeeltelijke of volledige - naam van de gemeente
  • Verkrijgen van de Belgische gemeenten, hoofdgemeenten of niet-gefusioneerde gemeenten op basis van een gewestcode
  • Verkrijgen van de Belgische gemeenten, hoofdgemeenten of niet-gefusioneerde gemeenten op basis van een taalkundige gewestcode

Voor elke Belgische gemeente kan men volgende gegevens verkrijgen:

  • NIS-code van de gemeente, als het om een hoofdgemeente gaat
  • Officiële Belgische postcode van de gemeente
  • Naam van de gemeente, hoofdgemeente of niet-gefusioneerde gemeente, in de drie landstalen Nederlands (= NL), Frans (= FR) en Duits (= DE)
  • Het taalregime van de gemeente F, FN, FD, N, NF, DF, FN_NF en NF_FN, waarbij F = Frans, N = Nederlands, D = Duits, FN_NF en NF_FN = tweetalig en FN, FD, NF, DF = faciliteitengemeenten
  • De gewestcode BRU (= Brussel Hoofdstedelijk gewest), VLG (= Vlaams gewest) en WAL (= Waals gewest)
  • De taalkundige gewestcode NL, FR, DE en BIL (= tweetalig)
  • Begindatum van geldigheid
  • Einddatum van geldigheid
  • De link naar de technische identificatie van de bijbehorende hoofdgemeente, als de gemeente geen hoofdgemeente is
  • De link naar technische identificatie

Gezien de REST-service referenceData_geography, voor de resource belgianCities, op de postcodes van de Belgische post gebaseerd is, komen bepaalde codes niet overeen met een gemeente.
Bijvoorbeeld: 1012 = Parlement van de Franse Gemeenschap.

Merk anderzijds op dat

  • bepaalde speciale gemeenten geen NIS-code hebben, bijv. Brussel X, Brussel NAVO...
  • bij elke niet-gefusioneerde gemeente een hoofdgemeente hoort
  • de lijst beperkt wordt tot de hoofdgemeenten door de parameter isMainCity=true toe te passen

Hoewel de service de naam van een gemeente in de drie talen aanbiedt, is het aan te raden de naam van een gemeente uitsluitend in haar taalregime te gebruiken.
Bijvoorbeeld: Antwerpen en niet Anvers, Liège en niet Luik.

Gebruikersgroepen

Elke toepassing die Belgische adressen verwerkt en die een postcode, een NIS-code van een gemeente of geldigheidsdata van Belgische gemeenten vereist.

Opmerking: in het kader van het project BElgian STandard address worden vanaf heden de authentieke bronnen van de adressen beheerd door de gewesten. FOD Beleid en Ondersteuning (Bosa) stelt SOAP- en REST-services ter beschikking voor de consultatie van gemeenten, straten en adressen.

Integratievoorwaarden

Er zijn geen bijzondere integratievoorwaarden, gezien de service niet beveiligd is.

Voor Angular-toepassingen moet men echter de URN van de toepassing doorsturen om de toegang tot de service te configureren.

Contact: ReuseOperational@smals.be

Documentatie

Sommige van de onderstaande links werken mogelijk niet omwille van beveiligingsbeperkingen.

Wenst u deze informatie te verkrijgen, neem dan contact op met het verantwoordelijke team via het e-mailadres hierboven vermeld in de paragraaf Integratievoorwaarden.

Hoe neem jij deel aan ons project?

Vul de catalogus aan

Heb je een herbruikbare component die voor een andere instelling van pas kan komen?

Leg hem aan ons voor!

Neem deel aan onze evenementen

Ideeën uitwisselen over hergebruik? Dat kan op onze evenementen. We organiseren er regelmatig!

Schrijf je zeker in!

Abonneer je op de nieuwsbrief

Schrijf je in op onze nieuwsbrief en blijf op de hoogte van de laatste ontwikkelingen in hergebruik.

Abonneer je

Deel je ervaringen

Is jouw project een succes geworden dankzij een hergebruikte component?

Laat het ons weten! 

Naar boven