eodag
v3.0.1
Kasse EODAG Jupyterlab-Erweiterung : eodag-labextension! Dies bringt eine benutzerfreundliche Benutzeroberfläche auf Ihr Notebook und hilft Ihnen bei der Suche und Suche nach EO-Produkten mit eodag .
EODAG (Earth Observation Data Access Gateway) ist ein Befehlszeilentool und ein Plugin-orientiertes Python-Framework zum Suchen, Aggregieren von Ergebnissen und Herunterladen von Fernerkundungsbildern und bietet gleichzeitig eine einheitliche API für den Datenzugriff unabhängig vom Datenanbieter. Das EODAG SDK gliedert sich in drei Funktionen:
Produkttypen auflisten: Liste der unterstützten Produkte und deren Beschreibung
Produkte suchen (nach Produkttyp oder UID): Durchsucht Produkte gemäß den angegebenen Suchkriterien
Produkte herunterladen: Produkt „wie besehen“ herunterladen
EODAG wird in Python entwickelt. Es ist nach einer modularen Plugin-Architektur aufgebaut, leicht erweiterbar und in der Lage, neue Datenanbieter zu integrieren. Das Tool besteht aus drei Arten von Plugins:
Katalogsuch-Plugins, verantwortlich für die Suche nach Daten (OpenSearch, CSW, ...), das Erstellen von Pfaden, das Abrufen von Quicklooks und das Kombinieren von Ergebnissen
Laden Sie Plugins herunter, die das lokale Herunterladen und Abrufen von Daten (über FTP, HTTP usw.) ermöglichen, immer mit der gleichen Verzeichnisorganisation
Authentifizierungs-Plugins, die zur Authentifizierung des Benutzers bei den verwendeten externen Diensten (JSON Token, Basic Auth, OAUTH, ...) dienen.
Seit v2.0 kann EODAG als STAC-Client oder -Server ausgeführt werden.
Weitere Einblicke finden Sie in der Dokumentation.
EODAG ist auf PyPI verfügbar:
python -m pip install eodag
Und mit conda vom Conda-Forge-Kanal:
conda install -c conda-forge eodag
Wichtig
Wichtige Änderung in Version 3.0.0 : Bitte beachten Sie, dass EODAG mit einem minimalen Satz an Abhängigkeiten ausgestattet ist. Wenn Sie weitere Funktionen wünschen, installieren Sie bitte eines der verfügbaren Extras.
Zum Herunterladen müssen Sie Ihre Zugangsdaten für die gewünschten Anbieter in Ihre eodag-Benutzerkonfigurationsdatei eingeben. Die Datei wird beim ersten Durchlauf automatisch mit leeren Werten erstellt.
Beispielverwendung für die Interaktion mit der API in Ihrem Python-Code:
from eodag import EODataAccessGatewaydag = EODataAccessGateway()search_results = dag.search(productType='S2_MSI_L1C',geom={'lonmin': 1, 'latmin': 43.5, 'lonmax': 2, 'latmax': 44}, # akzeptiert WKT-Polygone, shapely.geometry, ...start='2021-01-01',end='2021-01-15')product_paths = dag.download_all(search_results)Dadurch wird beim Standardanbieter nach Sentinel 2 Level-1C-Produkten gesucht und die erste Seite der gefundenen Produkte sowie eine geschätzte Gesamtzahl der Produkte zurückgegeben, die den Suchkriterien entsprechen. Und dann werden diese Produkte heruntergeladen. Weitere Informationen finden Sie im Python API-Benutzerhandbuch.
Wichtig
Breaking Change in v3.0.0 : Die Methode search() gibt jetzt nur ein einzelnes SearchResult anstelle eines Tupels mit zwei Werten zurück.
Eine eodag-Instanz kann über eine STAC-kompatible REST-API über die Befehlszeile verfügbar gemacht werden ( eodag[server] erforderlich):
$ eodag Serve-Rest --help
Verwendung: eodag Serve-Rest [OPTIONEN]
Starten Sie den eodag HTTP-Server
Legen Sie die Umgebungsvariable EODAG_CORS_ALLOWED_ORIGINS fest, um Cross- zu konfigurieren.
Origin Resource Sharing erlaubte Ursprünge als durch Kommas getrennte URLs (z. B. „http://irgendwo,htttp://irgendwo.else“).
Optionen:
-f, --config PATH Dateipfad zur Benutzerkonfigurationsdatei mit
Anmeldeinformationen, Standard ist ~/.config/eodag/eodag.yml
-l, --locs PATH Dateipfad zur Speicherort-Shapefiles-Konfigurationsdatei
-d, --daemon wird im Daemon-Modus ausgeführt
-w, --world führt uvicorn mit IPv4 0.0.0.0 aus (alle Netzwerkschnittstellen),
andernfalls an 127.0.0.1 (localhost) binden.
-p, --port INTEGER Der Port, der überwacht werden soll [Standard: 5000]
--debug Im Debug-Modus ausführen (für Entwicklungszwecke)
--help Diese Nachricht anzeigen und beenden.# Server ausführen$ eodag Serve-Rest# Verfügbare Produkttypen für „peps“ auflisten Anbieter:$ curl "http://127.0.0.1:5000/collections?provider=peps" | jq ".collections[].id""S1_SAR_GRD""S1_SAR_OCN""S1_SAR_SLC""S2_MSI_L1C""S2_MSI_L2A"# Suche nach Artikeln$ 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"6# Download-Link abrufen$ curl "http://127.0.0.1:5000/collections/S2_MSI_L1C/items" | jq ".features[0].assets.downloadLink.href""http://127.0.0.1:5002/collections/S2_MSI_L1C/items/S2B_MSIL1C_20240917T115259_N0511_R137_T21CWS_20240917T145134/download"# download$ wget „http://127.0.0.1:5002/collections/S2_MSI_L1C/items/S2B_MSIL1C_20240917T115259_N0511_R137_T21CWS_20240917T145134/download“ eodag-server ist unter https://hub.docker.com/r/csspace/eodag-server verfügbar:
docker run -p 5000:5000 --rm csspace/eodag-server:3.0.1
Sie können Ihren STAC-API-Server auch mit dem STAC-Browser durchsuchen. Führen Sie einfach Folgendes aus:
Git-Klon https://github.com/CS-SI/eodag.gitcd eodag docker-compose up# oder für eine ausführlichere Protokollierung:EODAG_LOGGING=3 docker-compose up
Und durchsuchen Sie http://127.0.0.1:5001:
Weitere Informationen finden Sie unter Verwendung der STAC REST API.
Beginnen Sie mit der CLI zu spielen:
So suchen Sie nach einigen Produkten:
eodag search --productType S2_MSI_L1C --box 1 43 2 44 --start 2021-03-01 --end 2021-03-31
Die obige Anfrage sucht im März 2021 nach S2_MSI_L1C -Produkttypen in einem bestimmten Begrenzungsrahmen. Sie speichert die Ergebnisse in einer GeoJSON-Datei (standardmäßig search_results.geojson ).
Die Ergebnisse sind paginiert. Möglicherweise möchten Sie mit --all alle Seiten auf einmal abrufen oder mit --cloudCover 20 nach Produkten suchen, die maximal 20 % der Abdeckung abdecken. Weitere Informationen zu den verfügbaren Optionen:
eodag-Suche --help
So laden Sie das Ergebnis des vorherigen Suchaufrufs herunter:
eodag herunterladen --search-results search_results.geojson
Um nur die Ergebnis-Quicklooks des vorherigen Suchaufrufs herunterzuladen:
eodag herunterladen --quicklooks --search-results search_results.geojson
So listen Sie alle verfügbaren Produkttypen und unterstützten Anbieter auf:
Eodag-Liste
So listen Sie verfügbare Produkttypen bei einem angegebenen unterstützten Anbieter auf:
eodag list -p creodias
So sehen Sie alle verfügbaren Optionen und Befehle:
eodag --help
Um Protokollmeldungen zu drucken, fügen Sie -v zum eodag-Master-Befehl hinzu. zB eodag -v list . Je mehr v angegeben wird (bis zu 3), desto ausführlicher ist das Tool. Für eine vollständige ausführliche Ausgabe gehen Sie beispielsweise wie folgt vor: eodag -vvv list
Haben Sie einen Tippfehler in unserer Dokumentation entdeckt? Haben Sie beim Ausführen von EODAG einen Fehler festgestellt? Haben Sie einen Vorschlag für eine neue Funktion?
Zögern Sie nicht und eröffnen Sie eine Ausgabe oder reichen Sie eine Pull-Anfrage ein. Beiträge sind herzlich willkommen!
Anleitungen zum Einrichten einer Entwicklungsumgebung und zum Beitragen zu eodag finden Sie in den Beitragsrichtlinien.
EODAG ist unter der Apache-Lizenz v2.0 lizenziert. Einzelheiten finden Sie in der LICENSE-Datei.
EODAG wurde von CS GROUP – Frankreich gegründet.
EODAG basiert auf erstaunlich nützlichen Open-Source-Projekten. Einzelheiten zu diesen Projekten und ihren Lizenzen finden Sie in der NOTICE-Datei. Vielen Dank an alle Autoren dieser Projekte!
