Skip to content

Latest commit

 

History

History
97 lines (74 loc) · 3.22 KB

README.md

File metadata and controls

97 lines (74 loc) · 3.22 KB
Raw

#LIMES-Service

A web service for LIMES: LInk discovery framework for MEtric Spaces.

This Project implemented LIMES and provides a REST API for discovering LINKS in the Web of Data.

Documentation of LIMES can be found in its repository.

This Web service is used in the GeoKnow Generator Workbench.

##Building

From the LDStack Debian repository

From source code

You can create the war file using mvn package. And you can deploy the .war file in a servlet container.

To avoid running tests use -DskipTests parameter.

##REST Services

Path Method Accept Produces Description
\ POST application/xml application/json application/json executes a LIMES with configuration passed in the payload
\{uuid} GET Reads the content of a TAB file generated in the LIMES process

XML Congiguration

The services accepts LIMES XML files as defined in their configuration. It is validated with a DTD document.

JSON Configuration

An example of JSON configuration file is presented here after. Most of the parametres are for LIMES to process, other parameters like saveendpoint, reviewgraph, acceptgraph are for the Service to save results into a accessible endpoint/graphs.

{
    "execution": "Simple",
    "output": "N3",
    "metric": "hausdorff(x.polygon, y.polygon)",
    "saveendpoint": "http://endpoint/to/save/results",
    "reviewgraph": "http://graph/to/save/review/results",
    "acceptgraph": "http://graph/to/save/accepted/results",
    "uribase": "http://generator.geoknow.eu/resource/",
    "prefix": [
        {
            "label": "geom",
            "namespace": "http://geovocab.org/geometry#"
        },
        {
            "label": "geos",
            "namespace": "http://www.opengis.net/ont/geosparql#"
        },
        {
            "label": "lgdo",
            "namespace": "http://linkedgeodata.org/ontology/"
        }
    ],
    "source": {
        "id": "linkedgeodata",
        "endpoint": "http://linkedgeodata.org/sparql",
        "var": "?x",
        "pagesize": "2000",
        "restriction": "?x a lgdo:RelayBox",
        "property": [
            "geom:geometry/geos:asWKT RENAME polygon"
        ]
    },
    "target": {
        "id": "linkedgeodata",
        "endpoint": "http://linkedgeodata.org/sparql",
        "var": "?y",
        "pagesize": "2000",
        "restriction": "?y a lgdo:RelayBox",
        "property": [
            "geom:geometry/geos:asWKT RENAME polygon"
        ]
    },
    "acceptance": {
        "threshold": "0.9",
        "relation": "lgdo:near",
        "file": "lgd_relaybox_verynear.nt"
    },
    "review": {
        "threshold": "0.5",
        "relation": "lgdo:near",
        "file": "lgd_relaybox_near.nt"
    }
}

##Licence

The source code of this repo is published under the Apache License Version 2.0