eodag
v3.0.1
Consulte la extensión EODAG Jupyterlab : ¡eodag-labextension! Esto traerá una interfaz de usuario amigable a su computadora portátil y lo ayudará a buscar y explorar productos EO usando eodag .
EODAG (Gateway de acceso a datos de observación de la Tierra) es una herramienta de línea de comandos y un marco de Python orientado a complementos para buscar, agregar resultados y descargar imágenes de sensores remotos, al tiempo que ofrece una API unificada para el acceso a datos independientemente del proveedor de datos. El SDK de EODAG se estructura en torno a tres funciones:
Listar tipos de productos: lista de productos compatibles y su descripción
Buscar productos (por tipo de producto o uid): busca productos según los criterios de búsqueda proporcionados
Descargar productos: descargar el producto "tal cual"
EODAG está desarrollado en Python. Está estructurado según una arquitectura de complementos modular, fácilmente extensible y capaz de integrar nuevos proveedores de datos. Tres tipos de complementos componen la herramienta:
Complementos de búsqueda de catálogo, responsables de buscar datos (OpenSearch, CSW, ...), crear rutas, recuperar Quicklook y combinar resultados.
Descargar complementos, que permiten descargar y recuperar datos localmente (vía FTP, HTTP, ..), siempre con la misma organización de directorios.
Complementos de autenticación, que se utilizan para autenticar al usuario en los servicios externos utilizados (JSON Token, Basic Auth, OAUTH, ...).
Desde la versión 2.0, EODAG se puede ejecutar como cliente o servidor STAC.
Lea la documentación para obtener más información.
EODAG está disponible en PyPI:
python -m pip instalar eodag
Y con conda del canal conda-forge:
instalación de conda -c conda-forge eodag
Importante
Cambio importante en v3.0.0 : tenga en cuenta que EODAG viene con un conjunto mínimo de dependencias. Si desea obtener más funciones, instálela utilizando uno de los extras disponibles.
Para descargar, deberá completar sus credenciales para los proveedores deseados en su archivo de configuración de usuario de eodag. El archivo se creará automáticamente con valores vacíos en la primera ejecución.
Uso de ejemplo para interactuar con la API en su código Python:
de eodag import EODataAccessGatewaydag = EODataAccessGateway()search_results = dag.search(productType='S2_MSI_L1C',geom={'lonmin': 1, 'latmin': 43.5, 'lonmax': 2, 'latmax': 44}, # acepta Polígonos WKT, geometría bien formada, ...start='2021-01-01',end='2021-01-15')product_paths = dag.download_all(search_results)Esto buscará productos Sentinel 2 nivel 1C en el proveedor predeterminado y devolverá la primera página de productos encontrados y una cantidad total estimada de productos que coinciden con los criterios de búsqueda. Y luego descargará estos productos. Consulte la Guía del usuario de la API de Python para obtener más detalles.
Importante
Cambio importante en v3.0.0 : el método search() ahora devuelve solo un único SearchResult en lugar de una tupla de 2 valores.
Una instancia de eodag se puede exponer a través de una API REST compatible con STAC desde la línea de comando (se necesita eodag[server] ):
$ eodag servir-descansar --ayuda
Uso: eodag servir-descansar [OPCIONES]
Inicie el servidor HTTP eodag
Establezca la variable de entorno EODAG_CORS_ALLOWED_ORIGINS para configurar Cross-
Origin Resource Sharing permitía orígenes como URL separadas por comas (por ejemplo, 'http://somewhere,htttp://somewhere.else').
Opciones:
-f, --config PATH Ruta del archivo al archivo de configuración del usuario con su
credenciales, el valor predeterminado es ~/.config/eodag/eodag.yml
-l, --locs PATH Ruta del archivo a la ubicación del archivo de configuración de shapefiles
-d, --daemon se ejecuta en modo demonio
-w, --world ejecuta uvicorn usando IPv4 0.0.0.0 (todas las interfaces de red),
de lo contrario, vincúlese a 127.0.0.1 (localhost).
-p, --port INTEGER El puerto en el que escuchar [predeterminado: 5000]
--debug Ejecutar en modo de depuración (para fines de desarrollo)
--help Muestra este mensaje y sale.# ejecuta server$ eodag save-rest# lista los tipos de productos disponibles para el proveedor ``peps``:$ 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"# buscar artículos$ 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# obtener enlace de descarga$ 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/descargar"# descargar$ wget "http://127.0.0.1:5002/collections/S2_MSI_L1C/items/S2B_MSIL1C_20240917T115259_N0511_R137_T21CWS_20240917T145134/descargar" eodag-server está disponible en https://hub.docker.com/r/csspace/eodag-server:
ejecución de la ventana acoplable -p 5000:5000 --rm csspace/eodag-server:3.0.1
También puede navegar por su servidor API STAC utilizando STAC Browser. Simplemente ejecuta:
clon de git https://github.com/CS-SI/eodag.gitcd eodag docker-compose up# o para un registro más detallado:EODAG_LOGGING=3 docker-compose up
Y navega por http://127.0.0.1:5001:
Para obtener más información, consulte Uso de la API STAC REST.
Comience a jugar con la CLI:
Para buscar algunos productos:
Búsqueda de eodag --productType S2_MSI_L1C --box 1 43 2 44 --start 2021-03-01 --end 2021-03-31
La solicitud anterior busca tipos de productos S2_MSI_L1C en un cuadro delimitador determinado, en marzo de 2021. Guarda los resultados en un archivo GeoJSON ( search_results.geojson de forma predeterminada).
Los resultados están paginados, es posible que desee obtener todas las páginas a la vez con --all o buscar productos que tengan el 20 % de la cobertura máxima posible con --cloudCover 20 . Para obtener más información sobre las opciones disponibles:
búsqueda eodag --ayuda
Para descargar el resultado de la llamada anterior a buscar:
descarga de eodag --search-results search_results.geojson
Para descargar solo los resultados de la llamada anterior a la búsqueda:
descarga de eodag --quicklooks --search-results search_results.geojson
Para enumerar todos los tipos de productos disponibles y proveedores compatibles:
lista de mensajes electrónicos
Para enumerar los tipos de productos disponibles en un proveedor compatible específico:
lista eodag -p creodias
Para ver todas las opciones y comandos disponibles:
eodag --ayuda
Para imprimir mensajes de registro, agregue -v al comando eodag master. por ejemplo, eodag -v list . Cuanto más v se dé (hasta 3), más detallada será la herramienta. Para obtener una salida completa y detallada, haga por ejemplo: eodag -vvv list
¿Has detectado un error tipográfico en nuestra documentación? ¿Ha observado algún error al ejecutar EODAG? ¿Tiene alguna sugerencia para una nueva característica?
No lo dude y abra una incidencia o envíe una solicitud de extracción. ¡Las contribuciones son bienvenidas!
Para obtener orientación sobre cómo configurar un entorno de desarrollo y cómo hacer una contribución a eodag, consulte las pautas de contribución.
EODAG tiene la licencia Apache v2.0. Consulte el archivo de LICENCIA para obtener más detalles.
EODAG ha sido creado por CS GROUP - Francia.
EODAG se basa en proyectos de código abierto increíblemente útiles. Consulte el archivo AVISO para obtener detalles sobre esos proyectos y sus licencias. ¡Gracias a todos los autores de estos proyectos!
