HVD Reporting Tool

High-value Datasets Reporting Beta

Home
Overview for all countries
Reports
Detail per Country

DCAT-AP — API access

Option A — through an HVD-tagged distribution

<your-dataset-iri> dcat:distribution [
  a dcat:Distribution ;
  dcatap:applicableLegislation hvd-ir: ;
  dcat:accessURL <https://your-api/service> ;
  dct:license <.../licence/CC_BY_4_0> ;
  dcat:accessService <your-service-iri>
] .
<your-service-iri> a dcat:DataService ;
  dcatap:applicableLegislation hvd-ir: ;
  dcat:endpointURL <https://your-api/service> ;
  dcat:contactPoint <contact-iri> ;
  foaf:page <https://your-api/documentation> ;
  dcatap:hvdCategory <http://data.europa.eu/bna/c_4b74ea13> ;
  dct:license <.../licence/CC_BY_4_0> .

Option B — linked directly with dcat:servesDataset

<your-service-iri> a dcat:DataService ;
  dcat:servesDataset <your-dataset-iri> ;
  dcatap:applicableLegislation hvd-ir: ;
  dcat:endpointURL <https://your-api/service> ;
  dcat:contactPoint <contact-iri> ;
  foaf:page <https://your-api/documentation> ;
  dcatap:hvdCategory <http://data.europa.eu/bna/c_4b74ea13> ;
  dct:license <.../licence/CC_BY_4_0> .

The data service must be typed dcat:DataService and carry the applicable legislation itself. The endpoint URL, contact point, documentation page (foaf:page), HVD category and an open licence are mandatory checks: the API is still counted when they are missing, but each missing one is reported.

DCAT-AP — Distribution

Minimum to be included

<your-dataset-iri> dcat:distribution [
a dcat:Distribution ;
dcatap:applicableLegislation hvd-ir:
] .

Passes every distribution check

<your-dataset-iri> dcat:distribution [
  a dcat:Distribution ;
  dcatap:applicableLegislation hvd-ir: ;
  dct:title "Road network — national export"@en ;
  dcat:accessURL <https://your-portal/download-page> ;
  dcat:downloadURL <https://your-portal/files/road-network.gpkg> ;
  dct:license <.../licence/CC_BY_4_0>
] .

Without an access URL, or without a download URL and an HVD-tagged data service, the distribution is still included but fails a mandatory check. A missing licence is a mandatory issue. For a bulk download, a licence that is not CC BY 4.0 (…/licence/CC_BY_4_0) or CC0 (…/licence/CC0), or a licence mapped to one of them is a mandatory issue. Licences on the dataset or on a data service are not used for the distribution.

DCAT-AP — Dataset

:hvdDataset a dcat:Dataset; # PERSISTENT IDENTIFIER

  # Title in English
  dct:title "The population of bees"@en;

  # Description in English
  dct:description "This dataset provides … farmers in spring."@en; # or e.g. @en-t-es-t0-abcd

  # HVD implementing regulation
  dcatap:applicableLegislation <http://data.europa.eu/eli/reg_impl/2023/138/oj>;

  # The most granular HVD category, e.g. Nature preservation and biodiversity
  dcatap:hvdCategory <http://data.europa.eu/bna/c_b7f6a4f3>;

  # At least one HVD-compliant distribution: API and, where required, bulk download
  dcat:distribution :apiDistribution, :bulkDownload .

DCAT-AP — Distribution (bulk download)

:hvdDataset a dcat:Dataset;
  dcat:distribution :bulkDownload .

:bulkDownload a dcat:Distribution; # PERSISTENT IDENTIFIER

  # HVD implementing regulation
  dcatap:applicableLegislation <http://data.europa.eu/eli/reg_impl/2023/138/oj>;

  # Use the same URL for access and download
  dcat:accessURL <https://orgea.exampleMS.gov/files/1T2p3o4B.shp>; # PERSISTENT IDENTIFIER

  # Direct link to the downloadable file
  dcat:downloadURL <https://orgea.exampleMS.gov/files/1T2p3o4B.shp>; # PERSISTENT IDENTIFIER

  # CC BY 4.0, CC0 or an equivalent or less restrictive open licence
  dct:license <http://publications.europa.eu/resource/authority/licence/CC0> .

DCAT-AP — Distribution licence

The only place the report reads a distribution’s licence

<your-dataset-iri> dcat:distribution [
  a dcat:Distribution ;
  dcatap:applicableLegislation hvd-ir: ;
  dcat:accessURL <https://your-portal/download-page> ;
  dct:license <.../licence/CC_BY_4_0>
] .

Mapping a national licence so it counts as open

<your-licence> skos:exactMatch <.../licence/CC_BY_4_0> .

A licence on the dataset is not read. Open means CC BY 4.0 (…/licence/CC_BY_4_0) or CC0 (…/licence/CC0), or a licence mapped to one of them.

DCAT-AP — What the licence reports show

A standard licence: shown as its IRI

<your-distribution> dct:license <.../licence/CC_BY_4_0> .
# lic = …/licence/CC_BY_4_0 · skos and mapped are empty

A national licence with a mapping

