[RDF data]
eenvplus Logo
Co-founded by the Community Programme CIP‐ICT‐PSP grant No.325232
naturesdi Logo
Co-founded by the Community Programme ECP-2007-GEO-317007
european flag

LusTRE: Linked Thesaurus fRamework for Environment

Running at http://linkeddata.ge.imati.cnr.it/

..::LusTRE-ES: Services available in LusTRE::..

This page documents the services to exploit the thesaurus framework.

Service Name Description & Parameters Response Usage examples & JSON response
GetSuggestion Description.

The purpose of the GetSuggestions operation is to suggest matching thesauri concepts upon receipt of a lexical keyword or a part a lexical keyword.

Parameters.

  • keyword (String - Mandatory) - The keyword (or part of a keyword) as search criteria.
  • maxCount (Integer) - Maximum number of results to be returned (default = 100).
  • thesauri (String) - The thesauri data source to be searched. This parameter enables the limitation of the query target to only specific thesauri (All thesauri would be targeted, if not specified).
  • service (String) - The specific service modules to be used by this request. The parameter value can be a comma-separated list of service modules.
  • languages (String) - The targeting natural language of the query. This parameter enables the limitation of the query to target only the thesauri concepts in the enlisted languages. The parameter value can be a list of comma-separated language codes based on the ISO-639-1 standard (All available languages would be targeted, if not specified).
  • cross-walking(Boolean) - Default is false. With active cross-walking LusTRE-ES will take into account the concept URI. Concepts linked by skos:exactMatch are considered the same concept. This concept will be contained in the response only once using the label from the thesaurus with highest rank.
  • source(Boolean) - Default is false, when true: result contains thesaurus source.
  • extraParams (String) - Placeholder foreseen for the additional extra parameters, in case they are defined by a service module. The value should be a list of comma-separated key/value pairs. The key/values must be delimited using a “:” character. Syntax: extraParams=param1:value1,param2:value2

The response is a compound JSON object which comprises the URI of a thesaurus concept, the prefLabel of the concept as title, and the language of the prefLabel. Click on the link: http://linkeddata.ge.imati.cnr.it/tfes/rest/GetSuggestions?keyword=geology&maxCount=10&languages=en
GetCapabilities Description.

TThe GetCapabilities operation is the starting point for every client to gather the basic service informa- tion as well as a capabilities catalog which could be used as a guide to the available operations and resources.

No Parameters.
The encoding of the response is JSON. Click on the link: http://linkeddata.ge.imati.cnr.it/tfes/rest/GetCapabilities
DescribeConcept Description.

The purpose of the DescribeConcept operation is to retrieve the full SKOS concept record based on a concept URI.

Parameters.

  • concept (String - Mandatory) - A thesaurus concept URI as search criteria.
  • thesauri (String) - The thesauri data source to be searched. This parameter enables the limitation of the query target to only specific thesauri (All thesauri would be targeted, if not specified).
  • service (String) - The specific service modules to be used by this request. The parameter value can be a comma-separated list of service modules.
  • languages (String) -The targeting natural language of the query. This parameter enables the limitation of the query to target only the thesauri concepts in the enlisted languages. The parameter value can be a list of comma-separated language codes based on the ISO-639-1 standard (All available languages would be targeted, if not specified).
  • cross-walking (Boolean) - Default is false, when true: also properties of concepts related by skos:exactMatch will additionally be returned.
  • source (Boolean) - Default is false, when true: result contains thesaurus source.
  • extraParams (String) - Placeholder foreseen for the additional extra parameters, in case they are defined by a service module. The value should be a list of comma-separated key/value pairs. The key/values must be delimited using a “:” character. Syntax: extraParams=param1:value1,param2:value2

The content of the response of a DescribeConcept request would be a SKOS object encoded in SPARQL 1.1 Query Results JSON Format. Click on the link: http://linkeddata.ge.imati.cnr.it/tfes/rest/DescribeConcept?concept=http://linkeddata.ge.imati.cnr.it/resource/EARTh/100230
GetSynonyms Description.

The purpose of the GetSynonyms operation is to query the TF for all the concepts which are considered to be synonyms to the input thesauri concept.

