INSPIRE registry service release 6.3 - Documentation

 

Index

  1. Introduction
  2. Version detail
  3. Accessing the INSPIRE registry
  4. Search interface

 

Acknowledgements

The INSPIRE registry is based on the Re3gistry software, which is being developed by the Are3NA project[1] as part of the Interoperability Solutions for European Public Administrations (ISA) Programme [2]. ARe3NA aims at establishing a Reusable INSPIRE Reference Platform, which is identifying and developing common components for the successful implementation of the INSPIRE Directive. To further address these interoperability issues and provide support to the Member States, the platform will provide guidance, collaboration, sharing of best practices and approaches and a reference implementation of common components.

This service has been developed by the ISA founded developers Daniele Francioli and Emanuela Epure.

We are also grateful for the review of this document by Robin S. Smith.

 

http://ec.europa.eu/isa/actions/01-trusted-information-exchange/1-17action_en.htm
https://joinup.ec.europa.eu/community/are3na/description
Re3gistry software https://joinup.ec.europa.eu/software/re3gistry/home
INSPIRE registry service http://inspire.ec.europa.eu/registry/

 

To provide feedback on the software/service we kindly invite you to use this service: https://joinup.ec.europa.eu/software/re3gistry/home

 

Contact information

Michael Lutz

European Commission – Joint Research Centre

Institute for Environment and Sustainability

Spatial Data Infrastructures Unit

E-mail: inspire-registry-dev@jrc.ec.europa.eu

http://ies.jrc.ec.europa.eu

http://www.jrc.ec.europa.eu

 

1 Introduction

The INSPIRE infrastructure involves a number of items, which require clear descriptions and the possibility to be referenced through unique identifiers. Examples for such items include INSPIRE themes, code lists, application schemas or discovery services. Registers provide a means to assign identifiers to items and their labels, definitions, descriptions (in different languages) as well as potentially other item-specific properties. The INSPIRE registry provides a central access point to a number of centrally managed INSPIRE registers. The content of these registers are based on the INSPIRE Directive, Implementing Rules and Technical Guidelines.

Currently, the INSPIRE registry contains the following registers:

  • INSPIRE Theme register: names, definitions (from the INSPIRE Directive) and descriptions (based on the Data Specifications Technical Guidelines)
  • INSPIRE Application Schema register: labels and definitions of the INSPIRE application schemas.
  • INSPIRE Code List register: labels, definitions, descriptions and extensibility of the code lists and their values, as included in the Implementing Rules on interoperability of spatial data sets and services. The code list register does not yet include references to external vocabularies or the extensions proposed in the Data Specifications Technical Guidelines. These will be added at a later stage.
  • INSPIRE Metadata Code List register: contains the code lists and their values, as defined in the INSPIRE implementing rules on metadata (Commission Regulation (EC) No 1205/2008).
  • INSPIRE Reference Document register: provides unique identifiers for documents used in INSPIRE, including the INSPIRE legal acts, technical guidelines and other documents (e.g. documents containing code list values for externally managed INSPIRE code lists).
  • INSPIRE Feature Concept Dictionary: acts as a common feature concept dictionary for all INSPIRE data specifications. The common feature concept dictionary contains terms and definitions required for specifying thematic spatial object types and it is main role is in particular to support the harmonisation effort and to identify conflicts between the specifications of the spatial object types in the different themes.
  • INSPIRE Glossary register: contains general terms and definitions that specify the common terminology used in the INSPIRE Directive and in the INSPIRE Implementing Rules documents. The glossary supports the use of a consistent language in different documents when referring to the terms.
  • INSPIRE Enumeration register:
  • INSPIRE Layer register:

 

2 Version details

This is the release 6.3 of the INSPIRE registry service. Changes for this version:

The service has been created using the Re3gistry software v1.2.

 

3 Accessing the registry

All the resources available in the INSPIRE registry can be accessed in a number of formats, currently:

Encoding 1 - Available formats in the INSPIRE registry r6.3

  • HTML
  • XML Re3gistry
  • XML ISO 19135 (beta)
  • ATOM
  • JSON
  • XML/RDF (beta)
  • CSV (beta)

The content of the registers is available in the following languages. Since the translations are taken from the official translations of the INSPIRE legal acts, some properties of an item (those that are based on the content of the Technical Guidelines) are currently only available in English.

Encoding 2 - Available languages of the content

  • Bulgarian - bg
  • Czech - cz
  • Danish - da
  • German - de
  • Greek - el
  • Spanish - es
  • Estonian - et
  • English - en
  • Finnish - fi
  • French - fr
  • Croatian - hr
  • Hungarian - hu
  • Italian - it
  • Lithuanian - lt
  • Latvian - lv
  • Maltese - mt
  • Dutch - nl
  • Polish - pl
  • Portuguese - pt
  • Romanian - ro
  • Slovak - sk
  • Slovenian - sl
  • Swedish - sv

3.1 Recommendation/convention for the URI path for the INSPIRE Registry

URI Register

– base_uri + “/” + register_uriname

– Example: http://inspire.ec.europa.eu/codelist

URI Items:

– base_uri + “/” + item_itemclass + “/” + item_uriname

– Example: http://inspire.ec.europa.eu/applicationschema/act-core/

URI Collection:

– base_uri + “/” + collection_itemclass + “/” + collection_uriname + “/” + item_uriname

– Example: http://inspire.ec.europa.eu/codelist/ActiveWellTypeValue/decontamination/

By default, the register content is provided based on the preferred language and format indicated in the request (e.g. the HTTP GET request issued by the browser). If you want to access a register item in a particular format or language you can use one of the following approaches:

3.2 Directly accessing an item

To directly access an item in a specific language and format, use the following naming convention:

  1. To access the register http://base_uri/{register_uriname}/{register_uriname}.{language_code}.{format}
  2. To access the register item http://base_uri/{itme_itemclass}/[{item_uriname}]/{item_uriname}.{ language_code}.{format}
  3. To access a collection http://base_uri/{collection_itemclass}/[{colelction_uriname}]/[{item_uriname}]/{item_uriname}.{ language_code}.{format}

the "language_code" and "format" are the codes in bold in the previous lists.

Examples:

Encoding 3 - Examples of direct accessing an item

From the HTML interface you can easily access a specific format using the icon placed after the item’s metadata (see Figure 1 below).

3.3 Accessing an item using content negotiation

To access an item using content negotiation, add to the HTTP request the format and language header. Some examples are listed below:

Examples:

Encoding 4 - Examples  of accessing an item using content negotiation

Below you can find all the supported format and their relative http header

Encoding 5 - Supported formats and their relative http header

  • ATOM: application/atom+xml
  • HTML: text/html
  • XML Re3gistry: application/xml
  • XML ISO 19135 (beta): application/x-iso19135+xml
  • JSON: application/json
  • XML/RDF (beta): application/xml
  • CSV (beta): text/csv

3.4 Web interface

The web interface show all the information in a user friendly way; you can filter the elements available in the register by simply typing the word to be used as filter in the filter text box. You can also use regular expression in each of the filter available. A n example of filter using regular expression are provided below:

Examples:

  • european|international - finds all the string containing "european" or/and "international"
  • [a-f] - finds all the string containing characther from "a" to "z"
  • ^((?!invalid).)*$ : finds all except the string "invalid"


More than one column can be filtered at the same time.
The filters are case insensitive.

Using the web interface you can also easily access to the other formats available.

 

4.Search interface

 

The search interface allow you to search within all the elements contained in the INSPIRE Registry service.

This searching system is localized and searches the keywords in the current selected language. It offers also the useful autocomplete feature.

Search fields: label, description, definition.