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.
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:
https://opendata.nederlandwereldwijd.nl/v2/sources/nederlandwereldwijd/infotypes/hulp-bij-nood
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