EODAG 项目教程

1. 项目介绍

EODAG（Earth Observation Data Access Gateway）是一个命令行工具和插件化的 Python 框架，用于搜索、聚合结果和下载遥感图像，同时提供统一的 API 接口，无论数据提供者是谁。EODAG 旨在简化从多个数据提供者获取地球观测数据的流程，支持超过 10 个数据提供者和 50 多种产品类型（如 Sentinel 1、Sentinel 2、Landsat 等）。

EODAG 的主要功能包括：

• 搜索和下载地球观测产品
• 支持 STAC 和静态 STAC 目录
• 可以作为 STAC API REST 服务器运行
• 通过插件扩展支持新的数据提供者

2. 项目快速启动

安装 EODAG

EODAG 可以通过 pip 或 conda 安装：

# 使用 pip 安装
python -m pip install eodag

# 使用 conda 安装
conda install -c conda-forge eodag

配置 EODAG

在首次运行 EODAG 时，系统会自动创建一个用户配置文件，您需要在该文件中填写所需数据提供者的凭证。

使用 Python API

以下是一个简单的 Python 代码示例，用于搜索和下载 Sentinel 2 Level-1C 产品：

from eodag import EODataAccessGateway

# 初始化 EODAG
dag = EODataAccessGateway()

# 搜索产品
search_results = dag.search(
    productType='S2_MSI_L1C',
    geom={'lonmin': 1, 'latmin': 43.5, 'lonmax': 2, 'latmax': 44},
    start='2021-01-01',
    end='2021-01-15'
)

# 下载产品
product_paths = dag.download_all(search_results)

使用命令行接口

通过命令行搜索和下载产品：

# 搜索产品
eodag search --productType S2_MSI_L1C --box 1 43 2 44 --start 2021-03-01 --end 2021-03-31

# 下载搜索结果
eodag download --search-results search_results.geojson

3. 应用案例和最佳实践

案例1：搜索和下载 Sentinel-2 数据

假设您需要获取某个区域的 Sentinel-2 数据，可以使用以下步骤：

1. 配置 EODAG 以使用 Sentinel-2 数据提供者。
2. 使用 Python API 或命令行工具搜索特定时间段内的数据。
3. 下载搜索到的数据并进行后续处理。

案例2：使用 STAC API 进行数据访问

EODAG 支持作为 STAC API 服务器运行，您可以通过以下步骤启动 STAC API 服务器：

eodag serve-rest

然后，您可以使用 curl 或其他工具访问 STAC API：

# 列出可用产品类型
curl "http://127.0.0.1:5000/collections?provider=peps" | jq ".collections[].id"

# 搜索产品
curl "http://127.0.0.1:5000/search?collections=S2_MSI_L1C&bbox=0,43,1,44&datetime=2018-01-20/2018-01-25" | jq ".numberMatched"

4. 典型生态项目

EODAG-Labextension

EODAG-Labextension 是一个 JupyterLab 扩展，提供了一个友好的用户界面，帮助您在 Jupyter 笔记本中搜索和浏览 EO 产品。

STAC Browser

STAC Browser 是一个用于浏览 STAC API 的工具，您可以通过以下步骤启动 STAC Browser：

git clone https://github.com/CS-SI/eodag.git
cd eodag
docker-compose up

然后，您可以访问 http://127.0.0.1:5001 浏览 STAC API 服务器。

通过这些工具和方法，您可以更高效地管理和处理地球观测数据。