SesamEO

SesamEO - Access Anything

SesamEO gives you access to multiple Earth Observation and dataset sources in one place. | It acts as a bridge to access data served by different providers. SesamEO dynamically connects to providers so you can take benefits of real time updated data.

This guide aims to help you navigate the service’s features and maximize its potential.

If you have any questions dont’ hesitate to email us https://platform.destine.eu/support

Overview

With SesamEO you can easily browse, select, visualise and download the data you are looking for.
The main focus is on Earth observation data, but it also supports other types of information such as European statistics, atmospheric data, or climate data.

The data are represented by products, which are grouped into themes and collections to give you easy access to them.
To facilitate the search, SesamEO allows you to filter, preview and select your data like your favourite search engine.

Collections are automatically discovered from the online catalogues so called providers or can also be created by administrators.
The architecture of SesamEO is designed to easily add new data providers.

The providers currently supported are:

**DestinE Data Lake** : the official DestinE Data Portfolio of the DestinE platform.
**CDSE** : which gives access to a wide range of data and services from the Copernicus Sentinel missions.
**EUROSTAT** : Eurostat provides a vast collection of datasets covering various aspects of the European Union’s economic, social, and environmental landscape.

The following section will dive into the different features available to you within our service.

Home page
Collections
Browse Collection
Providers
API Key

Exploring SesamEO interfaces

Home page

Home displays the set of popular collections such as Sentinel, Forecats or Eurostat.

It provides a search engine to filter collections by keywords.
Example of keyword search.

Collections

This section lists all the Collections available on SesamEO.

For each collection, you can click:

‘More info’ to read a detailed description of each collection.
or ‘Browse’ to start exploring the specific products within that collection.

Browse Collection

When you browse a collection, you have access to a list of filter parameters. If the collection is available from more than one provider, you can choose the provider first.

The filter parameters are set by the provider and/or completed by SesamEO administrators. If there are several providers, the filter parameters are displayed in accordance with the currently selected source.

The products resulting from the research are presented per page of fifty.

If the products have geographic coordinates, you can define a spatial filter by drawing a polygon representing your area of interest.

Then, for each product, you can explore its content and download it.

Warning

To perform operations, such as browsing or downloading, depending on the provider, it may be necessary to have credentials, which can be entered in Providers screen.

Providers

List all Providers available in SesamEO.

For each of these providers you can access the configuration screen. It displays information about the service provider, such as the link to the service provider’s website.

If certain operations require identifiers, they will be listed in “Operations requiring credentials.”

In addition, the form to complete the identifiers is displayed. These credentials will be used exclusively for the currently logged in user, no one else will be able to access or use these credentials.

For example, to download product from the CDSE provider, you need to enter your credentials (login and password)

In addition, the form to complete the identifiers is displayed. These credentials will be used exclusively for the currently logged in user, no one else will be able to access or use these credentials.

API Key

You can generate an API key in ‘My SesameEO Account’

You can generate an API Key, this key can have an expiration date, by default it never expires. If an expiration date is indicated, this date is excluded from the validity period. The key will no longer be valid from this date at 00:00.

This api KEY is a token that a client provides when making API calls. The key must be sent in the request header.

Example of a curl request to download a product:

$ curl --location 'https://api.sesameo.destine.eu/odata/v1/Collections('\''EO.ESA.DAT.SENTINEL-5P.TROPOMI.L2'\'')/Products('\''CDSE:0d787d85-797a-4d53-97ba-fcd79d4b6c4d'\'')/Links('\''DownloadLink'\'')/$value' --header 'X-API-KEY: aa5bca5924f8a3ef885b4d48d26bc94b' --output S2.zip

To get the download url of a product, you can use the button copy link, the fourth button from the top on the right side of the product.

If you use curl, do not forget to escape the ‘ characters with ‘\'’.

Here is an example of filters to retrieve a list of products from the collection ‘EO.ESA.DAT.SENTINEL-2.MSI.L2A’ with a cloud coverage less than 49 on provider ‘CDSE’

$ curl --location 'https://api.sesameo.destine.eu/odata/v1/Collections('\''EO.ESA.DAT.SENTINEL-2.MSI.L2A'\'')/Products?%24expand=Attributes&%24filter=(Attributes%2FOData.CSC.IntegerAttribute%2Fany(att%3Aatt%2FName%20eq%20%27cloudCover%27%20and%20att%2FOData.CSC.IntegerAttribute%2FValue%20le%2049))%20and%20Provider%20eq%20%27CDSE%27'  --header 'X-API-KEY: aa5bca5924f8a3ef885b4d48d26bc94b'

And below an example of filters based on the ContentDate/Start parameter : from 2024-03-16 to 2024-03-18 (include)

$ curl --location 'https://api.sesameo.destine.eu/odata/v1/Collections('\''EO.ESA.DAT.SENTINEL-2.MSI.L2A'\'')/Products?%24expand=Attributes&%24filter=(ContentDate%2FStart%20ge%202024-03-16T00%3A00%3A00.000Z%20and%20ContentDate%2FStart%20lt%202024-03-18T23%3A59%3A59.999Z)%20and%20Provider%20eq%20%27CDSE%27'  --header 'X-API-KEY: aa5bca5924f8a3ef885b4d48d26bc94b'

User quotas

SesamEO does not apply default quotas. User quotas only depend on the quotas applied by the different providers.