.. _providers:



Featured providers
##################

``eodag`` connects you to a variety of Earth Observation (EO) data providers.
This section introduces the featured providers that are already integrated, so you can
easily start searching, accessing, and downloading products.

Some providers are completely open, while others require an account to access their data.
If credentials are needed, check the :doc:`registration guide <providers>` for details.

.. admonition::  EODAG is not limited to the providers listed here
   :class: note

   If a desired provider is missing, you can add it yourself.
   See `how to add a new provider <notebooks/api_user_guide/2_configuration.ipynb#Add-or-update-a-provider>`_ for more details.

----

**AWS / GCS EO catalogs**
==========================

.. admonition::  **Cloud-Native Earth Observation Data**
   :class: note

   These providers offer scalable access to satellite imagery through cloud infrastructure with global distribution.

**Earth Search**
----------------

**earth_search**
^^^^^^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Element84 STAC API for data on AWS.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://www.element84.com/earth-search/
         :color: primary
         :outline:
         :tooltip: Earth Search website

         :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  **Setup Requirements:**

  * Create an account on `AWS <https://aws.amazon.com/>`__
  * Once the account is activated go to the `identity access management console <https://console.aws.amazon.com/iam/home#/home>`__
  * Click on user, then on your user name and then on security credentials.
  * In access keys, click on create access key.
  * Add these credentials to the user configuration file.

  .. warning:: **Billing Alert**

      A credit card number must be provided when creating an AWS account because fees apply
      after a given amount of downloaded data.

----

**earth_search_gcs**
^^^^^^^^^^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Element84 Earth Search on Google Cloud Storage.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://cloud.google.com/storage/docs/public-datasets
         :color: primary
         :outline:
         :tooltip: Earth Search website

         :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  You need HMAC keys for Google Cloud Storage:

  * Sign in using a `google account <https://accounts.google.com/signin/v2/identifier>`__.
  * Get or create `HMAC keys <https://cloud.google.com/storage/docs/authentication/hmackeys>`__ for your user account
    on a project for interoperability API access from this
    `page <https://console.cloud.google.com/storage/settings;tab=interoperability>`__ (create a default project if
    none exists).
  * Add these credentials to the user configuration file.

----


**aws_eos**
-----------

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      EOS Data Analytics search for AWS public datasets.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://eos.com/
         :color: primary
         :outline:
         :tooltip: EOS Data Analytics website

         :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  You need credentials for both EOS Data Analytics (search) and AWS (download):

  * Create an account on `EOS <https://auth.eos.com>`__
  * Get your EOS api key from `here <https://api-connect.eos.com/user-dashboard/statistics>`__
  * Create an account on `AWS <https://aws.amazon.com/>`__
  * Once the account is activated go to the `identity access management console <https://console.aws.amazon.com/iam/home#/home>`__
  * Click on user, then on your user name and then on security credentials.
  * In access keys, click on create access key.
  * Add these credentials to the user configuration file:

    * ``search_auth.credentials.api_key``
    * ``download_auth.credentials.aws_access_key_id`` and ``download_auth.credentials.aws_secret_access_key`` or ``download_auth.credentials.aws_profile``

  .. note:: **Usage Limits**

      EOS free trial account is limited to 1000 requests, see also their `subscription plans <https://doc.eos.com/subscription/>`__.

----

**Copernicus**
==============

.. admonition:: **European Space Programme**
   :class: note

   The Copernicus programme provides free and open access to Earth observation data from the Sentinel satellite constellation and climate services.

**Copernicus Data Stores**
---------------------------

**cop_ads**
^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Copernicus Atmosphere Data Store.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://ads.atmosphere.copernicus.eu
        :color: primary
        :outline:
        :tooltip: Atmosphere Data Store website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Go to the `ECMWF homepage <https://www.ecmwf.int/>`__ and create an account by clicking on *Log in* and then *Register*.

  Then log in and go to your user profile on `Atmosphere Data Store <https://ads.atmosphere.copernicus.eu/>`__ and
  use your *Personal Access Token* as ``apikey`` in eodag credentials.

  To download data you have to accept the `Licence to use Copernicus Products`. To accept the licence:

  * Go to `Datasets <https://ads.atmosphere.copernicus.eu/datasets>`__ while being logged in.
  * Open the details of a dataset and go to the download tab.
  * Scroll down and accept the licence in the section `Terms of use`.
  * You can check which licences you have accepted in your user profile.

