Earth Engine Python API, Python paket ve ortam yöneticisi olan conda aracılığıyla yerel bir makineye yüklenebilir. Conda, Anaconda ve Miniconda Python dağıtımlarıyla birlikte gelir. Anaconda, 1.500'den fazla paket içeren bir veri bilimi programlama platformudur. Miniconda ise yalnızca conda'yı ve bağımlılıklarını içerir. Bu Python dağıtımlarından herhangi biri, Earth Engine API'yi yüklemek ve API ile çalışmak için uygundur. Bu dağıtımlara aşina değilseniz daha fazla bilgi edinmek için lütfen bağlantılarını ziyaret edin.
Bu rehberde aşağıdaki konular ele alınmaktadır:
- Mevcut bir Conda yüklemesi olup olmadığını kontrol etme
- Conda'yı yerel makineye yükleme
- Earth Engine Python API'yi yükleme
- Kimlik doğrulama bilgilerini ayarlama
- API'yi test etme
conda install komutunun kullanılıp kullanılmadığını kontrol edin.
Sisteminizde conda zaten yüklüyse API'yi yükleme bölümüne geçin. Conda'nın yüklendiğinden emin değilseniz komut satırı arayüzünüze aşağıdaki komutu girerek doğrulayın.
conda --help
Conda yüklüyse ve sistem yolu PATH ortam değişkenine kaydedilmişse conda yardım içerikleri terminalde görünür. Yardım içerikleri görünürse Install API bölümüne geçin. Conda tanınmıyorsa sonuç aşağıdaki gibi olacaktır: conda not found or not recognized as a command (conda bulunamadı veya komut olarak tanınmadı). Program sisteminizde bulunuyor ancak PATH ortam değişkenine kaydedilmemiş olabilir. Bu durum geçerli olsa bile tutarlılık açısından lütfen Install conda (conda'yı yükleme) bölümüne devam edin. Çünkü olası tüm sistem yapılandırmalarını ele almak zordur. Ana klasörünüzde "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ılmadan Miniconda'nın nasıl yükleneceği açıklanmaktadır. Anaconda'yı tercih ediyorsanız lütfen burada verilen yükleme talimatlarına bakın ve ardından API'yi yükleme bölümüne geçin.
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ırın
- Yükleyiciyi silme
Aşağıdaki satırları sisteminiz için uygun komut satırı arayüzüne kopyalayıp yapıştırarak bu adımları tamamlayın. Kurulum sonucunda Ana dizininize "miniconda3" adlı bir klasör eklenir.
1. Miniconda yükleyiciyi 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. Miniconda'yı varsayılan ayarları kabul ederek 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ükleyiciyi 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 öncelikle activate komutunu tam sistem yoluyla çağırarak bu oturum için conda'yı etkinleştirmeniz gerekir. Başarılı bir test sonucunda terminalde conda yardım içerikleri gösterilir. Sisteminize ait 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
PATH değişkenine Miniconda'yı ekleme
İsteğe bağlı olarak Miniconda yükleme yolunu sisteminizin PATH değişkenine ekleyebilirsiniz. Bu sayede, önce activate komutunu tam yoluyla çalıştırmanıza gerek kalmadan conda komutunu basit bir çağrıyla çalıştırarak conda ile etkileşim kurabilirsiniz. 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 "PATH" ortam değişkeninize aşağıdaki yolu ekleyin.
$HOME/miniconda3/bin
GUI
1. $HOME dizininizde bulunan .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ı kaydedin ve metin düzenleyiciyi kapatın.
Komut satırı
Conda yolunu ~/.bashrc dosyasına eklemek için terminalde 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 "PATH" ortam değişkeninize aşağıdaki yolu ekleyin.
$HOME/miniconda3/bin
GUI
1. $HOME dizininizde bulunan .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ı kaydedin ve metin düzenleyiciyi kapatın.
Komut satırı
Conda yolunu ~/.bashrc dosyasına eklemek için terminalde 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 "Path" ortam değişkeninize aşağıdaki yolu ekleyin.
%UserProfile%\miniconda3\condabin
GUI
1. "Ortam Değişkeni" iletişim kutusunu açmak için komut istemine aşağıdaki satırı girin.
rundll32 sysdm.cpl,EditEnvironmentVariables
2. Düzenlemek için "Kullanıcı" bölümündeki "Yol" değişkenini çift tıklayarak seçin.
3. Düzenleyiciyi açmak için yeni "Düzenle" iletişim penceresinde "Metni düzenle" düğmesini tıklayın.
4. Mevcut "Yol" değişken değerinin sonuna aşağıdaki dizeyi ekleyin. Girişi noktalı virgüllerle (;) çevreleyerek komşu girişlerden ayırt edin.
%UserProfile%\miniconda3\condabin;
5. Tüm iletişim kutuları kapanana kadar "Tamam" düğmelerini tıklayın.
Komut satırı
Yolu eklemek için setx komutunu kullanın. Komut istemine ş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 sonraki talimatları uygulayın.
conda init --help
Komut satırı arayüzünüzü yeniden başlattıktan sonra, aşağıdaki komutla temel conda ortamını etkinleştirebilirsiniz.
conda activate
Install API
Earth Engine Python API, şu adreste conda-forge paketi olarak dağıtılır:
https://anaconda.org/conda-forge/earthengine-api.
conda install komutuyla yüklenir. Ancak yüklemeden önce Earth Engine için özel bir conda ortamı oluşturun.
Earth Engine API'yi kendi ortamına yüklemek, API'nin ve bağımlı paketlerinin temel ortamınızda veya daha önce ayarladığınız diğer ortamlarda sürüm oluşturma sorunlarına neden olmamasını sağlar. Conda ortamlarını yönetme hakkında daha fazla bilgi için lütfen bu siteyi ziyaret edin.
1. Henüz etkinleştirmediyseniz 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ın oluşturulmasını onaylamanız istenir. Onaylayın.
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)
işaretinin göründüğünden emin olun. Bu işaret, ee ortamında çalıştığınızı gösterir.
conda install -c conda-forge earthengine-api
API'nin ve bağımlılıklarının yüklenmesini onaylamanız istenir. Onaylamanın ardından conda, bağımlılıkları indirip yükler. Her şey yolunda giderse artık API'ye erişmek için gereken tüm koşulları karşılayan ve earthengine komut satırı aracını içeren "ee" adlı bir conda ortamınız olur.
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şimi yetkilendiren tek seferlik bir kimlik doğrulama işlemi yapmanız gerekir. Kimlik doğrulamak 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 sonuç olarak yazdırılan talimatları uygulayın. Sözleşme imzalandıktan sonra yetkilendirme kodu oluşturan bir URL sağlanır. Yetkilendirme kodunu kopyalayın ve komut satırı girişi olarak girin.
earthengine authenticate
Yetkilendirme kodu girildiğinde, yetkilendirme jetonu aşağıdaki kimlik bilgileri dosyasına kaydedilir. API'lerin ee.Initialize() komutu ve earthengine komut satırı aracının sonraki kullanımlarında kimlik doğrulama için bu dosya aranır. Yetkiyi 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. Konsola bir JSON nesnesi yazdırmalıdır.
1. Conda ee ortamınızdan bir python yorumlayıcısı başlatın.
python
2. Bir 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 komutunda, conda'nın yukarıdaki Conda'yı yükleme bölümündeki talimatlara göre yüklendiği varsayılır. Yani yükleme yolunun önceki adımlara göre belirlendiği 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 kabukta veya komut isteminde kullanılmak üzere bu kılavuzdaki talimatlar veya başka yollarla 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örmeniz gerekir. Bu simge, 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ışma hakkında genel bilgi için lütfen Python yükleme sayfasına bakın.
API'yi güncelleme
conda update komutunu kullanarak ee ortamınızı en yeni API sürümüne güncelleyin. conda ee ortamınız zaten etkin değilse önce etkinleştirmeyi unutmayın.
conda update -c conda-forge earthengine-api
ee
kitaplık __version__ özelliğini yazdırarak Python'da yüklü olan sürüm numarasını alın. ee conda ortamı komut satırına python girerek bir Python yorumlayıcısı başlatın ve ardından aşağıdaki komutları girin.
import ee print(ee.__version__)
ee ortamınızı paylaşma
Özellikle ek Python paketleri yüklediyseniz tekrarlanabilir ve kopyalanabilir 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ı için uygun bir yöntem sunar.
Conda ee ortamınızda, ortam spesifikasyonlarınızı listeleyen "ee-shared-env" adlı bir YAML dosyasını ana dizininize kaydetmek için aşağıdaki komutu çalıştırın.
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
Elde edilen 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