EODAG Jupyterlab 확장 프로그램을 확인하세요: eodag-labextension! 그러면 노트북에 친숙한 UI가 추가되고 eodag
사용하여 EO 제품을 검색하고 찾아볼 수 있습니다.
EODAG(Earth Observation Data Access Gateway)는 데이터 공급자에 관계없이 데이터 액세스를 위한 통합 API를 제공하는 동시에 검색, 결과 집계 및 원격 감지 이미지 다운로드를 위한 명령줄 도구이자 플러그인 지향 Python 프레임워크입니다. EODAG SDK는 다음 세 가지 기능으로 구성됩니다.
제품 유형 나열: 지원되는 제품 목록 및 설명
상품 검색(상품 유형 또는 uid별) : 제공된 검색 조건에 따라 상품을 검색합니다.
제품 다운로드 : 제품을 "있는 그대로" 다운로드합니다.
EODAG는 Python으로 개발되었습니다. 이는 모듈식 플러그인 아키텍처에 따라 구조화되어 있으며 쉽게 확장 가능하고 새로운 데이터 제공자를 통합할 수 있습니다. 세 가지 유형의 플러그인이 도구를 구성합니다.
데이터 검색(OpenSearch, CSW 등), 경로 작성, Quicklook 검색, 결과 결합을 담당하는 카탈로그 검색 플러그인
항상 동일한 디렉터리 구성을 사용하여 로컬(FTP, HTTP 등을 통해)로 데이터를 다운로드하고 검색할 수 있는 플러그인 다운로드
사용되는 외부 서비스(JSON 토큰, 기본 인증, OAUTH 등)에서 사용자를 인증하는 데 사용되는 인증 플러그인입니다.
v2.0부터 EODAG는 STAC 클라이언트 또는 서버로 실행될 수 있습니다.
더 많은 통찰력을 얻으려면 설명서를 읽어보세요.
EODAG는 PyPI에서 사용할 수 있습니다:
python -m pip 설치 eodag
그리고 conda-forge 채널의 conda
사용하면 다음과 같습니다.
conda install -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': 44}, # 허용 WKT 다각형, 매끈한 기하학, ...start='2021-01-01',end='2021-01-15')product_paths = dag.download_all(search_results)
그러면 기본 공급자에서 Sentinel 2 level-1C 제품을 검색하고 발견된 제품 첫 번째 페이지와 검색 기준과 일치하는 예상 총 제품 수를 반환합니다. 그런 다음 이러한 제품을 다운로드합니다. 자세한 내용은 Python API 사용자 가이드를 확인하세요.
중요한
v3.0.0의 주요 변경 사항: search() 메서드는 이제 2개의 값 튜플 대신 단일 SearchResult
만 반환합니다.
eodag 인스턴스는 명령줄에서 STAC 호환 REST API를 통해 노출될 수 있습니다( eodag[server]
필요).
$ eodag 서버-레스트 --help 사용법: eodag Serve-Rest [OPTIONS] eodag HTTP 서버 시작 EODAG_CORS_ALLOWED_ORIGINS 환경 변수를 설정하여 교차 구성 원본 리소스 공유는 쉼표로 구분된 URL(예: 'http://somewhere,htttp://somewhere.else')로 원본을 허용했습니다. 옵션: -f, --config PATH 사용자 구성 파일에 대한 파일 경로입니다. 자격 증명, 기본값은 ~/.config/eodag/eodag.yml입니다. -l, --locs PATH 위치 Shapefiles 구성 파일에 대한 파일 경로 -d, --daemon 데몬 모드로 실행 -w, --world IPv4 0.0.0.0(모든 네트워크 인터페이스)을 사용하여 uvicorn을 실행합니다. 그렇지 않으면 127.0.0.1(localhost)에 바인딩합니다. -p, --port INTEGER 수신할 포트 [기본값: 5000] --debug 디버그 모드에서 실행(개발 목적) --help 이 메시지를 표시하고 종료합니다.# run server$ eodag Serve-rest# ``peps``에 사용 가능한 제품 유형을 나열합니다. 공급자:$ 컬 "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"# 항목 검색$ 컬 "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# 다운로드 링크 가져오기$ 컬 "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"# 다운로드$ wget "http://127.0.0.1:5002/collections/S2_MSI_L1C/items/S2B_MSIL1C_20240917T115259_N0511_R137_T21CWS_20240917T145134/download"
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 서버를 탐색할 수도 있습니다. 간단히 실행하세요:
자식 클론 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 --start 2021-03-01 --end 2021-03-31
위 요청은 2021년 3월에 지정된 경계 상자에서 S2_MSI_L1C
제품 유형을 검색합니다. 결과는 GeoJSON 파일(기본적으로 search_results.geojson
)에 저장됩니다.
결과는 페이지로 매겨집니다. --all
사용하여 모든 페이지를 한 번에 가져오거나 --cloudCover 20
사용하여 최대 적용 범위의 20%에 해당하는 제품을 검색할 수 있습니다. 사용 가능한 옵션에 대한 자세한 내용은 다음을 참조하세요.
eodag 검색 --help
이전 검색 호출의 결과를 다운로드하려면:
eodag 다운로드 --search-results search_results.geojson
이전 검색 호출의 결과 Quicklook만 다운로드하려면 다음을 수행하세요.
eodag 다운로드 --quicklooks --search-results search_results.geojson
사용 가능한 모든 제품 유형 및 지원되는 공급자를 나열하려면 다음을 수행하십시오.
어다그 목록
지정된 지원 제공업체에서 사용 가능한 제품 유형을 나열하려면 다음을 수행하세요.
eodag 목록 -p creodias
사용 가능한 모든 옵션과 명령을 보려면:
eodag --help
로그 메시지를 인쇄하려면 eodag master 명령에 -v
추가하세요. 예: eodag -v list
. v
더 많이 제공될수록(최대 3개) 도구가 더 장황해집니다. 전체 자세한 출력을 보려면 다음을 수행하십시오. eodag -vvv list
우리 문서에서 오타를 발견하셨나요? EODAG를 실행하는 동안 버그를 발견하셨나요? 새로운 기능에 대한 제안이 있나요?
주저하지 말고 문제를 공개하거나 끌어오기 요청을 제출하세요. 기여를 환영합니다!
개발 환경 설정 및 eodag에 기여하는 방법에 대한 지침은 기여 지침을 참조하세요.
EODAG는 Apache License v2.0에 따라 라이센스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.
EODAG는 프랑스 CS GROUP에 의해 만들어졌습니다.
EODAG는 놀랍도록 유용한 오픈 소스 프로젝트를 기반으로 구축되었습니다. 해당 프로젝트 및 라이선스에 대한 자세한 내용은 NOTICE 파일을 참조하세요. 이 프로젝트의 모든 작성자에게 감사드립니다!