----

**cop_cds**
^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Copernicus Climate Data Store.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://cds.climate.copernicus.eu
        :color: primary
        :outline:
        :tooltip: Climate Data Store website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Go to the `ECMWF homepage <https://www.ecmwf.int/>`__ and create an account by clicking on *Log in* and then *Register*.
  Then log in and go to your user profile on `Climate Data Store <https://cds.climate.copernicus.eu/>`__ and use your
  *Personal Access Token* as ``apikey`` in eodag credentials.

  To download data, you also have to accept certain terms depending on the dataset. Some datasets have a specific licence
  whereas other licences are valid for a group of datasets.
  For example after accepting the `Licence to use Copernicus Products` you can use all `ERA5` datasets, to use the seasonal data from C3S you
  also have to accept the `Additional licence to use non European contributions`.

  To accept a licence:

  * Search for the dataset you want to download `here <https://cds.climate.copernicus.eu/datasets>`__ while being
    logged in.
  * Open the dataset details and go to the download tab.
  * Scroll down and accept the licence in the section `Terms of use`.
  * You can check which licences you have accepted in your user profile.

----

**cop_dataspace**
^^^^^^^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Copernicus Data Space Ecosystem.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://dataspace.copernicus.eu/
        :color: primary
        :outline:
        :tooltip: Data Space Ecosystem website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Create an account `here
  <https://identity.dataspace.copernicus.eu/auth/realms/CDSE/protocol/openid-connect/auth?client_id=cdse-public&redirect_uri=https%3A%2F%2Fdataspace.copernicus.eu%2Fbrowser%2F&response_type=code&scope=openid>`__

----

**cop_dataspace_s3**
^^^^^^^^^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Copernicus Data Space Ecosystem data through S3 protocol.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://dataspace.copernicus.eu/
        :color: primary
        :outline:
        :tooltip: Data Space Ecosystem website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Create an account on `cop_dataspace <https://identity.dataspace.copernicus.eu/auth/realms/CDSE/protocol/openid-connect/auth?client_id=cdse-public&response_type=code&scope=openid&redirect_uri=https%3A//dataspace.copernicus.eu/account/confirmed/1>`__, then go to
  `keymanager <https://eodata-s3keysmanager.dataspace.copernicus.eu/panel/s3-credentials>`__ and click `Add credential` to generate the s3 access key and
  secret key. Add those credentials to the user configuration file (variables `aws_access_key_id` and
  `aws_secret_access_key`).


----

**cop_ewds**
^^^^^^^^^^^^
.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      CEMS Early Warning Data Store.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://ewds.climate.copernicus.eu
        :color: primary
        :outline:
        :tooltip: CEMS Early Warning Data Store website

        :fas:`external-link-alt`


.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Go to the `ECMWF homepage <https://www.ecmwf.int/>`__ and create an account by clicking on *Log in* and then *Register*.
  Then log in and go to your user profile on `CEMS Early Warning Data Store <https://ewds.climate.copernicus.eu>`__ and use your
  *Personal Access Token* as ``apikey`` in eodag credentials.

  To download data, you also have to accept certain terms depending on the dataset. There are two different licences that have to be accepted
  to use the CEMS EWDS datasets. Accepting the `CEMS-FLOODS datasets licence` is necessary to use the `GLOFAS` and `EFAS` datasets,
  the `Licence to use Copernicus Products` is valid for the Fire danger datasets.

  To accept a licence:

  * Search for the dataset you want to download `here <https://ewds.climate.copernicus.eu/datasets>`__ while being
    logged in.
  * Open the dataset details and go to the download tab.
  * Scroll down and accept the licence in the section `Terms of use`.
  * You can check which licences you have accepted in your user profile.

----

**cop_ghsl**
^^^^^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Copernicus Global Human Settlement Layer.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://human-settlement.emergency.copernicus.eu/
        :color: primary
        :outline:
        :tooltip: Copernicus Global Human Settlement Layer website

        :fas:`external-link-alt`

No credentials are needed

----

**cop_marine**
^^^^^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Copernicus Marine Service.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://marine.copernicus.eu
        :color: primary
        :outline:
        :tooltip: Copernicus Marine Service website

        :fas:`external-link-alt`

No credentials are needed

----

