Öğeleri yönetme

Earth Engine öğeleri, platformda depolanan ve projeye ait olan coğrafi verilerdir. Kendi verilerinizi yükleyebilir ve Earth Engine analizlerinizden üretilen verileri öğe olarak depolayabilirsiniz.

Öğe türleri

Earth Engine, farklı veri türleri için çeşitli öğe biçimlerinin yanı sıra düzenleme için kapsayıcı öğeler sunar.

Öğe türleri
Image Raster, coğrafi bilgilerin ızgara tabanlı bir temsilidir. Izgaradaki her hücre, Dünya yüzeyindeki belirli bir konuma karşılık gelen bir değer içerir.
ImageCollection Mozaik veya zaman serisi oluşturan ilgili raster resimlerin bir koleksiyonu. İşlevsel olarak bir klasöre benzer ancak filtreleme ve analiz için bir dizi yöntem içeren bir ee.ImageCollection nesnesi olarak Earth Engine'e aktarılabilir.
Table Her biri bir dizi özellik (sütun) içeren vektör özelliklerinden (satır) oluşan bir tablo veri yapısı. Filtreleme ve analiz için bir dizi yöntem içeren ee.FeatureCollection nesnesiyle temsil edilir.
Classifier Eğitilmiş bir Earth Engine makine öğrenimi modeli. Uygulama ve analiz için bir dizi yöntem içeren ee.Classifier nesnesiyle temsil edilir.
FeatureView Earth Engine Uygulamaları'nda kullanılacak bir tablonun görselleştirme görünümü.
Folder Öğeler ve ek klasörler için düzenlemeye yardımcı olan bir kapsayıcı.

Öğe düzenleme

Earth Engine öğeleri, hiyerarşik bir klasör ve koleksiyon sistemi halinde düzenlenir. Yapı, yaygın dosya sistemlerine benzer.

Kök

Öğeler bir Cloud projesine aittir. Proje adı, öğe dizininin kökünü tanımlar. Örneğin, my-project kelimesinin kökü projects/my-project/assets'dir. my-project adlı kullanıcıya ait tüm öğeler projects/my-project/assets klasöründe veya bu klasörün alt klasörlerinden (ya da ImageCollection) birinde yer alır.

Dizin

Earth Engine, öğeleri düzenlemek için ağaç benzeri bir dizin yapısı kullanır. Her Cloud projesinin, ayrı öğeler ve klasörler içerebilen bir kök dizini vardır. ImageCollection'lar, zaman serileri veya mozaikler gibi ilgili resim gruplarını barındırmak için özel olarak tasarlanmış özel bir öğe türüdür. Klasörlerin aksine, ImageCollection'lar yalnızca resim öğeleri içerebilir ve diğer klasörleri veya koleksiyonları içlerinde barındıramaz.

  • folder_dataprojects/my-project/assets/
    • folder klasör-adı/
      • photo image-name
      • view_comfy table-name
      • satellite featureview-name
      • bubble_chart sınıflandırıcı adı
      • photo_library imagecollection-name/
        • photo image-name-1
        • photo image-name-2

Öğe Kimliği

Earth Engine, hem komut dosyalarında hem de komut satırı işlemlerinde verilere referans vermek için öğe kimliklerini kullanır. Öğe konumlarını, dizinler arasında ayırıcı olarak eğik çizgi (/) kullanarak tanımlarlar. Örneğin, projects/my-project/assets/my-asset, "my-project" kök dizininde bulunan "my-asset" adlı bir öğeyi belirtir. Öğe hakkında bilgi edinmek için bu kimliğin nasıl kullanılacağına dair bir örneği aşağıda bulabilirsiniz.

Python

print(ee.data.getAsset('projects/my-project/assets/my-asset'))

Kod Düzenleyici

print(ee.Image('projects/my-project/assets/my-asset'))

Komut satırı

earthengine asset info projects/my-project/assets/my-asset

Öğe oluştur

Klasörler ve ImageCollection'lar oluşturabilir, yerel dosyalardan veya bir Google Cloud Storage paketindeki dosyalardan görüntü ve tabloları içe aktarabilirsiniz. Desteklenen resim biçimleri arasında GeoTIFF ve TFRecord bulunur. Cloud Storage'daki Cloud Optimized GeoTIFF'ler (COG'ler) de içe aktarılmak yerine yerinde kaydedilebilir. Desteklenen tablo biçimleri arasında Shapefile ve CSV bulunur. (Öğeler, toplu işlevler Export.*.toAsset kullanılarak Earth Engine analiz sonucunun dışa aktarılmasıyla da oluşturulabilir).

Python istemcisi

Resim

Cloud Storage'dan görüntüleri almak için ee.data.startIngestion işlevini kullanın. Yüklemeyi yapılandırma hakkında daha fazla bilgi için görüntü manifesti sayfasına bakın.

manifest = {
  'name': 'projects/my-project/assets/asset-name',
  'tilesets': [
    {
      'sources': [
        {
          'uris': [
            'gs://my-bucket/filename.tif'
          ]
        }
      ]
    }
  ]
}
ee.data.startIngestion(None, manifest)

