Earth Engine Python API'si, bir Python paketi ve ortam yöneticisi olan conda aracılığıyla yerel bir makineye yüklenebilir. Conda, Anaconda ve Miniconda Python dağıtımlarıyla birlikte sunulur. Anaconda, 1.500'den fazla paket içeren bir veri bilimi programlama platformudur. Miniconda ise yalnızca conda ve bağımlılarını içerir. Bu Python dağıtımlarının her ikisi de Earth Engine API'yi yüklemek ve kullanmak için uygundur. Bu dağıtımlar hakkında bilginiz yoksa daha fazla bilgi edinmek için lütfen bağlantılarını ziyaret edin.
Bu kılavuzda aşağıdaki konularda size yol gösterilmektedir:
- Mevcut bir conda kurulumu olup olmadığını kontrol etme
- conda'yı yerel bir makineye yükleme
- Earth Engine Python API'yi yükleme
- Kimlik doğrulama kimlik bilgilerini ayarlama
- API'yi test etme
conda kurulumunu kontrol etme
Sisteminizde conda zaten yüklüyse API'yi yükleme bölümüne geçin. conda'nın yüklü olup olmadığından emin değilseniz komut satırı arayüzünüzde aşağıdaki komutu girerek doğrulayın.
conda --help
conda yüklüyse ve sistem yolu PATH çevre değişkenine kaydedilmişse conda yardım içeriği terminalde görünür. Yardım içeriği görünürse API'yi yükleme bölümüne atlayın. conda tanınmazsa sonuçta conda bulunamadı veya komut olarak tanınmadı gibi bir ifade gösterilir. Program, sisteminizde mevcut olabilir ancak PATH çevre değişkenine kaydedilmemiş olabilir. Bu durum söz konusu olsa bile, olası tüm sistem yapılandırmalarını ele almak zor olduğundan tutarlılık için lütfen conda'yı yükleme bölümüne geçin. Ana dizininizde "miniconda3" klasörü olmadığı sürece aşağıdaki conda yükleme talimatları başarılı olur. conda yükleme konumu ve kaydı hakkında daha fazla bilgi için lütfen Miniconda Yükleme ve Anaconda Yükleme sayfalarına bakın.
conda'yı yükleme
Bu bölümde, Earth Engine API'ye erişmek için Python platformu olarak kullanılacak Miniconda'yı indirip yükleyeceksiniz. Yukarıda açıklandığı gibi Miniconda veya Anaconda'yı kullanabilirsiniz. Ancak sisteminiz üzerindeki etkiyi en aza indirmek için bu kılavuzda, sisteminizin ortam değişkenlerinde herhangi bir değişiklik yapılmayan bir Miniconda yüklemesi açıklanmaktadır. Anaconda'yı tercih ediyorsanız lütfen buradaki yükleme talimatlarına göz atın ve ardından API'yi yükleme bölümüne atlayın.
Miniconda'yı yükleme
Miniconda'yı indirme ve yükleme işlemi üç adımda gerçekleştirilir:
- 64 bit Python 3 Miniconda yükleyicisini Ana dizininize indirin
- Yükleyiciyi çalıştırma
- Yükleyiciyi silme
Aşağıdaki satırları sisteminize uygun komut satırı arayüzüne kopyalayıp yapıştırarak bu adımları tamamlayın. Yükleme işlemi, Ana dizininize "miniconda3" adlı bir klasör eklenmesine neden olur.
1. Miniconda yükleyicisini ana dizininize indirin.
Linux
wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda.sh
Mac
curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh
Windows
powershell -command "Invoke-WebRequest -Uri https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"
2. Varsayılanları kabul ederek Miniconda'yı ana dizininize sessizce yükleyin.
Linux
bash ~/miniconda.sh -b
Mac
bash ~/miniconda.sh -b
Windows
start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda3
3. Miniconda yükleyicisini Ana dizininizden kaldırın.
Linux
rm ~/miniconda.sh
Mac
rm ~/miniconda.sh
Windows
del %UserProfile%\miniconda.exe
Miniconda yüklemesini test etme
Miniconda yüklemesini test etmek için conda komutunun yardım menüsünü yazdırın.
Miniconda, sisteminizin PATH ortam değişkenine eklenmediğinden, activate komutunu tam sistem yoluyla çağırarak conda'yı bu oturum için etkinleştirmeniz gerekir. Başarılı bir test, terminalde conda yardım içeriklerinin görünmesine neden olur. Sisteminizin komut satırı arayüzünde aşağıdaki satırları çalıştırın.
Linux
source $HOME/miniconda3/bin/activate conda --help
Mac
source $HOME/miniconda3/bin/activate conda --help
Windows
%UserProfile%\miniconda3\condabin\activate conda --help
Miniconda'yı PATH değişkenine ekleme
İsteğe bağlı olarak Miniconda kurulum yolunu sisteminizin PATH değişkenine ekleyebilirsiniz. Bu, activate komutunu tam yoluyla çalıştırmanız gerekmeden conda çağrısı yaparak conda ile etkileşim kurmanıza olanak tanır. Aşağıdaki talimatlarda, Miniconda yüklemesini sisteminizin PATH değişkenine ekleme adımları açıklanmaktadır.
Linux
Aşağıdaki GUI veya komut satırı talimatlarını uygulayarak aşağıdaki yolu "PATH" ortam değişkeninize ekleyin.
$HOME/miniconda3/bin
GUI
1. $HOME dizininizdeki .bashrc dosyasını bir metin düzenleyicide açın.
xdg-open ~/.bashrc
2. Aşağıdaki satırları kopyalayıp dosyanın en altına yapıştırın.
# add path to conda export PATH="$HOME/miniconda3/bin:$PATH"
3. Dosyayı kaydedip metin düzenleyiciyi kapatın.
Komut satırı
~/.bashrc dosyasına conda yolunu eklemek için terminale aşağıdaki komutu girin.
printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc
Mac
Aşağıdaki GUI veya komut satırı talimatlarını uygulayarak aşağıdaki yolu "PATH" ortam değişkeninize ekleyin.
$HOME/miniconda3/bin
GUI
1. $HOME dizininizdeki .bashrc dosyasını bir metin düzenleyicide açın.
touch ~/.bashrc; open -t ~/.bashrc
2. Aşağıdaki satırları kopyalayıp dosyanın en altına yapıştırın.
# add path to conda export PATH="$HOME/miniconda3/bin:$PATH"
3. Dosyayı kaydedip metin düzenleyiciyi kapatın.
Komut satırı
~/.bashrc dosyasına conda yolunu eklemek için terminale aşağıdaki komutu girin.
printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc
Windows
Aşağıdaki GUI veya komut satırı talimatlarını uygulayarak aşağıdaki yolu "Yol" ortam değişkeninize ekleyin.
%UserProfile%\miniconda3\condabin
GUI
1. "Çevre Değişkeni" iletişim kutusunu açmak için komut isteminde aşağıdaki satırı girin.
rundll32 sysdm.cpl,EditEnvironmentVariables
2. "Kullanıcı" bölümünün altındaki "Yol" değişkenini çift tıklayarak düzenleme için seçin.
3. Düzenleyiciyi açmak için yeni "Düzenle" iletişim kutusunda "Metni düzenle" düğmesini tıklayın.
4. Mevcut "Path" değişken değerinin sonuna aşağıdaki dizeyi ekleyin. Giriş, komşu girişlerden ayırt edilebilmesi için noktalı virgülle (;) çevrilmelidir.
%UserProfile%\miniconda3\condabin;
5. Tüm iletişim pencereleri kapanana kadar "Tamam" düğmelerini tıklayın.
Komut satırı
Yolu eklemek için setx komutunu kullanın. Komut isteminde şunu girin:
setx Path "%Path%%UserProfile%\miniconda3\condabin;"
Conda'yı başlatma
Kabuk etkileşimi için conda'yı başlatın. Çeşitli kabuklarda başlatma hakkında bilgi edinmek için aşağıdaki komutu çalıştırın. Komut girildikten sonra konsola yazdırılan talimatları uygulayın.
conda init --help
Komut satırı arayüzünüzü yeniden başlattıktan sonra aşağıdaki komutu kullanarak temel conda ortamını etkinleştirebilirsiniz.
conda activate
Install API
Earth Engine Python API'si, https://anaconda.org/conda-forge/earthengine-api adresinde conda-forge paketi olarak dağıtılır.
conda install komutuyla yüklenir. Ancak yüklemeden önce, özel olarak Earth Engine için bir conda ortamı oluşturun.
Earth Engine API'yi kendi ortamına yüklemek, API'nin ve bağımlı paketlerinin temel ortamınız veya daha önce ayarladığınız diğer ortamlarla ilgili sürüm sorunları oluşturmamasını sağlar. conda ortamlarını yönetme hakkında daha fazla bilgi için lütfen bu siteyi ziyaret edin.
1. Etkin değilse temel conda ortamınızı etkinleştirin.
Linux
source $HOME/miniconda3/bin/activate
Mac
source $HOME/miniconda3/bin/activate
Windows
%UserProfile%\miniconda3\condabin\activate
2. Earth Engine API için bir conda sanal ortamı oluşturun.
conda create --name ee
Ortam oluşturma işlemini onaylamanız istenir. Onay verin.
3. conda ee ortamını etkinleştirin.
conda activate ee
4. API'yi conda ee ortamına yükleyin. Komut satırının başında (ee) simgesi göründüğünden emin olun. Bu, ee ortamında çalıştığınızı gösterir.
conda install -c conda-forge earthengine-api
API'nin ve bağımlılarının yüklenmesini onaylamanız istenir. Onaylama işleminden sonra conda, bağımlılıkları indirip yükler. Her şey yolunda giderse API'ye erişmek için gereken tüm koşulların yanı sıra earthengine komut satırı aracını içeren "ee" adlı bir conda ortamına sahip olursunuz.
Kimlik bilgisi alma
Earth Engine API'yi veya earthengine komut satırı aracını kullanmadan önce, Google Hesabınız adına Earth Engine'e erişim yetkisi veren tek seferlik bir kimlik doğrulama işlemi yapmanız gerekir. Kimlik doğrulama yapmak için earthengine komut satırı aracından authenticate komutunu kullanın.
conda ee ortamınızda aşağıdaki komutu çalıştırın ve görüntülenen basılı talimatları uygulayın. Sözleşmenin ardından bir yetkilendirme kodu oluşturan bir URL sağlanır. Yetkilendirme kodunu kopyalayıp komut satırı girişi olarak girin.
earthengine authenticate
Yetkilendirme kodu girildikten sonra, aşağıda bulunan kimlik bilgileri dosyasına bir yetkilendirme jetonu kaydedilir. API'nin ee.Initialize() komutu ve earthengine komut satırı aracının sonraki kullanımlarında kimlik doğrulaması için bu dosya kullanılır. Yetkilendirmeyi iptal etmek istiyorsanız kimlik bilgileri dosyasını silmeniz yeterlidir.
Linux
ls $HOME/.config/earthengine/credentials
Mac
ls $HOME/.config/earthengine/credentials
Windows
dir %UserProfile%\.config\earthengine\credentials
API'yi test etme
API kurulumunu test etmek için bir DEM veri kümesinin meta verilerini yazdıran basit bir Python komut dosyası çalıştırın. Bu komut, konsola bir JSON nesnesi yazdırır.
1. Conda ee ortamınızdan bir python çevirmeni başlatın.
python
2. DEM veri kümesinin meta verilerini yazdırmak için aşağıdaki Python satırlarını tek tek çalıştırın
import ee # Initialize the Earth Engine module. ee.Initialize() # Print metadata for a DEM dataset. print(ee.Image('USGS/SRTMGL1_003').getInfo())
Sonraki API kullanımı
Earth Engine API'yi kullanmak istediğinizde önce conda ee ortamınızı etkinleştirmeniz gerekir. Etkinleştirme prosedürü, conda'nın kabukta kullanılmak üzere kaydedilip kaydedilmediğine bağlıdır. Aşağıda, conda yüklemenizle ilgili talimatları uygulayın.
Conda kayıtlı değil
Aşağıdaki conda ee ortamı etkinleştirme komutu, conda'nın yukarıdaki Conda'yı yükleme bölümündeki talimatlara göre yüklendiğini varsayar. Yani yükleme yolu, önceki adımlara göre varsayılır. Komut satırı arayüzünde aşağıdaki komutu çalıştırın.
Linux
source $HOME/miniconda3/bin/activate ee
Mac
source $HOME/miniconda3/bin/activate ee
Windows
%UserProfile%\miniconda3\condabin\activate ee
Conda kayıtlı
Aşağıdaki conda ee ortamı etkinleştirme komutu, conda'nın bu kılavuzun talimatları veya başka yöntemler aracılığıyla kabukta ya da komut isteminde kullanılmak üzere kaydedildiğini varsayar. Komut satırı arayüzünde aşağıdaki komutu çalıştırın.
conda activate ee
Komutu çalıştırdıktan sonra komut satırının başında (ee) simgesini görürsünüz. Bu, ee ortamında çalıştığınızı gösterir.
Artık bir Python yorumlayıcısı başlatmaya ve Earth Engine Python API'ye erişmeye hazırsınız. Python API ile çalışmayla ilgili genel bilgiler için lütfen Python Yükleme sayfasına bakın.
API'yi güncelleme
ee ortamınızı en son API sürümüne güncellemek için conda update komutunu kullanın. Henüz etkin değilse önce conda ee ortamınızı etkinleştirmeyi unutmayın.
conda update -c conda-forge earthengine-api
eekönyvtár __version__ mülkünü yazdırarak Python'da şu anda yüklü sürüm numarasını alın. ee conda ortamı komut satırına python yazıp ardından aşağıdaki komutları girerek bir Python yorumlayıcısı başlatın.
import ee print(ee.__version__)
ee ortamınızı paylaşma
Özellikle ek Python paketleri yüklediyseniz yeniden üretilebilir ve tekrarlanabilir sonuçlar elde etmek için conda Python ortamınızı başkalarıyla paylaşmanız yararlı olabilir. Conda, diğer kullanıcıların ortamınızı kopyalamasına uygun bir yol sağlar.
conda ee ortamınızda, "ee-shared-env" adlı bir YAML dosyasını ana dizininize kaydetmek için aşağıdaki komutu çalıştırın. Bu dosya, ortam özelliklerinizi listeler.
Linux
conda env export > $HOME/ee-shared-env.yml
Mac
conda env export > $HOME/ee-shared-env.yml
Windows
conda env export > %UserProfile%\ee-shared-env.yml
Ortaya çıkan dosyayı paylaşın. Alıcı, aşağıdaki conda komutunu çalıştırarak ortamı kopyalayabilir.
conda env create -f path-to-ee-shared-env.yml