**sara**
--------

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Sentinel Australasia Regional Access.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://copernicus.nci.org.au
        :color: primary
        :outline:
        :tooltip: SARA website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Create an account `here <https://copernicus.nci.org.au/sara.client/#/register>`__, then use your email as ``username`` in
  eodag credentials.

----

**WEkEO**
----------

**wekeo_main**
^^^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      WEkEO Copernicus Sentinel, DEM, and CLMS data.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://www.wekeo.eu/
        :color: primary
        :outline:
        :tooltip: WEkEO website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  You need an access token to authenticate and to accept terms and conditions with it:

  * Create an account on `WEkEO <https://www.wekeo.eu/register>`__
  * Add your WEkEO credentials (``username``, ``password``) to the user configuration file.
  * Depending on which data you want to retrieve, you will then need to accept terms and conditions (for once).
    To do this, follow the
    `tutorial guidelines <notebooks/tutos/tuto_wekeo.html#Registration>`__
    or run the following commands in your terminal.

  * First, get a token from your base64-encoded credentials (replace USERNAME and PASSWORD with your credentials):

    .. code-block:: bash

        curl -X POST --data '{"username": "USERNAME", "password": "PASSWORD"}' \
        -H "Content-Type: application/json" \
        "https://gateway.prod.wekeo2.eu/hda-broker/gettoken"

    The WEkEO API will respond with a token:

    .. code-block:: bash

        { "access_token": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "refresh_token": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "scope":"openid",
          "id_token":"token",
          "token_type":"Bearer",
          "expires_in":3600
        }

  * Accept terms and conditions by running this command and replacing <access_token> and <licence_name>:

    .. code-block:: bash

        curl --request PUT \
            --header 'accept: application/json' \
            --header 'Authorization: Bearer <access_token>' \
            https://gateway.prod.wekeo2.eu/hda-broker/api/v1/termsaccepted/<licence_name>

  The licence name depends on which data you want to retrieve.
  To use all datasets available in WEkEO, the following licences have to be accepted:

  * EUMETSAT_Copernicus_Data_Licence
  * Copernicus_Land_Monitoring_Service_Data_Policy
  * Copernicus_Sentinel_License
  * Copernicus_ECMWF_License
  * Copernicus_DEM_Instance_COP-DEM-GLO-30-F_Global_30m
  * Copernicus_DEM_Instance_COP-DEM-GLO-90-F_Global_90m

----

**wekeo_cmems**
^^^^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Copernicus Marine (CMEMS) data from WEkEO.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://www.wekeo.eu/
        :color: primary
        :outline:
        :tooltip: WEkEO website

        :fas:`external-link-alt`


.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  The registration procedure is the same as for ``wekeo_main``.
  The licence that has to be accepted to access the Copernicus Marine data is:

  * ``Copernicus_Marine_Service_Product_License``

----

**wekeo_ecmwf**
^^^^^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      WEkEO ECMWF data.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://www.wekeo.eu/
        :color: primary
        :outline:
        :tooltip: WEkEO website

        :fas:`external-link-alt`


.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  The registration procedure is the same as for ``wekeo_main``.

----

**CREODIAS**
-------------

**creodias**
^^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      CloudFerro DIAS.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://creodias.eu/
        :color: primary
        :outline:
        :tooltip: Creodias website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Create an account `here <https://portal.creodias.eu/register.php>`__, then use your ``username``, ``password`` in eodag
  credentials. You will also need `totp` in credentials, a temporary 6-digits OTP (One Time Password, see
  `Creodias documentation
  <https://creodias.docs.cloudferro.com/en/latest/gettingstarted/Two-Factor-Authentication-for-Creodias-Site.html>`__)
  to be able to authenticate and download. Check
  `Authenticate using an OTP
  <getting_started_guide/configure.rst#authenticate-using-an-otp-one-time-password-two-factor-authentication>`__
  to see how to proceed.

----

**creodias_s3**
^^^^^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      CloudFerro DIAS data through their S3 EODATA.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://creodias.eu/
        :color: primary
        :outline:
        :tooltip: Creodias website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Create an account on `creodias <https://creodias.eu/>`__, then go to
  `keymanager <https://eodata-keymanager.creodias.eu/>`__ and click `Add credential` to generate the s3 access key and
  secret key. Add those credentials to the user configuration file (variables `aws_access_key_id` and
  `aws_secret_access_key`).

----