Tablo

Cloud Storage'dan tabloları almak için ee.data.startTableIngestion işlevini kullanın. Yüklemeyi yapılandırma hakkında daha fazla bilgi için görüntü manifesti sayfasına bakın.

manifest = {
  'name': 'projects/my-project/assets/asset-name',
  'sources': [
    {
      'uris': [
        'gs://my-bucket/filename.csv'
      ]
    }
  ]
}
ee.data.startTableIngestion(None, manifest)

Klasör veya ImageCollection

Boş klasörler veya ImageCollection'lar oluşturmak için ee.data.createAsset işlevini kullanın.

ee.data.createAsset(
    {'type': 'FOLDER'}, # or 'IMAGE_COLLECTION'
    'projects/my-project/assets/asset-name'
)

Kod Düzenleyici

Öğe Yöneticisi'nde YENİ düğmesini tıklayın ve açılır listeden yüklemek veya oluşturmak istediğiniz öğe türünü seçin. İletişim kutusunda öğe yükleme veya oluşturma işlemini yapılandırın.

Komut satırı

Resim veya tablo

earthengine upload image --asset_id=projects/my-project/assets/asset-name gs://my-bucket/filename.tif
earthengine upload table --asset_id=projects/my-project/assets/asset-name gs://my-bucket/filename.csv

Klasör veya ImageCollection

Boş klasörler veya ImageCollection'lar oluşturmak için earthengine create komutunu kullanın.

earthengine create folder projects/my-project/assets/folder-name
earthengine create collection projects/my-project/assets/collection-name

Harici resim