Parameters.

  • concept (String - Mandatory) - A thesaurus concept URI as search criteria.
  • maxCount (Integer) - Maximum number of results to be returned (default = 100).
  • thesauri (String) - The thesauri data source to be searched. This parameter enables the limitation the query target to only specific thesauri (All thesauri would be targeted, if not specified).
  • service (String) -The specific service modules to be used by this request. The parameter value can be a comma-separated list of service modules.
  • languages (String) - The targeting natural language of the query. This parameter enables the limitation of the query to target only the thesauri concepts in the enlisted languages. The parameter value can be a list of comma-separated language codes based on the ISO-639-1 standard (All available languages would be targeted, if not specified).
  • cross-walking(Boolean) - Default is false, when true: also properties of concepts related by skos:exactMatch will additionally be returned.
  • source (Boolean) - Default is false, when true: result contains thesaurus source.
  • extraParams (String) - Placeholder foreseen for the additional extra parameters, in case they are defined by a service module. The value should be a list of comma-separated key/value pairs. The key/values must be delimited using a “:” character. Syntax: extraParams=param1:value1,param2:value2
The contents of the response of a GetSynonyms is encoded in JSON Format. Click on the link:
GetRelatives Description.

The purpose of the GetRelatives operation is to query the TF for all the concepts that are considered related to the input thesauri concept.

Parameters.

  • concept (String - Mandatory) - A thesaurus concept URI as search criteria.
  • maxCount (Integer) - Maximum number of results to be returned (default = 100).
  • thesauri (String) - The thesauri data source to be searched. This parameter enables the limitation the query target to only specific thesauri (All thesauri would be targeted, if not specified).
  • service (String) -The specific service modules to be used by this request. The parameter value can be a comma-separated list of service modules.
  • languages (String) - The targeting natural language of the query. This parameter enables the limitation of the query to target only the thesauri concepts in the enlisted languages. The parameter value can be a list of comma-separated language codes based on the ISO-639-1 standard (All available languages would be targeted, if not specified).
  • cross-walking(Boolean) - Default is false, when true: also properties of concepts related by skos:exactMatch will additionally be returned.
  • source (Boolean) - Default is false, when true: result contains thesaurus source.
  • extraParams (String) - Placeholder foreseen for the additional extra parameters, in case they are defined by a service module. The value should be a list of comma-separated key/value pairs. The key/values must be delimited using a “:” character. Syntax: extraParams=param1:value1,param2:value2

The contents of the response of a GetRelatives request would be a compound JSON object. Click on the link:
ResolveThesaurus Description.

The purpose of the ResolveThesaurus operation is to retrieve information about the originating thesaurus of a keyword represented with its concept URI.

Parameters.

  • concept (String - Mandatory) - A thesaurus concept URI as search criteria.

The contents of the response of a ResolveThesaurus request would be a compound JSON object. Click on the link:
Visualization Description.

The visualization operation is intended to collect and prepare all kinds of related keyword concepts to a given focus concept as input for a graphical, illustrative representation identified as cluster visualization, implemented using the D3 JavaScript library. For a given focus concept, this operation retrieves some semantic information, interlinking information, as well as information about its surrounding concepts in the conceptual space described by the interlinked KOS.

  • concept (String ) - Concept-URI of the queried concept.
  • language (String) - Language of queried concept based on ISO-639-1.
  • k (Number) - The maximum number of steps (concept relationships to follow) that the other keyword concepts are away from the focus concept. k directly influences the depth of search and the amount of keywords visualized at the same time.
The contents of the response of a visualization of information associated to the focus concept. Click on the link:
GetTopMostConcepts Description.

The purpose of the GetTopMostConcepts operation is to query the framework for all the top most concepts of a specific Thesaurus or set of thesauri.

  • thesauri (String ) - The thesauri data source to be searched. This parameter enables the limitation the query target to only specific thesauri (All thesauri would be targeted, if not specified). The thesauri is indicated providing the associated conceptScheme .
  • service (String) - The specific service modules to be used by this request. The parameter value can be a comma-separated list of service modules.
  • languages (String) - The targeting natural language of the query. This parameter enables the limitation of the query to target only the thesauri concepts in the enlisted languages. The parameter value can be a list of comma-separated language codes based on the ISO-639-1 standard (All available languages would be targeted, if not specified).
  • extraParams (String) - Placeholder foreseen for the additional extra parameters, in case they are defined by a service module. The value should be a list of comma-separated key/value pairs. The key/values must be delimited using a “:” character. Syntax: extraParams=param1:value1,param2:value2
The contents of the response of a GetTopMostConcepts request would be a compound JSON object. Click on the link:

More information about the service specification are available in the project eENVplus deliverable: "D4.2: Thesaurus exploitation services specification".

The Thesaurus Framework exploitation services are the result of a close cooperation between the two eENVplus partners CNR-IMATI and disy. Service have been jointly designed and developed by disy.

For any questions please contact the LuSTRE team services: lustre-services@ge.imati.cnr.it