Earth Observation Data Access Gateway (3.0.2.dev2+g2473ac16)#
EODAG (Earth Observation Data Access Gateway) is a command line tool and a Python package for searching and downloading remotely sensed images while offering a unified API for data access regardless of the data provider.
EODAG gives you an easy way to access products from more than 10 providers, with more than 50 different product types (Sentinel 1, Sentinel 2, Sentinel 3, Landsat, etc.) that can be searched and downloaded.
- [Growing list of] supported providers#
aws_eos, cop_ads, cop_cds, cop_dataspace, cop_ewds, cop_marine, creodias, creodias_s3, dedl, dedt_lumi, earth_search, earth_search_gcs, ecmwf, geodes, eumetsat_ds, hydroweb_next, meteoblue, onda, peps, planetary_computer, sara, theia, usgs, usgs_satapi_aws, wekeo_cmems, wekeo_ecmwf, wekeo_main
EODAG has the following primary features:
Search and download Earth Observation products from different providers with a unified API
It is both a Command Line Tool and a Python Package
It supports STAC and Static STAC catalogs
It can run as a STAC API REST server to give access to a provider’s catalog
New providers can be added with a configuration file or by extending EODAG with plugins
Example#
Register to one or more providers, configure your credentials , and then downloading Sentinel 2 Level-1C products from any provider’s catalog is as simple as:
from eodag import EODataAccessGateway
dag = EODataAccessGateway()
search_results = dag.search(
productType="S2_MSI_L1C",
start="2021-03-01",
end="2021-03-31",
geom={"lonmin": 1, "latmin": 43, "lonmax": 2, "latmax": 44}
)
product_paths = dag.download_all(search_results)
Breaking change in v3.0.0
search()
method now returns only a single
SearchResult
instead of a 2 values tuple.
Or:
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
License#
EODAG is available under the open source Apache License.
Site contents#
- Getting Started
- Python API User Guide
- Python API Reference
- Breaking changes
- CLI User Guide
- STAC Support
- Tutorials
- Search for products by tile
- Get Copernicus DEM using EODAG
- ECMWF API plugin for EODAG
- Copernicus Atmosphere using BuildSearchResult plugin
- The wekeo provider in EODAG
- Get forecast data from meteoblue using EODAG
- Sentinel-1 processing for ship detection (SNAP)
- Sentinel-2 processing to get a burnt area map (Sen2Cor, SNAP, snappy)
- Add a Provider
- Plugins
- Parameters mapping
- Contribute
- Release history
- v3.0.1 (2024-11-06)
- v3.0.0 (2024-10-10)
- v3.0.0b3 (2024-08-01)
- v3.0.0b2 (2024-06-29)
- v3.0.0b1 (2024-06-24)
- v2.12.1 (2024-03-05)
- v2.12.0 (2024-02-19)
- v2.11.0 (2023-11-20)
- v2.11.0b1 (2023-07-28)
- v2.10.0 (2023-04-18)
- v2.9.2 (2023-03-31)
- v2.9.1 (2023-02-27)
- v2.9.0 (2023-02-16)
- v2.8.0 (2023-01-17)
- v2.7.0 (2022-11-29)
- v2.6.2 (2022-11-15)
- v2.6.1 (2022-10-19)
- v2.6.0 (2022-10-07)
- v2.5.2 (2022-07-05)
- v2.5.1 (2022-06-27)
- v2.5.0 (2022-06-07)
- v2.4.0 (2022-03-09)
- v2.3.4 (2021-10-08)
- v2.3.3 (2021-08-11)
- v2.3.2 (2021-07-29)
- v2.3.1 (2021-07-09)
- v2.3.0 (2021-06-24)
- v2.3.0b1 (2021-06-11)
- v2.2.0 (2021-03-26)
- v2.1.1 (2021-03-18)
- v2.1.0 (2021-03-09)
- v2.0.1 (2021-02-05)
- v2.0 (2021-01-28)
- v2.0b2 (2020-12-18)
- v2.0b1 (2020-11-17)
- v1.6.0 (2020-08-24)
- v1.6.0rc2 (2020-08-11)
- v1.6.0rc0 (2020-06-18)
- v1.5.2 (2020-05-06)
- v1.5.1 (2020-04-08)
- v1.5.0 (2020-04-08)
- v1.4.2 (2020-03-04)
- v1.4.1 (2020-02-25)
- v1.4.0 (2020-02-24)
- v1.3.6 (2020-01-24)
- v1.3.5 (2020-01-07)
- v1.3.4 (2019-12-12)
- v1.3.3 (2019-10-11)
- v1.3.2 (2019-09-27)
- v1.3.1 (2019-09-27)
- v1.3.0 (2019-09-06)
- v1.2.3 (2019-08-26)
- v1.2.2 (2019-08-23)
- v1.2.1 (2019-08-23)
- v1.2.0 (2019-08-22)
- v1.1.3 (2019-08-05)
- v1.1.2 (2019-08-05)
- v1.1.1 (2019-07-26)
- v1.1.0 (2019-07-23)
- v1.0.1 (2019-04-30)
- v1.0 (2019-04-26)
- v0.7.2 (2019-03-26)
- v0.7.1 (2019-03-01)
- v0.7.0 (2018-12-04)
- v0.6.3 (2018-09-24)
- v0.6.2 (2018-09-24)
- v0.6.1 (2018-09-19)
- v0.6.0 (2018-08-09)
- v0.5.0 (2018-08-02)
- v0.4.0 (2018-07-26)
- v0.3.0 (2018-07-23)
- v0.2.0 (2018-07-17)
- v0.1.0 (2018-06-20)
- v0.0.1 (2018-06-15)
- GitHub Repository