Cloud Storage paketindeki Cloud Optimized GeoTIFF (COG) dosyaları, COG destekli öğeler (API'de harici resimler olarak adlandırılır) olarak kaydedilebilir ve doğrudan Earth Engine'de kullanılabilir. Manifest oluşturmak için COG kayıt kılavuzuna bakın.

earthengine upload external_image --manifest /tmp/foo.json

Öğeleri listeleme

Python istemcisi

Bir klasör veya koleksiyondaki öğeleri listelemek için ee.data.listAssets işlevini kullanın (özyinelemeli değil). Filtreleme ve sayfalara ayırma hakkında daha fazla bilgi için referans dokümanlarına bakın.

ee.data.listAssets('projects/my-project/assets')

Ayrıca ee.data.listImages ve ee.data.listFeatures sayfalarına da göz atın.

Kod Düzenleyici

Öğeleri görüntülemek için Öğe Yöneticisi'ndeki klasörleri genişletin.

Komut satırı

Bir klasör veya koleksiyondaki öğeleri listelemek için earthengine ls komutunu kullanın (özyinelemeli değil). Listelenecek öğe sayısını ve döndürülecek ayrıntı miktarını sınırlama hakkında daha fazla bilgi için referans dokümanlarına bakın.

earthengine ls projects/my-project/assets

Öğe izinlerini ayarlama

Python istemcisi

Bir öğe üzerinde izinleri ayarlamak için ee.data.setAssetAcl işlevini kullanın.

asset_id = 'projects/my-project/assets/asset-name'
acl_update = {
    'owners': [
        'user:big_cheese@example.com',
        'user:el_jefe@example.com'
    ],
    'writers': [
        'user:romeo@example.com',
        'user:juliet@example.com'
    ],
    'readers': [
        'group:some-group@googlegroups.com',
        'domain:example.com',
        'serviceAccount:some-project-id@appspot.gserviceaccount.com'
    ],
    'all_users_can_read': False
}
ee.data.setAssetAcl(asset_id, acl_update)

Kod Düzenleyici

Öğe Yöneticisi'nde, işaretçiyi bir öğenin üzerine getirin ve Paylaş simgesi'ni tıklayın. İletişim kutusunda, öğeyi paylaşmak istediğiniz e-posta adresini veya alanı girin, ardından açılır listeden verilecek izin düzeyini seçin. Değişikliği onaylamak için ERİŞİM EKLE düğmesini tıklayın. Herhangi bir tüzel kişiye okuma izni vermek için "Herkes okuyabilir" kutusunu işaretleyin. Ayrıca, açılır listeden uygulamanın adını (etkin Kod Düzenleyici projesine ait öğeler) seçerek iletişim kutusundan Earth Engine uygulamalarına erişim de sağlayabilirsiniz.

Komut satırı

Bir öğenin okuma erişimini public veya private olarak ayarlamak için earthengine acl set komutunu kullanın.

earthengine acl set public projects/my-project/assets/asset-name

Öğe okuma ve yazma için ayrı ayrı izinler ayarlamak üzere earthengine acl ch komutunu kullanın.

earthengine acl ch -u person@gmail.com:R projects/my-project/assets/asset-name

Daha fazla bilgi için komut satırı referansı sayfasına bakın.

Öğe izinlerini kontrol etme

Python istemcisi

Bir öğenin erişim denetimi listesini almak için ee.data.getAssetAcl işlevini kullanın.

ee.data.getAssetAcl('projects/my-project/assets/asset-name')

Kod Düzenleyici

Öğe Yöneticisi'nde, işaretçiyi bir öğenin üzerine getirin ve Paylaş simgesi'ni tıklayın. İletişim kutusunda, e-posta adresleri ve alan adlarının listesi, ilgili erişim düzeyleriyle birlikte gösterilir.

Komut satırı

Bir öğenin erişim denetimi listesini almak için earthengine acl get komutunu kullanın.

earthengine acl get projects/my-project/assets/asset-name

Öğeleri kopyalama

Python istemcisi

Bir öğeyi kopyalamak için ee.data.copyAsset işlevini kullanın.

ee.data.copyAsset('projects/my-project/assets/asset-name', 'projects/my-project/assets/asset-copy-name')

Kod Düzenleyici

Öğeleri kopyalamak için Python istemcisini veya komut satırı aracını kullanın.

Komut satırı

Bir öğeyi kopyalamak için earthengine cp komutunu kullanın.

earthengine cp projects/my-project/assets/asset-name projects/my-project/assets/asset-copy-name

Öğeleri taşıma veya yeniden adlandırma

Python istemcisi

Bir öğeyi taşımak veya yeniden adlandırmak için ee.data.renameAsset işlevini kullanın.

ee.data.renameAsset('projects/my-project/assets/asset-name', 'projects/my-project/assets/new-asset-name')

Kod Düzenleyici

Taşı

Öğe Yöneticisi'nde bir öğeyi yeni bir klasöre sürükleyin.

Yeniden adlandır

Öğe Yöneticisi'nde, işaretçiyi bir öğenin üzerine getirin ve düzenle simgesini tıklayıp düzenlenebilir giriş alanına yeni bir ad yazın.

Komut satırı

Bir öğeyi taşımak veya yeniden adlandırmak için earthengine mv komutunu kullanın.

earthengine mv projects/my-project/assets/asset-name projects/my-project/assets/new-asset-name

Öğeleri silme

Python istemcisi

Bir öğeyi silmek için ee.data.deleteAsset işlevini kullanın.

ee.data.deleteAsset('projects/my-project/assets/asset-name')

Kod Düzenleyici

Öğe iletişim kutusu sayfasını açmak için bir öğeyi, ardından SİL düğmesini tıklayın.

Komut satırı

Bir öğeyi silmek için earthengine rm komutunu kullanın. Yinelemeli ve deneme çalıştırması seçenekleri için işlev referansına bakın.

earthengine rm projects/my-project/assets/asset-name

Öğe meta verilerini görüntüleme

Python istemcisi

Öğe meta verilerini almak için ee.data.getAsset işlevini kullanın.

ee.data.getAsset('projects/my-project/assets/asset-name')

Kod Düzenleyici

Öğe iletişim kutusu sayfasını açmak için bir öğeyi tıklayın. Öğe bilgilerini görüntüleyin.

Komut satırı

Öğe meta verilerini almak için earthengine asset info komutunu kullanın.

earthengine asset info projects/my-project/assets/asset-name

Öğe meta verilerini ayarlama

Aşağıdaki öğe meta verileri ayarlanabilir:

  • start_time
  • end_time

  • properties

Python istemcisi

Öğe meta verilerini güncellemek için ee.data.updateAsset işlevini kullanın.

asset_id = 'projects/my-project/assets/asset-name'
new_metadata = {
  'properties': {
    'name': 'value'
  },
  'start_time': '2024-10-02T15:01:24Z',
  'end_time': '2024-10-02T15:01:25Z',
}
update_these = ['start_time', 'end_time', 'properties']

ee.data.updateAsset(asset_id, new_metadata, update_these)

Kod Düzenleyici

Öğe iletişim kutusu sayfasını açmak için bir öğeyi tıklayın, ardından sağ üstteki düzenleme açma/kapatma düğmesini etkinleştirin. Açıklamayı, özellikleri, başlangıç ve bitiş tarihini düzenleyebilirsiniz. Değişiklikleri kaydetmek için düzenleme düğmesini devre dışı bırakın.

Komut satırı

Öğe meta verilerini güncellemek için earthengine asset set komutunu kullanın. Daha fazla bilgi için referans belgelerine bakın.

earthengine asset set \
  --time_start 2024-10-02T15:01:24 \
  --time_end 2024-10-02T15:01:25 \
  --property 'name=value' \
  projects/my-project/assets/asset-name

Öğe kotasını kontrol etme

Kota, proje düzeyinde uygulanır. Öğe kotası hakkında daha fazla bilgiyi Kullanım ve kota sınırları sayfasında bulabilirsiniz.

Python istemcisi

Bir öğe kökünün depolama alanı kotası kullanımını öğrenmek için ee.data.getAssetRootQuota işlevini kullanın.

ee.data.getAssetRootQuota('projects/my-project/assets')

Kod Düzenleyici

Öğe Yöneticisi'nde, işaretçiyi bir proje kökünün üzerine getirin ve data_usage simgesini tıklayın. Bir bilgi iletişim kutusu gösterilir.

Komut satırı

Öğe kotasını kontrol etmek için Python istemcisini veya Kod Düzenleyici'yi kullanın.