الخروج من امتداد EODAG Jupyterlab : eodag-labextension! سيؤدي ذلك إلى توفير واجهة مستخدم سهلة الاستخدام لجهاز الكمبيوتر المحمول الخاص بك ومساعدتك في البحث عن منتجات EO وتصفحها باستخدام eodag
.
EODAG (بوابة الوصول إلى بيانات مراقبة الأرض) هي أداة سطر أوامر وإطار عمل Python موجه نحو البرنامج الإضافي للبحث وتجميع النتائج وتنزيل الصور المستشعرة عن بعد مع تقديم واجهة برمجة تطبيقات موحدة للوصول إلى البيانات بغض النظر عن مزود البيانات. يتمحور EODAG SDK حول ثلاث وظائف:
قائمة أنواع المنتجات: قائمة المنتجات المدعومة ووصفها
البحث عن المنتجات (حسب نوع المنتج أو المعرف الفريد) : يبحث عن المنتجات وفقًا لمعايير البحث المقدمة
تنزيل المنتجات : تنزيل المنتج "كما هو"
تم تطوير EODAG في بايثون. تم تصميمه وفقًا لبنية المكونات الإضافية المعيارية، وهي قابلة للتوسيع بسهولة وقادرة على دمج موفري البيانات الجدد. ثلاثة أنواع من المكونات الإضافية تشكل الأداة:
ملحقات البحث في الكتالوج، المسؤولة عن البحث عن البيانات (البحث المفتوح، CSW، ...)، وبناء المسارات، واسترجاع النظرة السريعة، ودمج النتائج
تنزيل المكونات الإضافية، مما يسمح بتنزيل البيانات واسترجاعها محليًا (عبر FTP، HTTP، ..)، دائمًا بنفس مؤسسة الدليل
مكونات المصادقة الإضافية، والتي تستخدم لمصادقة المستخدم على الخدمات الخارجية المستخدمة (JSON Token، Basic Auth، OAUTH، ...).
نظرًا لأنه يمكن تشغيل الإصدار 2.0 EODAG كعميل أو خادم STAC.
اقرأ الوثائق لمزيد من الأفكار.
EODAG متاح على PyPI:
python -m pip install eodag
ومع conda
من قناة كوندا فورج:
conda install -c conda-forge eodag
مهم
تغيير جذري في الإصدار 3.0.0 : يرجى ملاحظة أن EODAG يأتي مع مجموعة صغيرة من التبعيات. إذا كنت تريد المزيد من الميزات، يرجى التثبيت باستخدام أحد الإضافات المتاحة.
للتنزيل، ستحتاج إلى ملء بيانات الاعتماد الخاصة بك لمقدمي الخدمات المطلوبين في ملف تكوين مستخدم eodag الخاص بك. سيتم إنشاء الملف تلقائيًا بقيم فارغة عند التشغيل الأول.
مثال للاستخدام للتفاعل مع واجهة برمجة التطبيقات في كود Python الخاص بك:
من 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 من المستوى 1C على الموفر الافتراضي وإرجاع الصفحة الأولى للمنتجات التي تم العثور عليها والعدد الإجمالي المقدر للمنتجات المطابقة لمعايير البحث. وبعد ذلك سيتم تنزيل هذه المنتجات. يرجى مراجعة دليل مستخدم Python API لمزيد من التفاصيل.
مهم
تغيير جذري في الإصدار 3.0.0 : تقوم طريقة البحث () الآن بإرجاع SearchResult
واحدة فقط بدلاً من صف من قيمتين.
يمكن عرض مثيل eodag من خلال REST API المتوافق مع STAC من سطر الأوامر (يلزم eodag[server]
):
$ eodag خدمة الراحة --مساعدة الاستخدام: راحة خدمة eodag [خيارات] ابدأ تشغيل خادم eodag HTTP قم بتعيين متغير البيئة EODAG_CORS_ALLOWED_ORIGINS لتكوين Cross- تسمح مشاركة موارد الأصل بالأصول كعناوين URL مفصولة بفواصل (على سبيل المثال "http://somewhere,htttp://somewhere.else"). خيارات: -f, --config مسار ملف PATH إلى ملف تكوين المستخدم به بيانات الاعتماد، الافتراضي هو ~/.config/eodag/eodag.yml -l, --locs مسار ملف PATH إلى ملف تكوين ملفات أشكال الموقع -d, --daemon يعمل في الوضع الخفي -w, --world run uvicorn باستخدام IPv4 0.0.0.0 (جميع واجهات الشبكة)، وإلا قم بالربط بـ 127.0.0.1 (المضيف المحلي). -p, --port INTEGER المنفذ الذي سيتم الاستماع إليه [الافتراضي: 5000] --debug تشغيل في وضع التصحيح (لأغراض التطوير) --help أظهر هذه الرسالة واخرج.# run server$ eodagserve-rest# قائمة أنواع المنتجات المتاحة لـ ``peps`` Provider:$ 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"# البحث عن العناصر$ الضفيرة "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# احصل على رابط التنزيل$ cur "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:
تشغيل عامل الميناء -p 5000:5000 --rm csspace/eodag-server:3.0.1
يمكنك أيضًا تصفح خادم STAC API الخاص بك باستخدام متصفح STAC. ببساطة قم بتشغيل:
استنساخ بوابة 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
يبحث الطلب أعلاه عن أنواع منتجات S2_MSI_L1C
في مربع محيط معين، في مارس 2021. ويحفظ النتائج في ملف GeoJSON ( search_results.geojson
بشكل افتراضي).
تكون النتائج مرقمة، وقد ترغب في الحصول على جميع الصفحات مرة واحدة باستخدام --all
، أو البحث عن منتجات تحتوي على 20% من الحد الأقصى لتغطية الكود باستخدام --cloudCover 20
. لمزيد من المعلومات حول الخيارات المتاحة:
بحث eodag --مساعدة
لتحميل نتيجة الاستدعاء السابق للبحث:
تنزيل eodag --نتائج البحث search_results.geojson
لتنزيل نتائج البحث السريع فقط للمكالمة السابقة للبحث:
تنزيل eodag --quicklooks --نتائج البحث search_results.geojson
لسرد جميع أنواع المنتجات المتاحة ومقدمي الخدمات المدعومين:
قائمة يوداج
لسرد أنواع المنتجات المتاحة على موفر معتمد محدد:
قائمة eodag -p creodias
لرؤية جميع الخيارات والأوامر المتاحة:
يوداج --مساعدة
لطباعة رسائل السجل، أضف -v
إلى أمر eodag الرئيسي. على سبيل المثال eodag -v list
. كلما زاد عدد v
المعطى (حتى 3)، زادت دقة الأداة. للحصول على مخرجات مطولة كاملة، افعل على سبيل المثال: eodag -vvv list
هل لاحظت خطأ مطبعي في وثائقنا؟ هل لاحظت وجود خطأ أثناء تشغيل EODAG؟ هل لديك اقتراح لميزة جديدة؟
لا تتردد وافتح مشكلة أو أرسل طلب سحب، فالمساهمات موضع ترحيب كبير!
للحصول على إرشادات حول إعداد بيئة التطوير وكيفية المساهمة في eodag، راجع إرشادات المساهمة.
EODAG مرخص بموجب ترخيص Apache v2.0. راجع ملف الترخيص للحصول على التفاصيل.
تم إنشاء EODAG بواسطة CS GROUP - فرنسا.
تم بناء EODAG على رأس مشاريع مفتوحة المصدر مفيدة بشكل مثير للدهشة. راجع ملف الإشعار للحصول على تفاصيل حول تلك المشاريع وتراخيصها. شكرا لجميع مؤلفي هذه المشاريع!