Geozoekdiensten. Wat ligt er hier?

Zoals beloofd in Waar ligt ons Erfgoed? vertellen we je graag meer over onze Geozoekdiensten. Deze bestaan vandaag uit één webservice, gebouwd om exact één vraag te beantwoorden: wat ligt er in een bepaald gebied? Je stuurt een geometrie naar de service, en die antwoordt welk erfgoed er geheel of gedeeltelijk in ligt, als een eenvoudige JSON-structuur met voor elk object een id, een uri, een type en de volledige geometrie.

Een voorbeeld zegt meer dan duizend woorden. Stel dat we al het erfgoed willen kennen binnen honderd meter van een punt in Vlaanderen:

$ curl -X GET --header 'Accept: application/json' 'https://geo.onroerenderfgoed.be/zoekdiensten/afbakeningen?categorie=aanduidingsobjecten&geometrie=%7B%22type%22%3A%20%22Point%22%2C%20%22coordinates%22%3A%20%5B4.7676665601685%2C50.985228897907%5D%7D&buffer=100'

Dat geeft een lijst resultaten terug, elk een JSON-object met de attributen id, uri, categorie, type, naam en geometrie. Het attribuut naam is een korte omschrijving. De id identificeert het object uniek binnen de dataset waar het uit komt; de uri is gegarandeerd uniek over alle datasets heen — een globale identificator die eigenlijk gewoon een link is naar meer informatie. Vraag je bijvoorbeeld https://inventaris.onroerenderfgoed.be/erfgoedobjecten/134454 op via de browser, dan land je op een pagina over het object in de Inventaris Onroerend Erfgoed. Wil je liever de ruwe data in JSON, stuur dan een Accept: application/json header mee:

$ curl -L -X GET --header 'Accept: application/json' 'https://id.erfgoed.net/erfgoedobjecten/134454'

In dit voorbeeld vinden we een erfgoedobject uit de wetenschappelijke inventaris van tuinen en parken — af te leiden uit het attribuut type, een object met een uri en een label. Die uri verwijst naar een term in een thesaurus van inventaristypes of aanduidingstypes; volg de uri voor meer info, bijvoorbeeld dat deze inventaris intern soms ook ile_park genoemd wordt.

De geometrie zelf komt als GeoJSON mee, en omdat die nogal groot kan zijn en niet altijd relevant is, kan je de service vragen die weg te laten:

$ curl -X GET https://geo.onroerenderfgoed.be/zoekdiensten/afbakeningen?&buffer=100&geef_geometrie=0

Standaard doorzoekt de service alle soorten objecten, maar je kan filteren met de parameter categorie:

• Erfgoedobjecten: de inhoudelijke objecten die met erfgoed te maken hebben — de wetenschappelijke inventarissen.
• Aanduidingsobjecten: de juridische verankeringen van erfgoedobjecten, zowel beschermd als vastgesteld (af te leiden uit de URI van het type), inclusief erfgoedlandschappen, Unesco kernzones en Unesco bufferzones.
• Plannen: momenteel enkel beheersplannen, later uit te breiden met erfgoedrichtplannen.

Wil je bijvoorbeeld enkel de aangeduide objecten zien:

$ curl -X GET https://geo.onroerenderfgoed.be/zoekdiensten/afbakeningen?&buffer=100&geef_geometrie=0&categorie=aanduidingsobjecten

Voor simpele vragen zoals "geef me al het erfgoed rond een punt" volstaat bovenstaande. Je bent daarbij niet beperkt tot punten — (multi-)polygonen en lijnen kunnen ook, al wordt het dan snel onhandig om de volledige GeoJSON-geometrie in de URL te stoppen. Daarom ondersteunt de service ook een POST-request, waarbij je de vraag in de body van het verzoek meegeeft.

De service is vrij toegankelijk en hergebruik wordt aangemoedigd. Om snel te zien wat ze kan, raden we onze levende API-documentatie aan op https://geo.onroerenderfgoed.be/zoekdiensten/api_doc.

We hopen dat deze vrij eenvoudige webservice voor jullie even nuttig is als voor ons. Opmerkingen, vragen of extra noden mag je altijd sturen naar ict@onroerenderfgoed.be.