Een collectie van
resources
activiteit
locatie
2018-6 I Geo-Info
7
Sub-co!tectlesen
sub-resounces
Hyperlinks
Figuur 3 - Toepassing van hypermedia in de DSO API's.
kend. We werken daarom vooralsnog met één
generiek API-profiel. Maar ook naar specifie
kere API-profielen wordt onderzoek gedaan,
bijvoorbeeld voor GeoJSON in combinatie met
vector tiling.
Voorbeeld van JSON API versus WFS
Wie momenteel online gebruik wil maken
van geografische data komt vaak nog uit
bij een WFS. Kenmerkend van zo'n service
is dat specifieke gegevens door middel van
parameters uit een verzameling van gegevens
worden gefilterd. Die filtering gebeurt door
het samenstellen van key-value pairs. Daar
mee wordt bijvoorbeeld aangegeven wat er
wordt gezocht (request) en in welke verzame
ling gegevens (typenames). Vaak moet ook
expliciet worden benoemd dat een WFS wordt
bevraagd (service) en ook welke WFS versie
(version). Verder is het nodig om voor het
opvragen van een feature met een bepaalde
attribuutwaarde de OpenGIS-filter encoding
te gebruiken. Of de Common Query Language
(CQL) filter, als de WFS wordt geserveerd met
GeoServer.
Met het CQL filter ziet het er zo uit:
http://afnemers.ruimtelijkeplannen.nl/afne-
mers20i2/services?service=wfs&version=2.o.o&r
equest=GetFeature&typenames=app:Bestemmi
ngsplangebied&cql_filter=app.identificatie='NL.
IMRO.0150.W014-VG01
Nu de vergelijking met de API's zoals we ook
met het DSO beschikbaar gaan maken. In dit
model is elk object (bijvoorbeeld een bestem
mingsplangebied) globaal uniek geïdentificeerd
met een URI en op basis van die URI direct, en
dus niet via complexe filtering, opvraagbaar:
https://data.informatiehuisruimte.nl/api/ruimte-
lijke-plannen/vi/bestemmingsplangebieden/
NL.IMRO.0150.W014-VG01
Nog een voorbeeld. Als we de bestemmings-
vlakken van dit bestemmingsplangebied wil
len opvragen, dan is dat een request als volgt:
https://data.informatiehuisruimte.nl/api/ruimte-
lijke-plannen/vi/bestemmingsvlakken?bestemm
ingsplangebied=NL.IMRO.0i50.W0i4-VG0i
Conclusie
We hebben laten zien dat we er bij het
Digitaal Stelsel Omgevingswet (DSO)
voor hebben gekozen om de geo-data
te integreren in een breder domein van
informatievoorziening. Dat geldt zowel voor
de informatiekundige modellering (standaar
den), maar ook bij het ontsluiten via API's
en de opbouw van centrale voorzieningen.
Geo-informatie integreert daarmee echt in
de bredere informatievoorziening. Voor niet-
geo-ICT'ers wordt de geo dus beter zichtbaar
en bruikbaar, voor de huidige geo-sector is
het juist andersom: de ooit zo herkenbare
eigen OGC services worden vervangen
door actuele en gangbare ICT oplossingen.
De wet van de remmende voorsprong is hier
van toepassing.
Voor de geo-informatie sector zal het een
stap zijn: geen native OGC-services, en waar
is de kaart gebleven? Het mooie van het DSO
is de brede beschikbaarheid van gegevens
en services, op basis van Open Stelsel voor
Derden beleid. We nodigen u dus van harte
uit om eens een kijkje te nemen bij de nieuwe
voorzieningen en om ook een stap te zetten
naar REST API's voor de ontsluiting van geo-
informatie.
Referenties
[1] www.opengeospatial.org
[2] www.omgevingswetportaal.nl/documenten/brochures/
2017/01/06/informatieblad-dso
[3] www.omgevingswetportaal.nl/documenten/publicaties/
2016/06/16/bestuurlijke-visie-digitaal-stelsel-omgevingswet
[4] www.kadaster.nl/dataplatform-voor-de-toekomst
[5] www.ruimtelijkeplannen.nl/
[6] aandeslagmetdeomgevingswet.nl/digitaal-stelsel/
[7] aandeslagmetdeomgevingswet.nl/ontwikkelaarsportaal/
[8] aandeslagmetdeomgevingswet.nl/digitaal-stelsel/
technisch-aansluiten/standaarden/api-uri-strategie
[9] aandeslagmetdeomgevingswet.nl/digitaal-stelsel/
technisch-aansluiten/standaarden/api-uri-strategie
[10] www.geonovum.nl/geo-standaarden/ro-standaarden-
ruimtelijke-ordening
[11] tools.ietf.org/html/rfc8259
[12] tools.ietf.org/html/draft-kelly-json-hal-08
[13] tools.ietf.org/html/rfc7946
Op zoek naar een bestemmingsplangebied met
identificatie 'NL.IMRO.0150.W014-VG01' ziet het
request met OpenGIS-filter encoding er zo uit:
Hier is te zien dat er in de URI de identificatie
van het bestemmingsplangebied als parame
ter wordt meegegeven.
Bart Huijbers: Bart.Huijbers@geodan.nl,
senior consultant Geodan
http://afnemers.ruimtelijkeplannen.nl/afnemers/
services?REQUEST=GetFeature&service=WFS&ve
rsion=1.1.0&typename=app:Bestemmingsplange
bied&filter=<Filter+xmlns="http://www.opengis.
net/ogc"><PropertyIsEqualTo><PropertyNam
e>plangebied</PropertyName><Literal>NL.
IMRO.0150.W014-VG01</Literal></PropertyIsE-
qualTo></Filter
Naast een HTTP GET request kan er ook
gewerkt worden met POST. In dat geval
worden de parameters, zoals locatiegerichte
zoekvragen, als request body meegegeven.
Een essentieel verschil met WFS is, dat de data
rechtstreeks door middel van een al dan niet
geparametriseerde URL wordt opgevraagd, en
niet hoeft te worden gefilterd.
Tony Sloos: tony@architecit.nl, domeinarchitect
deelprogramma DSO
PaulDix:paul.dix@kadaster.nl, informatieanalist
Kadaster
Arie Duindam: arie.duindam@kadaster.nl,
senior adviseur Kadaster