Open data
De informatie van NederlandWereldwijd is openbaar. Open data zijn gegevens die iedereen mag gebruiken en verspreiden. Ontwikkelaars kunnen open data bijvoorbeeld gebruiken om een app te ontwikkelen of om informatie op hun eigen website te plaatsen.
Reisadviezen opvragen
De reisadviezen op www.nederlandwereldwijd.nl helpen reizigers zich voor te bereiden op eventuele veiligheidsrisico’s bij een buitenlands verblijf.
- Vraag een set met 25 reisadviezen op via: opendata.nederlandwereldwijd.nl/v1/sources/nederlandwereldwijd/infotypes/traveladvice
- Gebruik eventueel parameters om de lijst met resultaten verder te verfijnen. Zie hiervoor Open data filteren op Rijksoverheid.nl.
- Zoek in de (gefilterde) lijst het gewenste reisadvies. Het veld ‘dataurl’ bij het gewenste reisadvies bevat het volledige pad. Vraag hiermee de inhoud van het reisadvies op.
Voorbeeld
Zo vraagt u de tekst op van het reisadvies voor Spanje:
opendata.nederlandwereldwijd.nl/v1/sources/nederlandwereldwijd/infotypes/traveladvice/4bf6b57b-6e6e-4888-92d6-f42b47449557
velden per reisadvies:
De volgende velden van reisadviezen kunnen terugkomen in responses en kunt u gebruiken in requests:
- id *
- type *
- canonical *
- dataurl *
- title *
- location
- classification **
- modifications
- content
- authorities
- creators
- lastmodified *
- issued
- available
- license
- rightsholders
- language
- subject
- themes
(*) Als u een lijst met reisadviezen opvraagt, krijgt u alleen deze velden terug als response. Vraagt u een reisadvies voor een bepaald land op, dan bevat de response alle velden.
(**) De ondersteuning voor dit veld is per 16 juni 2014 komen te vervallen.
Adresgegevens ambassades en consulaten opvragen
Een overzicht van de adresgegevens van de ambassades en consulaten vindt u via:
Landen opvragen
De opendata feed heeft een landenoverzicht waarvandaan het mogelijk is om een reisadvies of contactgegevens van ambassades en consulaten op te vragen voor elk land. U kunt een set van 25 landen opvragen via:
https://opendata.nederlandwereldwijd.nl/v2/sources/nederlandwereldwijd/infotypes/countries
Zo vraagt u de data op van het land België:
https://opendata.nederlandwereldwijd.nl/v2/sources/nederlandwereldwijd/infotypes/countries/belgie
In het veld travelAdvice vindt u de url voor het reisadvies voor het gekozen land en in het veld nlRepresentation vindt u het overzicht van contactgegevens voor het gekozen land.
Reisadviezen opvragen
De reisadviezen op www.nederlandwereldwijd.nl ondersteunen reizigers bij het voorbereiden op mogelijke veiligheidsrisico’s tijdens hun verblijf in het buitenland.
- U kunt een set van 25 reisadviezen opvragen via:https://opendata.nederlandwereldwijd.nl/v2/sources/nederlandwereldwijd/infotypes/traveladvice
- Gebruik desgewenst parameters om de lijst met resultaten te filteren. Zie hiervoor Open data filteren op Rijksoverheid.nl.
- Zoek vervolgens het gewenste reisadvies in de (gefilterde) lijst. De ‘dataurl’ van het reisadvies bevat de volledige URL. Hiermee kunt u de inhoud van het specifieke reisadvies opvragen.
Voorbeeld
Zo vraagt u de tekst van het reisadvies voor Spanje op: https://opendata.nederlandwereldwijd.nl/v2/sources/nederlandwereldwijd/infotypes/countries/spanje/traveladvice
Adresgegevens van ambassades en consulaten ophalen
De open data met adresgegevens van ambassades en consulaten is beschikbaar via:
https://opendata.nederlandwereldwijd.nl/v2/sources/nederlandwereldwijd/infotypes/countries?rows=200
Nood-informatie opvragen
De open data met informatie over wat te doen in geval van nood in het buitenland is te vinden via:
Wijzigingen ophalen
Het is mogelijk om via de open data API van NederlandWereldwijd uitsluitend wijzigingen in gegevens op te halen sinds een bepaalde datum en tijd. Dit kan gedaan worden met een datumfilter (?modifiedSince= yyyyMMddHHmmssSSS) of door het gebruik van een If-Modified-Since-header in de API-aanroep. Hiermee wordt alleen de informatie opgehaald die na de opgegeven datum en tijd gewijzigd is. Dit is mogelijk voor zowel reisadviezen, contactgegevens van ambassades en consulaten en noodhulp.
Voorbeeld
Vraag de reisadviezen op die gewijzigd zijn sinds 1 oktober 2024 14:00:00
Of gebruik bij het aanvragen van een specifiek reisadvies de If-Modified-Since-header:
If-Modified-Since: Wed, 1 Oct 2024 14:00:00 GMT
Op deze manier kan de data actueel gehouden worden zonder overbodige dataverwerking.
OpenAPI
Als ontwikkelaar kunt u gebruik maken van de OpenAPI specificatie van deze open data feed. Deze kunt u op de volgende manier opvragen:
https://opendata.nederlandwereldwijd.nl/v2/sources/nederlandwereldwijd/openapi.yaml
https://opendata.nederlandwereldwijd.nl/v2/sources/nederlandwereldwijd/openapi.json