**CNES**
========

.. admonition:: **French National Space Agency**
   :class: note

   CNES provides access to French satellite missions including SPOT, Pléiades, and specialized thematic data hubs.

**GEODES**
-----------

**geodes**
^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      GEODES, French National Space Agency (CNES) Earth Observation portal.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://geodes-portal.cnes.fr
        :color: primary
        :outline:
        :tooltip: GEODES website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Go to `https://geodes-portal.cnes.fr <https://geodes-portal.cnes.fr>`_, then login or create an account by
  clicking on ``Log in`` in the top-right corner. Once logged-in, create an API key in the user settings page, and used it
  as ``apikey`` in EODAG provider auth credentials.

----

**geodes_s3**
^^^^^^^^^^^^^^

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      GEODES, French National Space Agency (CNES) Earth Observation portal through their internal S3 Datalake.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://geodes-portal.cnes.fr
        :color: primary
        :outline:
        :tooltip: GEODES website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  This provider is only available for CNES users. You need to be connected to the CNES network to access the data.
  Get credentials for internal Datalake and use them as ``aws_access_key_id``, ``aws_secret_access_key`` and
  ``aws_session_token`` EODAG credentials.

----

**hydroweb_next**
-----------------

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      hydroweb.next thematic hub for hydrology data access.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://hydroweb.next.theia-land.fr
        :color: primary
        :outline:
        :tooltip: hydroweb.next website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Go to `https://hydroweb.next.theia-land.fr <https://hydroweb.next.theia-land.fr>`_, then login or create an account by
  clicking on ``Log in`` in the top-right corner. Once logged-in, create an API key in the user settings page, and used it
  as ``apikey`` in EODAG provider auth credentials.

----

**Destination Earth**
======================

.. admonition:: **Digital Twin of Earth**
   :class: note

   Destination Earth initiative creates digital replicas of Earth systems for climate adaptation and environmental policy.


**DEDL**
--------

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Destination Earth Data Lake (DEDL).

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://hda.data.destination-earth.eu/ui
        :color: primary
        :outline:
        :tooltip: DEDL website

        :fas:`external-link-alt`


.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  You need a `DESP OpenID` account in order to authenticate.

  To create one go `here
  <https://hda.data.destination-earth.eu/ui>`__, then click on `Sign In`, select the identity provider `DESP OpenID` and
  then click `Authenticate`. Finally click on `Register` to create a new account.

----

**DEDT Lumi**
-------------

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Destination Earth Digital Twin output on Lumi.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://polytope.lumi.apps.dte.destination-earth.eu/openapi
        :color: primary
        :outline:
        :tooltip: DEDT Lumi website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Create an account on `DestinE <https://platform.destine.eu/>`__, then use your ``username``, ``password`` in eodag
  credentials.

----

**DEDT MareNostrum**
--------------------

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Destination Earth Digital Twin output on MareNostrum.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://polytope.mn5.apps.dte.destination-earth.eu/openapi
        :color: primary
        :outline:
        :tooltip: DEDT MareNostrum OpenAPI

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Create an account on `DestinE <https://platform.destine.eu/>`__, then use your ``username``, ``password`` in eodag
  credentials.

----

**ECMWF**
==========

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      European Centre for Medium-Range Weather Forecasts.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://www.ecmwf.int/
        :color: primary
        :outline:
        :tooltip: ECMWF website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Create an account `here <https://www.ecmwf.int/user/login>`__.

  Then use *email* as ``username`` and *key* as ``password`` from `here <https://api.ecmwf.int/v1/key/>`__ in eodag credentials.
  EODAG can be used to request for public datasets as for operational archive. Please note that for public datasets you
  might need to accept a license (e.g. for `TIGGE <https://apps.ecmwf.int/datasets/data/tigge/licence/>`__)

----

**ESA**
=======

.. admonition:: **European Space Agency**
   :class: note

   European Space Agency providing access to climate monitoring and Earth observation missions.


**fedeo_ceda**
---------------

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      FedEO CEDA (Centre for Environmental Data Archival) through CEOS Federated Earth Observation missions access.
      The FedEO service periodically ingests the latest ESA CCI (Climate Change Initiative) Open Data Portal catalogue
      of all CCI datasets.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://climate.esa.int/en/
        :color: primary
        :outline:
        :tooltip: FedEO CEDA website

        :fas:`external-link-alt`

