eodag
v3.0.1
Lihat ekstensi EODAG Jupyterlab : eodag-labextension! Ini akan menghadirkan UI yang ramah ke buku catatan Anda dan membantu Anda mencari dan menelusuri produk EO menggunakan eodag .
EODAG (Gerbang Akses Data Observasi Bumi) adalah alat baris perintah dan kerangka kerja Python berorientasi plugin untuk mencari, menggabungkan hasil, dan mengunduh gambar penginderaan jauh sambil menawarkan API terpadu untuk akses data apa pun penyedia datanya. EODAG SDK disusun berdasarkan tiga fungsi:
Daftar jenis produk: daftar produk yang didukung dan deskripsinya
Pencarian produk (berdasarkan jenis produk atau uid): mencari produk sesuai dengan kriteria pencarian yang disediakan
Unduh produk : unduh produk “sebagaimana adanya"
EODAG dikembangkan dengan Python. Ini disusun berdasarkan arsitektur plugin modular, mudah diperluas dan mampu mengintegrasikan penyedia data baru. Tiga jenis plugin menyusun alat ini:
Plugin pencarian katalog, bertanggung jawab untuk mencari data (OpenSearch, CSW, ...), membangun jalur, mengambil quicklook, menggabungkan hasil
Unduh plugin, memungkinkan untuk mengunduh dan mengambil data secara lokal (melalui FTP, HTTP, ..), selalu dengan organisasi direktori yang sama
Plugin otentikasi, yang digunakan untuk mengautentikasi pengguna pada layanan eksternal yang digunakan (JSON Token, Basic Auth, OAUTH, ...).
Sejak v2.0 EODAG dapat dijalankan sebagai klien atau server STAC.
Baca dokumentasi untuk wawasan lebih lanjut.
EODAG tersedia di PyPI:
python -m pip instal eodag
Dan dengan conda dari saluran conda-forge:
conda install -c conda-forge eodag
Penting
Perubahan besar di v3.0.0 : Harap dicatat bahwa EODAG hadir dengan serangkaian dependensi minimal. Jika Anda menginginkan lebih banyak fitur, silakan instal menggunakan salah satu tambahan yang tersedia.
Untuk mengunduh, Anda perlu mengisi kredensial Anda untuk penyedia yang diinginkan di file konfigurasi pengguna eodag Anda. File akan secara otomatis dibuat dengan nilai kosong saat pertama kali dijalankan.
Contoh penggunaan untuk berinteraksi dengan api dalam kode Python Anda:
dari eodag import EODataAccessGatewaydag = EODataAccessGateway()search_results = dag.search(productType='S2_MSI_L1C',geom={'lonmin': 1, 'latmin': 43.5, 'lonmax': 2, 'latmax': 44}, # menerima Poligon WKT, indah.geometri, ...mulai='01-01-2021',akhir='15-01-2021')jalur_produk = dag.download_all(hasil_pencarian)Ini akan mencari produk Sentinel 2 level-1C pada penyedia default dan mengembalikan halaman pertama produk yang ditemukan serta perkiraan jumlah total produk yang cocok dengan kriteria pencarian. Dan kemudian ia akan mengunduh produk-produk ini. Silakan periksa Panduan Pengguna Python API untuk lebih jelasnya.
Penting
Perubahan besar di v3.0.0 : metode search() sekarang hanya mengembalikan satu SearchResult bukan tupel 2 nilai.
Instance eodag dapat diekspos melalui api REST yang sesuai dengan STAC dari baris perintah ( eodag[server] diperlukan):
$ eodag sajikan-istirahat --bantuan
Penggunaan: eodag serve-rest [PILIHAN]
Mulai server HTTP eodag
Tetapkan variabel lingkungan EODAG_CORS_ALLOWED_ORIGINS untuk mengonfigurasi Cross-
Berbagi Sumber Daya Asal mengizinkan asal sebagai URL yang dipisahkan koma (misalnya 'http://somewhere,htttp://somewhere.else').
Pilihan:
-f, --config PATH File path ke file konfigurasi pengguna dengan nya
kredensial, defaultnya adalah ~/.config/eodag/eodag.yml
-l, --locs PATH File jalur ke lokasi file konfigurasi shapefile
-d, --daemon dijalankan dalam mode daemon
-w, --world menjalankan uvicorn menggunakan IPv4 0.0.0.0 (semua antarmuka jaringan),
jika tidak, ikat ke 127.0.0.1 (localhost).
-p, --port INTEGER Port untuk mendengarkan [default: 5000]
--debug Jalankan dalam mode debug (untuk tujuan pengembangan)
--help Tampilkan pesan ini dan keluar.# jalankan server$ eodag serve-rest# daftar jenis produk yang tersedia untuk ``peps`` penyedia:$ 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"# mencari item$ curl "http://127.0.0.1:5000/search?collections=S2_MSI_L1C&bbox=0,43,1,44&datetime=2018-01-20/25-01-2018" | jq ".numberMatched"6# dapatkan tautan unduh$ 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"# unduh$ wget "http://127.0.0.1:5002/collections/S2_MSI_L1C/items/S2B_MSIL1C_20240917T115259_N0511_R137_T21CWS_20240917T145134/unduh" eodag-server tersedia di https://hub.docker.com/r/csspace/eodag-server:
menjalankan buruh pelabuhan -p 5000:5000 --rm csspace/eodag-server:3.0.1
Anda juga dapat menelusuri server STAC API Anda menggunakan STAC Browser. Cukup jalankan:
git klon https://github.com/CS-SI/eodag.gitcd eodag docker-compose up# atau untuk logging yang lebih panjang: EODAG_LOGGING=3 docker-compose up
Dan telusuri http://127.0.0.1:5001:
Untuk informasi selengkapnya, lihat Penggunaan STAC REST API.
Mulai bermain dengan CLI:
Untuk mencari beberapa produk:
pencarian eodag --productType S2_MSI_L1C --box 1 43 2 44 --mulai 01-03-2021 --akhir 31-03-2021
Permintaan di atas mencari jenis produk S2_MSI_L1C dalam kotak pembatas tertentu, pada bulan Maret 2021. Permintaan ini menyimpan hasilnya dalam file GeoJSON ( search_results.geojson secara default).
Hasil diberi nomor halaman, Anda mungkin ingin mendapatkan semua halaman sekaligus dengan --all , atau mencari produk yang memiliki cakupan maksimum 20% dengan --cloudCover 20 . Untuk informasi lebih lanjut tentang opsi yang tersedia:
pencarian eodag --membantu
Untuk mengunduh hasil panggilan pencarian sebelumnya:
unduhan eodag --hasil pencarian search_results.geojson
Untuk mengunduh hanya hasil tampilan cepat dari panggilan pencarian sebelumnya:
unduh eodag --quicklooks --hasil pencarian search_results.geojson
Untuk mencantumkan semua jenis produk yang tersedia dan penyedia yang didukung:
daftar eodag
Untuk mencantumkan jenis produk yang tersedia pada penyedia tertentu yang didukung:
daftar eodag -p kredodia
Untuk melihat semua opsi dan perintah yang tersedia:
eodag --membantu
Untuk mencetak pesan log, tambahkan -v ke perintah master eodag. misalnya eodag -v list . Semakin banyak v yang diberikan (sampai 3), semakin verbose alat tersebut. Untuk keluaran verbose lengkap, lakukan misalnya: eodag -vvv list
Pernahkah Anda melihat kesalahan ketik dalam dokumentasi kami? Pernahkah Anda mengamati bug saat menjalankan EODAG? Apakah Anda punya saran untuk fitur baru?
Jangan ragu dan buka terbitan atau kirimkan permintaan penarikan, kontribusi dipersilahkan!
Untuk panduan dalam menyiapkan lingkungan pengembangan dan cara memberikan kontribusi pada eodag, lihat pedoman kontribusi.
EODAG dilisensikan di bawah Lisensi Apache v2.0. Lihat file LISENSI untuk detailnya.
EODAG dibuat oleh CS GROUP - Perancis.
EODAG dibangun di atas proyek sumber terbuka yang sangat berguna. Lihat file PEMBERITAHUAN untuk detail tentang proyek tersebut dan lisensinya. Terima kasih kepada semua penulis proyek ini!
