How to download WEkEO data?

Let's see how we can download WEkEO data from the Data Viewer and by script via the HDA API.

David Bina avatar
Written by David Bina
Updated over a week ago

Context


The WEkEO DIAS allows users to visualize and download data from the Data Viewer for free. All you need to do is to create a WEkEO account.

The WEkEO catalog centralizes datasets coming from different services that can be downloaded via two methods: from the data viewer directly or via the Harmonized Data Acces (HDA) API in a script.

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.

When you first arrive on the page, two layers are already displayed: the Copernicus Land normalized difference vegetation index product (1) and Copernicus Marine sea water velocity (2):

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:

For example, if you use the filters and select CLMS (Land) in the Copernicus Service section and Global in the Area section, you will find quickly by scrolling the dataset we choose for the purpose of this article and add it to the map:

๐Ÿ“Œ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.

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๐Ÿ‘๏ธโ€๐Ÿ—จ๏ธ.

Step 3. Define your subsetting parameters

Click on the download icon to develop the canvas (1) where you can play with different parameters depending on the dataset (2), mainly:

  • the bounding box coordinates (when available)

  • the variables (when available)

  • the time range

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

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 by clicking on Monitor request or on Jobs directly:

๐Ÿ“Œ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 your data ๐Ÿ˜Š

โš ๏ธThe Jobs tab displays all the jobs made with the HDA API (cf. next section) which are deleted every 7 days, so be sure to download all data you need before they are removed.

Download data via the HDA API


Copy your query

From the Data Viewer, you can get the query in the Layers window and in the Jobs window by clicking on Show API request button (1) (cf. step 3) and then on the Copy button(2):

Layers window:

Jobs window:

๐Ÿ’ก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

WEkEO users can also retrieve data using programmatic approaches, by consuming the Harmonized Data Access (HDA) API, that enables to uniform access to the whole WEkEO Catalogue, including subsetting and downloading functionalities:

hda Python package

You can use a dedicated Python Client distributed via the hda package:

REST API

You can use directly the HDA REST API by sending https requests with your favorite tools:

What's next?


If you have trouble to download data from the Copernicus Marine service, please check this article: How to get Copernicus Marine Data hosted on WEkEO?

Feel free to check these articles that might be of interest for you:

We are user-driven and we implement users' suggestions, so feel free to contact us:

  • through a chat session available in the bottom right corner of the page

  • via e-mail to our support team (supportATwekeo.eu)

Did this answer your question?