No credentials are needed

**eocat**
----------

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      EOCAT (ESA Catalog) providing access to ESA Earth observation missions data, including Heritage and Third Party
      missions.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://eocat.esa.int/eo-catalogue?httpAccept=text/html
        :color: primary
        :outline:
        :tooltip: EOCAT / ESA Catalog website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Create an account `here <https://eoiam-idp.eo.esa.int>`__.

  Then use *email* as ``username`` and ``password`` in eodag credentials.

  .. note:: **Additional consent**

     Some collections will require additional consent for download. If so, a form URL will be will be provided in the
     authentication error message. You will need to open the URL, fill in the form and try again.

----

**EUMETSAT**
============

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      EUMETSAT Data Store (European Organisation for the Exploitation of Meteorological Satellites).

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://data.eumetsat.int
        :color: primary
        :outline:
        :tooltip: EUMETSAT Data Store website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Create an account `here <https://eoportal.eumetsat.int/userMgmt/register.faces>`__.

  Then use the consumer key as ``username`` and the consumer secret as ``password`` from `here
  <https://api.eumetsat.int/api-key/>`__ in eodag credentials.

----

**Meteoblue**
=============

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Meteoblue weather and forecast Dataset API.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://content.meteoblue.com/en/business-solutions/weather-apis/dataset-api
        :color: primary
        :outline:
        :tooltip: Meteoblue website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  EODAG uses `dataset API <https://content.meteoblue.com/en/business-solutions/weather-apis/dataset-api>`_
  which requires the access level
  `Access Gold <https://content.meteoblue.com/en/business-solutions/weather-apis/pricing>`_.

  Contact `support@meteoblue.com <mailto:support@meteoblue.com>`_ to apply for a free API key trial.

----

**Planetary Computer**
=======================

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      Microsoft Planetary Computer.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://planetarycomputer.microsoft.com/
        :color: primary
        :outline:
        :tooltip: Planetary Computer website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Most datasets are anonymously accessible, but a subscription key may be needed to increase `rate limits and access
  private datasets <https://planetarycomputer.microsoft.com/docs/concepts/sas/#rate-limits-and-access-restrictions>`_.

  Create an account `here <https://planetarycomputer.microsoft.com/account/request>`__, then view your keys by signing in
  with your Microsoft account `here <https://planetarycomputer.developer.azure-api.net/>`__.

----

**USGS / Landsat**
===================

.. admonition:: **U.S. Geological Survey**
   :class: note

   United States Geological Survey providing access to Landsat archive and other Earth observation programs.

**usgs**
---------

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      U.S geological survey catalog for Landsat products.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://earthexplorer.usgs.gov/
        :color: primary
        :outline:
        :tooltip: USGS website

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  Create an account  `here <https://ers.cr.usgs.gov/register/>`__, and
  `request an access <https://ers.cr.usgs.gov/profile/access>`_ to the
  `Machine-to-Machine (M2M) API <https://m2m.cr.usgs.gov/>`_.
  Then you will need to `generate an application token <https://ers.cr.usgs.gov/password/appgenerate>`_. Use it as
  ``password`` in eodag credentials, associated to your ``username``.

  Product requests can be performed once access to the M2M API has been granted to you.

----

**usgs_satapi_aws**
--------------------

.. grid:: 2
   :gutter: 2
   :class-container: sd-d-flex sd-align-items-center

   .. grid-item::
      :columns: 10

      USGS Landsatlook SAT API / STAC server for Landsat data hosted on AWS S3.

   .. grid-item::
      :columns: 2
      :class: sd-text-right

      .. button-link:: https://landsatlook.usgs.gov/stac-server/
        :color: primary
        :outline:
        :tooltip: USGS Landsatlook SAT API

        :fas:`external-link-alt`

.. dropdown:: Registration info
  :color: muted
  :class-container: dropdown-fade-in slim-dropdown

  You need AWS credentials for download:

  * Create an account on `AWS <https://aws.amazon.com/>`__
  * Once the account is activated go to the `identity access management console <https://console.aws.amazon.com/iam/home#/home>`__
  * Click on user, then on your user name and then on security credentials.
  * In access keys, click on create access key.
  * Add these credentials to the user configuration file.

  .. warning:: **Billing Alert**

      A credit card number must be provided when creating an AWS account because fees apply
      after a given amount of downloaded data.
