referenceData_geography countries

Typologie
Service
Eigenaar
Smals

Overzicht

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

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.

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: TransversalTeamFunctional@smals.be

Documentatie

Voor de raadpleging van de landencodes bestaat er ook een SOAP-alternatief van de service, beschouwd als de authentieke bron en die onder toezicht staat van FOD Buitenlandse Zaken, medebeheerd door FOD Economie en Fedict.

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

back2top