Documentatie
Data rond de besluitvorming van de Vlaamse Regering wordt gepubliceerd in gestandardiseerde formaten die zowel door mens- als machine geïnterpreteerd kunnen worden. Ontdek de data en ga er zelf mee aan de slag!
Data ontsluiting
Alle data op Themis wordt ontsloten als Linked Open Data volgens de richtlijnen en informatiemodellen van https://data.vlaanderen.be. De data wordt op verschillende manieren beschikbaar gesteld, zowel in mens- als in machine-leesbare formaten zodanig dat iedereen er mee aan de slag kan. Alle publicatiekanalen zijn gebasseerd op bestaande (web)standaarden.
In wat volgt worden de gebruikte informatiemodellen en vocabularia van Themis in het algemeen toegelicht. In APIs worden de verschillende manieren om toegang te krijgen tot de data toegelicht. Meer gedetailleerde informatie over specifieke datasets, kan je terugvinden in Besluitvormingscatalogus.
Data formaat
OSLO-standaarden en gerelateerde vocabularia
De Linked Data op Themis volgt de informatiemodellen zoals bepaald in het besluitvorming-traject van de Open Standaarden voor Linkende Organisaties (OSLO) van de Vlaamse overheid. In Besluitvormingscatalogus worden informatiemodellen voor specifieke datasets verduidelijkt.
Deze informatiemodellen maken gebruik van onderstaande vocabuaria.
| Naam | Prefix | Namespace |
|---|---|---|
| OSLO Besluitvorming | besluitvorming | https://data.vlaanderen.be/ns/besluitvorming# |
| OSLO Besluit | besluit | http://data.vlaanderen.be/ns/besluit# |
| OSLO Mandaat | mandaat | http://data.vlaanderen.be/ns/mandaat# |
| OSLO Dossier | dossier | https://data.vlaanderen.be/ns/dossier# |
| OSLO Generiek | generiek | https://data.vlaanderen.be/ns/generiek# |
| OSLO Organisatie | organisatie | https://data.vlaanderen.be/ns/organisatie# |
| W3C Provenance | prov | http://www.w3.org/ns/prov# |
| Dublin Core Metadata Terms | dct | http://purl.org/dc/terms/ |
DCAT
De verschillende datasets op Themis worden aangeboden gebasseerd op het W3C Data Catalog Vocabulary. Onderstaande modellen en eigenschappen uit het vocabularium zijn geïmplementeerd in Themis.
Catalog
Een catalogus is een collectie van datasets. In Themis wordt momenteel slechts een catalogus gepubliceerd: de besluitvormingscatalogus.
Onderstaande eigenschappen zijn beschikbaar voor een catalogus.
| Naam | Predicaat | Bereik | Beschrijving |
|---|---|---|---|
| class | rdf:type | rdfs:Class | http://www.w3.org/ns/dcat#Catalog |
| title | dct:title | xsd:string | Titel van de catalogus |
| description | dct:description | xsd:string | Beschrijving van de catalogus |
| publisher | dct:publisher | rdfs:Resource | https://data.vlaanderen.be/id/organisatie/OVO001827 |
| release-date | dct:issued | xsd:dateTime | Release datum van de catalogus |
| modified | dct:modified | xsd:dateTime | Datum waarop de catalogus het laatst gewijzigd is |
| datasets | dcat:dataset | dcat:Dataset | Datasets die deel uitmaakt van de catalogus |
Dataset
Een dataset is een verzameling van data dat toegankelijk en/of downloadbaar is in een of meerdere representaties. Een catalogus bevat een of meerdere datasets. De datasets hebben een bijkomend type om de inhoud van de verschillende datasets te onderscheiden.
Onderstaande eigenschappen zijn beschikbaar voor een dataset.
| Naam | Predicaat | Bereik | Beschrijving |
|---|---|---|---|
| class | rdf:type | rdfs:Class | http://www.w3.org/ns/dcat#Dataset |
| title | dct:title | xsd:string | Titel van de dataset |
| description | dct:description | xsd:string | Beschrijving van de dataset |
| release-date | dct:issued | xsd:dateTime | Release datum van de dataset |
| modified | dct:modified | xsd:dateTime | Datum waarop de catalogus het laatst gewijzigd is |
| type | dct:type | rdfs:Resource | Type van de dataset |
| subject | dct:subject | rdfs:Resource | Onderwerp van de dataset |
| distributions | dcat:distribution | dcat:Distribution | Representaties van de dataset |
| previous-version | prov:wasRevisionOf | dcat:Dataset | Vorige versie van de dataset |
Distribution
Een representatie van een (deel van een) dataset. Een dataset kan verschillende representaties hebben. Deze kunnen, maar hoeven niet per se, inhoudelijk equivalent te zijn.
Onderstaande eigenschappen zijn beschikbaar voor een representatie.
| Naam | Predicaat | Bereik | Beschrijving |
|---|---|---|---|
| class | rdf:type | rdfs:Class | http://www.w3.org/ns/dcat#Distribution |
| title | dct:title | xsd:string | Titel van de representatie |
| description | dct:description | xsd:string | Beschrijving van de representatie |
| release-date | dct:issued | xsd:dateTime | Release datum van de representatie |
| modified | dct:modified | xsd:dateTime | Datum waarop de catalogus het laatst gewijzigd is |
| type | dct:type | rdfs:Resource | Type van de representatie |
| subject | dct:subject | rdfs:Resource | Onderwerp van de representatie |
| download-url | dcat:downloadURL | rdfs:Resource | URL waar de representatie gedownload kan worden |
| format | dct:format | xsd:string | Formaat van de representatie |
| byte-size | dcat:byteSize | xsd:decimal | Grootte van de representatie in bytes |
APIs
Subject pages
De subject pages bieden een human-readable HTML pagina met alle informatie die gekend is over een bepaalde subject URL. Aangezien de pagina's geannoteerd zijn met RDFa zijn is de informatie ook interpreteerbaar door machines, denk hiebij bijvoorbeeld aan crawlers en zoekmachines.
REST API
Themis biedt een REST API aan om de DCAT resources te bevragen. Deze API is in lijn met de JSON:API specificatie. Paginatie, sortering en filteren gebeurt aan de hand van query parameters zoals beschreven in de documentatie van het gebruikte framework.
Onderstaande API endpoints zijn beschikbaar:
| Method | Path | Beschrijving |
|---|---|---|
| GET | /catalogs | Gepagineerde lijst van alle catalogussen |
| GET | /catalogs/:id | Detail van een catalogus |
| GET | /datasets | Gepagineerde lijst van alle datasets |
| GET | /datasets/:id | Detail van een dataset |
| GET | /distributions | Gepagineerde lijst van alle representaties |
| GET | /distributions/:id | Detail van een representatie |
De REST API biedt enkel endpoints om de DCAT resources te bevragen. De inhoud van de datasets kan gedownload worden via de download URL van de bijhorende representaties.
SPARQL endpoint
Themis biedt een SPARQL endpoint aan om de Linked Data te bevragen gebruik makend van de SPARQL 1.1 query language. Op deze manier kan alle data die
gepubliceerd is op Themis, dus niet enkel de DCAT resources, bevraagd worden. Het endpoint is beschikbaar op
/sparql.
Het SPARQL endpoint heeft volgende constraints:
- SPARQL queries kunnen enkel gestuurd worden via HTTP GET met percent encoded query parameters
- enkel SPARQL SELECT queries worden ondersteund
- de SPARQL query moet voldoen aan de SPARQL EBNF formaat
- query resultaten kunnen enkel vekregen worden in het application/sparql-results+json formaat
Merk op dat SPARQL update queries geen foutmelding geven, maar de gevraagde data manipulaties zullen niet uitgevoerd worden.