referenceData_geography countries

Service waarmee de lijst met landen, beschikbaar in vier talen (FR, NL, DE, EN), geraadpleegd kan worden.

  • Service
  • Smals

Beschrijving

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

  • Verkrijgen van de gegevens van een land op basis van de NIS-code van dit land
  • Verkrijgen van de lijst met landen of een selectie hiervan op basis van zoekcriteria

Voor elk land kan men de volgende informatie verkrijgen:

  • NIS-landencode
  • Naam van het land in vier talen (FR, NL, DE, EN)
  • Code van het land in twee letters (norm ISO-3166-1), aanbevolen om een adres te specificeren
  • Code van het land in drie letters (norm ISO-3166-1), aanbevolen om een nationaliteit te specificeren
  • Code van het land in maximaal drie cijfers (norm ISO-3166-1), nuttig om de landen te identificeren die geen Latijns alfabet gebruiken
  • Status: actief of niet-actief (naargelang de einddatum van geldigheid later of vroeger valt dan de huidige datum)
  • Naam van de inwoners in vier talen (FR, NL, DE, EN)
  • Begindatum van geldigheid
  • Einddatum van geldigheid

Aangezien de REST-service referenceData_geography voor de resource ’countries’ gebaseerd is op de NIS-codes van landen, kunnen bepaalde grondgebieden, hoewel ze een ISO-code hebben, niet geconsulteerd worden via deze service, omdat ze geen NIS-landencode hebben
Voorbeelden: Faeröereilanden, Jersey, Mayotte...

Anderzijds merken we op dat

  • bepaalde NIS-codes geen bijbehorende ISO-code hebben:
    Tsjecho-Slowakije, Kosovo, Jeruzalem, NAVO, SHAPE, Apatride...
  • bepaalde landen geen eigen ISO-code hebben, maar diegene van het land waartoe ze behoren:
    Canarische eilanden (ESP), Madeira (P)...
  • bepaalde entiteiten een eigen ISO-code hebben die verschilt van het hoofdland:
    Guadeloupe (GP) en Martinique (MQ) hebben niet de ISO-code van Frankrijk (FR)
  • de naam van een inwoner van een land in het mannelijk enkelvoud wordt gegeven:
    Fransman, Spanjaard, Belg, Guadelouper, Groenlander...
  • de naam van een inwoner van een land niet overeenkomt met zijn nationaliteit aangezien deze laatste niet verschaft wordt door deze service:
    Een Guadelouper heeft de Franse nationaliteit, een Groenlander heeft de Deense nationaliteit
  • bepaalde NIS-codes aangemaakt werden om te beantwoorden aan businessbehoeften:
    ’Apatride’, ‘Nog niet definitief vastgelegd’, ’Afgevoerd voor het buitenland’, ‘Op zee’, ‘Onbepaald’, ‘van oorsprong’, ’Vluchteling’, ’Onbepaald’, ‘SHAPE’ en 'NAVO'

Gebruikersgroepen

Elke toepassing die internationale adressen verwerkt en die een NIS-code, een landencode volgens de norm ISO-3166-1 en/of geldigheidsdata van landen vereist.

Opmerking : Er bestaat een authentieke bron van landcodes onder toezicht van FOD Buitenlandse Zaken, gezamenlijk beheerd door FOD Economie en BOSA DT, en die beschikken over een gebruikerscomité en een structuur en procedures voor governance.

FOD Beleid en Ondersteuning (Bosa) biedt SOAP services aan om deze authentieke bron van landcodes te consulteren.

In dat geval dient u rechtstreeks contact op te nemen met hen via de site Statbel.

Integratie voorwaarden

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

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

Contact: TransversalTeam@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