查看EODAG Jupyterlab 擴充功能:eodag-labextension!這將為您的筆記本帶來友善的 UI,並幫助您使用eodag
搜尋和瀏覽 EO 產品。
EODAG(地球觀測資料存取閘道)是一個命令列工具和一個以插件為導向的Python框架,用於搜尋、聚合結果和下載遙感影像,同時提供統一的資料存取API,無論資料提供者為何。 EODAG SDK 圍繞著三個功能:
列出產品類型:支援的產品清單及其描述
搜尋產品(依產品類型或uid):根據提供的搜尋條件搜尋產品
下載產品:「按原樣」下載產品
EODAG是用Python開發的。它是根據模組化插件架構構建的,易於擴展並且能夠整合新的資料提供者。該工具由三種類型的插件組成:
目錄搜尋插件,負責搜尋資料(OpenSearch、CSW...)、建置路徑、擷取快速查找、組合結果
下載插件,允許在本地下載和檢索資料(透過 FTP、HTTP 等),始終具有相同的目錄組織
身份驗證插件,用於在所使用的外部服務上對使用者進行身份驗證(JSON 令牌、基本身份驗證、OAUTH 等)。
自 v2.0 起,EODAG 可以作為 STAC 用戶端或伺服器運作。
閱讀文件以獲取更多見解。
EODAG 可在 PyPI 上使用:
python -m pip 安裝 eodag
以及來自 conda-forge 頻道的conda
:
conda 安裝-c conda-forge eodag
重要的
v3.0.0 中的重大變更:請注意,EODAG 附帶了一組最小的依賴項。如果您需要更多功能,請使用可用的附加功能之一進行安裝。
若要下載,您需要在 eodag 使用者設定檔中填寫所需提供者的憑證。第一次運行時將自動使用空值建立該檔案。
在 Python 程式碼中與 api 互動的範例用法:
from eodag import EODataAccessGatewaydag = EODataAccessGateway()search_results = dag.search(productType='S2_MSI_L1C',geom={'lonmin': 1, 'latmin': 43.5, 'lonmax': 2, 'latmax': 444}}, 接受44}}, 接受WKT 多邊形,shapely.geometry,...start='2021-01-01',end='2021-01-15')product_paths = dag.download_all(search_results)
這將在預設提供者上搜尋 Sentinel 2 1C 級產品,並返回找到的產品首頁以及符合搜尋條件的估計產品總數。然後它會下載這些產品。請查看 Python API 使用者指南以獲取更多詳細資訊。
重要的
v3.0.0 中的重大變更:search() 方法現在只傳回單一SearchResult
而不是 2 個值元組。
eodag 實例可以透過命令列中符合 STAC 的 REST api 公開(需要eodag[server]
):
$ eodag 服務休息 --help 用法:eodag 服務休息 [選項] 啟動 eodag HTTP 伺服器 設定 EODAG_CORS_ALLOWED_ORIGINS 環境變數來設定 Cross- 來源資源共用允許來源作為逗號分隔的 URL(例如「http://somewhere,htttp://somewhere.else」)。 選項: -f, --config PATH 使用者設定檔的檔案路徑及其 憑證,預設為 ~/.config/eodag/eodag.yml -l, --locs PATH shapefile 設定檔位置的檔案路徑 -d, --daemon 以守護程式模式執行 -w, --world 使用 IPv4 0.0.0.0(所有網路介面)來執行 uvicorn, 否則綁定到 127.0.0.1 (localhost)。 -p, --port INTEGER 監聽的連接埠 [預設值: 5000] --debug 以調試模式運行(用於開發目的) --help 顯示此訊息並退出。 jq ".collections[].id""S1_SAR_GRD""S1_SAR_OCN""S1_SAR_SLC""S2_MSI_L1C""S2_MSI_L2A"# 搜尋項目$curl "http://127.0.0.1:5000/search 1,44&日期時間=2018-01-20/2018-01-25" | jq ".numberMatched"6# 取得下載連結$ 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_R137T get "http://127 .0.0.1: 5002/集合/S2_MSI_L1C/專案/S2B_MSIL1C_20240917T115259_N0511_R137_T21CWS_20240917T145134/下載”
eodag-server
可在 https://hub.docker.com/r/csspace/eodag-server 上找到:
docker run -p 5000:5000 --rm csspace/eodag-server:3.0.1
您也可以使用 STAC 瀏覽器瀏覽 STAC API 伺服器。只需運行:
git 克隆 https://github.com/CS-SI/eodag.gitcd eodag docker-compose up# 或更詳細的日誌記錄:EODAG_LOGGING=3 docker-compose up
並瀏覽http://127.0.0.1:5001:
有關更多信息,請參閱 STAC REST API 用法。
開始使用 CLI:
搜尋某些產品:
eodag 搜尋 --productType S2_MSI_L1C --box 1 43 2 44 --開始 2021-03-01 --結束 2021-03-31
search_results.geojson
請求在 2021 年 3 月的給定邊界框中搜尋S2_MSI_L1C
產品類型。
結果是分頁的,您可能想要使用--all
立即取得所有頁面,或使用--cloudCover 20
搜尋具有最大覆蓋率 20% 的產品。有關可用選項的詳細資訊:
eodag 搜尋 --help
要下載上次呼叫搜尋的結果:
eodag 下載 --search-results search_results.geojson
要僅下載上次調用搜尋的結果快速查看:
eodag 下載 --quicklooks --search-results search_results.geojson
要列出所有可用的產品類型和支援的提供者:
電子資料清單
若要列出指定支援的提供者上的可用產品類型:
eodag 列表 -p creodias
要查看所有可用的選項和命令:
eodag——幫助
若要列印日誌訊息,請將-v
新增至 eodag master 指令。例如eodag -v list
。給出的v
越多(最多 3),工具就越詳細。對於完整詳細的輸出,請執行以下操作: eodag -vvv list
您在我們的文件中發現了拼字錯誤嗎?您在執行 EODAG 時是否觀察到錯誤?您對新功能有什麼建議嗎?
不要猶豫,打開問題或提交拉取請求,歡迎貢獻!
有關設定開發環境以及如何為 eodag 做出貢獻的指導,請參閱貢獻指南。
EODAG 根據 Apache License v2.0 授權。有關詳細信息,請參閱許可證文件。
EODAG 由法國 CS GROUP 創建。
EODAG 建構在非常有用的開源專案之上。有關這些項目及其許可證的詳細信息,請參閱 NOTICE 文件。感謝這些項目的所有作者!