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:
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:
💡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:
hda Python package
🔍 You can use a dedicated Python Client distributed via the hda package in Python, which can also be accessed from R:
HDA REST API
🔍 You can use the HDA REST API by sending https requests with your favorite tools:
Wget: coming soon
What's next?
Feel free to check these articles that might be of interest for you to download WEkEO data:
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 our contact webpage
via e-mail to our support team (supportATwekeo.eu)
Regardless of how you choose to contact us, you will first be put in touch with our AI Agent Neo. At any time, you can reach a member of the WEkEO User Support team by clicking on "talk to a person" via chat, or by naturally requesting it in reply to Neo's email.