<your-distribution> dct:license <https://your-portal/licences/national> .
<https://your-portal/licences/national> skos:exactMatch <.../licence/CC_BY_4_0> .
# lic = your licence IRI · skos = skos:exactMatch · mapped = …/licence/CC_BY_4_0

Licence names, identifiers and types (dct:title, dct:identifier, dct:type) are not harvested, so describing them on a dct:LicenseDocument does not change the report.

DCAT-AP — API fields

Passes every check, descriptive fields blank

<your-service-iri> a dcat:DataService ;
  dcatap:applicableLegislation hvd-ir: ;
  dcat:servesDataset <your-dataset-iri> ;
  dcat:endpointURL <https://your-api/service> ;
  dcat:contactPoint <contact-iri> ;
  foaf:page <https://your-api/documentation> ;
  dcatap:hvdCategory <http://data.europa.eu/bna/c_4b74ea13> ;
  dct:license <.../licence/CC_BY_4_0> .

Every shown field filled

<your-service-iri> a dcat:DataService ;
  dcatap:applicableLegislation hvd-ir: ;
  dcat:servesDataset <your-dataset-iri> ;
  dct:title "Road network API"@en ;
  dct:description "REST API serving the national road network."@en ;
  dcat:endpointDescription <https://your-api/openapi.json> ;
  dct:rights <https://your-api/terms> ;
  dcat:endpointURL <https://your-api/service> ;
  dcat:contactPoint <contact-iri> ;
  foaf:page <https://your-api/documentation> ;
  dcatap:hvdCategory <http://data.europa.eu/bna/c_4b74ea13> ;
  dct:license <.../licence/CC_BY_4_0> .

The description is shown but not checked. The English title and the endpoint description are mandatory checks (DCAT-AP HVD 3.0.1). The rights statement appears in the legal information report only, and does not count as a licence.

DCAT-AP — API licence

Option A — licence on the data service

<your-service-iri> a dcat:DataService ;
  dcatap:applicableLegislation hvd-ir: ;
  dcat:endpointURL <https://your-api/service> ;
  dct:license <.../licence/CC_BY_4_0> .

Option B — licence on the HVD-tagged distribution that points to it

<your-dataset-iri> dcat:distribution [
  a dcat:Distribution ;
  dcatap:applicableLegislation hvd-ir: ;
  dct:license <.../licence/CC0> ;
  dcat:accessService <your-service-iri>
] .
<your-service-iri> a dcat:DataService ;
  dcatap:applicableLegislation hvd-ir: .
# no dct:license of its own, so the distribution’s licence is used

When the data service has a licence of its own, only that licence is assessed. Open means CC BY 4.0 (…/licence/CC_BY_4_0) or CC0 (…/licence/CC0), or a licence mapped to one of them.

DCAT-AP — HVD category

Use a most detailed sub-category

<dataset> dcatap:hvdCategory <http://data.europa.eu/bna/c_4b74ea13> . # a most detailed Mobility sub-category
# A top-level theme such as Geospatial <http://data.europa.eu/bna/c_ac64a52d> passes
# the Category check but fails the Granular category check

DCAT-AP — Where the report reads licences

On the distribution

<your-dataset-iri> dcat:distribution [
  a dcat:Distribution ;
  dcatap:applicableLegislation hvd-ir: ;
  dcat:accessURL <https://your-portal/download-page> ;
  dct:license <.../licence/CC_BY_4_0>
] .

On the data service

<your-service-iri> a dcat:DataService ;
  dcatap:applicableLegislation hvd-ir: ;
  dcat:endpointURL <https://your-api/service> ;
  dct:license <.../licence/CC_BY_4_0> .

For a data service without its own licence: on its HVD-tagged distribution

<your-dataset-iri> dcat:distribution [
  a dcat:Distribution ;
  dcatap:applicableLegislation hvd-ir: ;
  dct:license <.../licence/CC0> ;
  dcat:accessService <your-service-iri>
] .

A licence on the dataset is not read, and dct:rights does not count as a licence. Open means CC BY 4.0 (…/licence/CC_BY_4_0) or CC0 (…/licence/CC0), or a licence mapped to one of them.

DCAT-AP — Licences that count as open

Use CC BY 4.0 or CC0 directly

<distribution> dct:license
<http://publications.europa.eu/resource/authority/licence/CC_BY_4_0> .
<distribution> dct:license
<http://publications.europa.eu/resource/authority/licence/CC0> .

Or map a national licence to one of them

<your-licence> skos:exactMatch
<http://publications.europa.eu/resource/authority/licence/CC_BY_4_0> .
# skos:narrowMatch, skos:broadMatch, skos:closeMatch, owl:sameAs
# and rdfs:seeAlso are accepted as well

DCAT-AP — INSPIRE datasets

Map an OGC service to dcat:DataService

# OGC endpoint → dcat:endpointURL (mandatory check)
<service> dcat:endpointURL <https://your-service?SERVICE=WFS> .
# Documentation and quality-of-service page → foaf:page (mandatory check)
<service> foaf:page <https://your-service/documentation> .
# GetCapabilities URL → dcat:endpointDescription (mandatory check)
<service> dcat:endpointDescription
<https://your-service?SERVICE=WFS&REQUEST=GetCapabilities> .