How to create a Thematic Application

Where are Apps stored ?

Thematic applications are stored as atom feed in Terradue catalogue (e.g https://catalog.terradue.com//hydro-apps/search?format=atom&uid=globalapp).

How is organized an App ?

An app is using the OWS Context format, adapted for the purpose of the Thematic Applications. It contains the following parts:

Identifier: Unique identifier of the app

Title: Title of the app

Summary: Description of the app

Icon: Url to icon of the app

Authors: List of authors of the app

Categories

  • Keywords: List of keywords associated to the app
    <category term="keyword" label="Geohazards" />

  • App status: App status (e.g “Prototype”, “Under development”, …) displayed in the thematic app list
    <category term="appstatus" label="Under development" />

  • App type: App type (e.g “Products”, “Service”, …) displayed in the thematic app list
    <category term="apptype" label="Service" />

Offerings

  • Search result tab: Offering present if the app contains the search functionality
    <owc:offering xmlns:owc="http://www.opengis.net/owc/1.0" code="http://www.terradue.com/spec/owc/1.0/req/atom/opensearchtable" />

  • Feature basket tab: Offering present if the app contains the feature basket tab
    <owc:offering xmlns:owc="http://www.opengis.net/owc/1.0" code="http://www.terradue.com/spec/owc/1.0/req/atom/featuresbasket"><owc:operation code="Description" href="file:///t2api/data/package/default/description" method="GET" type="application/opensearchdescription+xml" /></owc:offering>

  • Data package tab: Offering present if the app contains the data package tab
    <owc:offering xmlns:owc="http://www.opengis.net/owc/1.0" code="http://www.terradue.com/spec/owc/1.0/req/atom/datapackage"><owc:operation code="Search" href="file:///t2api/data/package/search?format=json" method="GET" type="application/json" /></owc:offering>

  • Wps services tab: Offering present if the app contains the WPS Services tab
    <owc:offering xmlns:owc="http://www.opengis.net/owc/1.0" code="http://www.opengis.net/spec/owc/1.0/req/atom/wps"><owc:operation code="ListProcess" href="file:///t2api/service/wps/search?domain=esa&tag=gep,stemp" method="GET" type="application/json" /></owc:offering>

  • Store Upload:
    <owc:offering xmlns:owc="http://www.opengis.net/owc/1.0" code="http://www.terradue.com/spec/owc/1.0/req/atom/storeupload"><owc:operation code="Search" href="https://www.terradue.com/" method="GET" type="application/opensearchdescription+xml"><datacontext xmlns="http://www.terradue.com">My Repository/Results</datacontext></owc:operation></owc:offering>

  • Data contexts: List of data contexts (data collections) available in the app
    <owc:offering xmlns:owc="http://www.opengis.net/owc/1.0" code="http://www.terradue.com/spec/owc/1.0/req/atom/datacontext"><owc:styleSet default="true"><owc:name>EO Data/Landsat-8</owc:name><owc:title>Default Data Collections</owc:title><owc:abstract>Landsat-8 collection</owc:abstract><owc:legendURL href="http://www.terradue.com/images/logo-t2.png" /></owc:styleSet></owc:offering>
    <owc:offering xmlns:owc="http://www.opengis.net/owc/1.0" code="http://www.terradue.com/spec/owc/1.0/req/atom/opensearch"><owc:operation code="DescribeDataset" href="https://catalog.terradue.com/landsat8/description" method="GET" type="application/opensearchdescription+xml"><datacontext xmlns="http://www.terradue.com">EO Data/Landsat-8</datacontext></owc:operation></owc:offering>

  • Base Maps: List of background map available in the app
    <owc:offering xmlns:owc="http://www.opengis.net/owc/1.0" code="http://www.terradue.com/spec/owc/1.0/req/atom/basemaps"><owc:styleSet default="true"><owc:name>Default</owc:name><owc:abstract>Default map</owc:abstract><type xmlns="http://www.terradue.com">mapbox</type><owc:content>tepgeohazards.l6mdm2gn</owc:content></owc:styleSet></owc:offering>

  • Layers (wms): List of map layers available in the app
    <owc:offering xmlns:owc="http://www.opengis.net/owc/1.0" code="http://www.terradue.com/spec/owc/1.0/req/atom/mapfeatures"><owc:styleSet default="false"><owc:name>ESA_UTEP:GlobalTimeScan2015_30_RGB_01_11_08</owc:name><owc:title>TimeScan-Landsat-2015 (RGB: max-NDBI, max-NDVI, mean-MNDWI)</owc:title><owc:abstract>TimeScan-Landsat-2015 (RGB: max-NDBI, max-NDVI, mean-MNDWI)</owc:abstract><type xmlns="http://www.terradue.com">wms</type><attribution xmlns="http://www.terradue.com">&copy; DLR - for licensing and data orders please go to http://www.dlr.de/</attribution><owc:opacity xmlns:owc="http://www.opengis.net/owc/1.0">0.5</owc:opacity><owc:transparent xmlns:owc="http://www.opengis.net/owc/1.0">true</owc:transparent><owc:content href="https://utep.it4i.cz/geoserver/gwc/service/wms" type="image/png" /></owc:styleSet></owc:offering>

Start/End date: Start and End dates associated to the app

Geometry: WKT associated to the app
<spatial xmlns="http://purl.org/dc/terms/">POLYGON((-21.797 34.597,52.383 34.597,52.383 62.593,-21.797 62.593,-21.797 34.597))</spatial>

How to save an App ?

Save first your app as an atom file (e.g globalapp-app.atom)

curl -u <username>:<apikey> -XPOST -H "Content-Type: application/atom+xml" -H "Accept: application/xml" -d@globalapp-app.atom "https://catalog.terradue.com/<index>/"

If an app with the same identifier exists in the <index> index of the catalogue, it will be overwritten with the new content.

How to associate an App to a community ?

In the community management tab, insert the opensearch link which returns the App or a list of Apps.
Apps can be filtered using series (e.g https://catalog.terradue.com//hydro-apps/series/search?q=esa).

Create an App using the Editor tool

On the TEPs platforms, as starter or explorer user, I have access in the Thematic app discovery page to a button “Create new app” which directs the user to the App editor page (e.g https://geohazards-tep-ref.terradue.com/#!apps).
From this link, a user can create his own private thematic app. Administrators can use this to create apps also for other indexes.