Context

The WEkEO DIAS provides Earth Observation datasets coming from many different services (see all data accessible in the WEkEO catalogue) and allows all users to download data for free. All you need to do is to create a WEkEO account.

Users can download WEkEO data via two methods: directly from the Data viewer or using the Harmonized Data Acces (HDA) API programmatically, in Python via the hda package or via the HDA REST API.

Without any further ado, let's dive into both method! 💪

Download data from the Data Viewer

Step 1. Open the Data Viewer

You can access the Data Viewer by clicking on DATA from the WEkEO menu.

By default, two layers are already displayed: (1) the Copernicus Land normalised Difference Vegetation Index and (2) the Copernicus Marine sea water salinity:

Step 2. Add the datasets to the map

Add the datasets you want to download by clicking on the "+" icon in the Layers tab.

It will open the WEkEO Catalogue where you can use filters on the left to find datasets more easily:

Access more than 400 Earth Observation data from the WEkEO catalogue.

For example, if we select CLMS (Land) in the Copernicus Service section and Global in the Area section, we can quickly find the dataset we'll choose for the purpose of this article, the Global 10-daily Fraction of Absorbed PAR 333m and add it to the map:

The layer of this dataset has now been added in the Layers panel and displayed automatically on the map.

💡WEkEO Pro Tip: you can hide/show layers by clicking on the eye icon👁️‍🗨️.

📌Note: a dataset from the Catalogue will be added directly to the map while a product will show all the datasets it contains. You can then choose the dataset(s) of the product you want to display. The number of displayable datasets is shown by the icon next to the product/dataset name.

Step 3. Define your subsetting parameters

Click on the download icon to develop the canvas:

where you can (2) define different parameters depending on the dataset, mainly:

the bounding box coordinates (when available)
the variables (when available)
the time range

You just have to (3) click on Request data to launch your request:

Download data easily from the WEkEO Data Viewer.

💡WEkEO Pro Tip: you can draw an Area Of Interest (bottom right) on the map and click on Copy AOI from map to specify the bounding box coordinates. You can do the same for the time range, by picking a date from the bottom timeline and click on Copy from layer.

Step 4. Download the data

Once you clicked on Request data, a job or several jobs depending on your request are launched. You can see them in the Jobs tab:

📌Note: as you will see with time, the Jobs tab shows the history of all your previous requests. You can delete them with the cross icon.

Once the jobs are done, you can download them by clicking on Order:

And voilàààà!

You have downloaded data from the WEkEO Data Viewer😊

Download data via the HDA API

WEkEO users can also download data via a programming approach, by consuming the Harmonized Data Access (HDA) API, that enables a uniform access to the whole WEkEO catalogue, including subsetting and downloading functionalities.

Even if you are not downloading data from the Viewer with this method, we highly recommend to first copy your query from the Viewer to be sure no error was introduced.

Copy your query

From the Data Viewer, you can get your query from the Layers or Jobs tabs (1) by clicking on Show API request(s) or the </> icon respectively, then (2) on Copy:

From Layers:

From Jobs:

💡WEkEO Pro Tip: this is the query you can paste in your message to the WEkEO Support when you are encountering some issues.

Consume the HDA API

Once you copied your query, there are several ways to download data programmatically, either via the hda Python package, or via the HDA REST API: