The GeoDCAT-AP API (GeoDCAT-API)
This API is a proof-of-concept of the implementation of GeoDCAT-AP in an OGC CSW (Catalog Service for the Web), re-using the standard CSW interface, and supporting in addition HTTP content negotiation.
More precisely, GeoDCAT-API uses the standard CSW parameters
outputFormat to determine, respectively, (a) the GeoDCAT-AP profile to be used (core or extended), and (b) the RDF serialisation to be returned.
The document containing the ISO 19139 records to be transformed is specified by a GeoDCAT-API-specific parameter
src, which is not part of the CSW interface.
The API uses the GeoDCAT-AP XSLT to transform ISO 19139 records into GeoDCAT-AP. As such, the API works both on static files including the records, and on the CSW output of a
A working demo of GeoDCAT-API is available at:
Supported HTTP methods
The current version of GeoDCAT-API supports only the HTTP
GET method. As a consequence, it can be used only on CSWs supporting
|Parameter||Description||Possible values||Default value||Notes|
||The GeoDCAT-AP profile to be used for the transformation||(DCAT-AP)||
If this parameter is omitted, the API uses the "core" profile as default.
The "core" profile is labelled "DCAT-AP", since it returns just the metadata elements supported in DCAT-AP.
NB: The current values of this parameter are provisional, and they are meant to be replaced by the official namespace URIs of DCAT-AP and GeoDCAT-AP, when available.
||The RDF serialisation to be returned||(RDF/XML)||N/A||If this parameter is omitted, the returned RDF serialisation is determined via HTTP content negotiation|
||The URL of the resource containing the ISO 19139 records to be tranformed||A URL||N/A|
Besides the resulting RDF serialisation of the source ISO 19139 records, the API returns a set of HTTP
Link headers, and the corresponding HTML LINK elements in the HTML+RDFa serialisation.
|Relation type||Type||Title||Target URI|
||The URL of the source document, containing the ISO 19139 records.|
||The media type of the document returned by the API.||
||The media type of the document returned by the API.||The name of the returned RDF serialisation.||The URL of the document returned by the API.|
||The media types of the alternative RDF serialisations supported by the API.||The name of the relevant RDF serialisation.||The URL of the document, encoded with the relevant RDF serialisation, as would be returned by the API.|
GeoDCAT-API has been tested on both Linux and Windows, with Apache 2 and PHP 5.3.2 (or later) installed and running.
NB: GeoDCAT-API makes use of the PHP XSL extension.
The repository includes all what is necessary, with the exception of EasyRDF and ML/JSON-LD, that must be installed separately by using Composer.
- Go to folder
- Download Composer. E.g.:
curl -s https://getcomposer.org/installer | php
php composer.phar install
You will now be able to run the API from a Web folder.