Öğeleri yönetme

Earth Engine öğeleri, platformda depolanan projeye ait 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ı öğeleri sunar.

Öğe türleri
Image Raster, ızgaradaki her hücrenin Dünya yüzeyindeki belirli bir konuma karşılık gelen bir değer tuttuğu, coğrafi bilgilerin ızgara tabanlı bir temsilidir.
ImageCollection Mozaik veya zaman serisi oluşturan ilgili raster resimlerden oluşan bir koleksiyon. İş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'a aktarılabilir.
Table Her biri bir dizi mülk (sütun) içeren vektör özelliklerinden (satırlar) oluşan bir tablo veri yapısı. Filtreleme ve analiz için bir dizi yöntem içeren ee.FeatureCollection nesnesi ile temsil edilir.
Classifier Eğitilmiş bir Earth Engine makine öğrenimi modeli. Uygulama ve analiz için bir dizi yöntem içeren ee.Classifier nesnesi ile temsil edilir.
FeatureView Earth Engine uygulamalarında kullanılmak üzere bir tablonun görselleştirme görünümü.
Folder Düzenlemeye yardımcı olacak öğeler ve ek klasörler için bir kapsayıcı.

Öğe organizasyonu

Earth Engine öğeleri, klasör ve koleksiyonlardan oluşan hiyerarşik bir sistemde 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 değerinin kökü projects/my-project/assets'tur. my-project'e ait tüm öğeler projects/my-project/assets klasöründe veya içindeki bir alt klasörde (veya ImageCollection) bulunur.

Dizin

Earth Engine, öğeleri düzenlemek için ağaç benzeri bir dizin yapısı kullanır. Her Cloud projesinin, bağımsız öğeler ve klasörler içerebilen bir kök dizini vardır. Resim koleksiyonları, zaman serisi veya mozaik gibi ilgili resim gruplarını barındırmak için özel olarak tasarlanmış özel bir öğe türüdür. Klasörlerin aksine, resim koleksiyonları yalnızca resim öğeleri içerebilir ve başka klasörleri veya koleksiyonları içlerine yerleştiremez.

  • folder_dataprojects/my-project/assets/
    • klasör klasör-adı/
      • fotoğraf resim-adı
      • view_comfy tablo_adı
      • uydu özellikgörünümü-adı
      • bubble_chart sınıflandırıcı-adı
      • photo_library imagecollection-name/
        • fotoğraf resim-adı-1
        • fotoğraf resim-adı-2

Öğe Kimliği

Earth Engine, hem komut dosyalarındaki hem de komut satırı işlemlerindeki verilere referans vermek için öğe kimliklerini kullanır. Klasörler arasında ayırıcı olarak eğik çizgiler (/) kullanarak öğe konumlarını tanımlar. Örneğin, projects/my-project/assets/my-asset, "my-project" kökünde bulunan "my-asset" adlı bir öğeyi belirtir. Öğe hakkında bilgi edinmek için bu kimliğin kullanıldığı bir örnek aşağıda verilmiştir.

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ör ve ImageCollection oluşturabilir, yerel dosyalardan veya Google Cloud Storage paketindeki dosyalardan resim ve tablo besleyebilirsiniz. Desteklenen resim biçimleri arasında GeoTIFF (standart ve COG) ve TFRecord bulunur. Desteklenen tablo biçimleri arasında Shapefile ve CSV bulunur. (Öğeler, Export.*.toAsset toplu işlevlerini kullanarak bir Earth Engine analiz sonucunu dışa aktararak da oluşturulabilir.)

Python istemcisi

Resim

Cloud Storage'daki resimleri beslemek için ee.data.startIngestion işlevini kullanın. Yüklemeyi yapılandırma hakkında daha fazla bilgi için resim 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'daki tabloları beslemek için ee.data.startTableIngestion işlevini kullanın. Yüklemeyi yapılandırma hakkında daha fazla bilgi için resim 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

Bir Google Cloud Storage paketine yüklediğiniz bulut için optimize edilmiş GeoTIFF (COG) dosyaları harici görüntü öğeleri olarak kaydedilebilir ve doğrudan Earth Engine'da kullanılabilir. COG destekli öğeler ve manifest oluşturma hakkında daha fazla bilgi için referans dokümanlarına bakın.

earthengine alpha 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 (yinelemeli değildir). Filtreleme ve sayfalandırma hakkında daha fazla bilgi için referans dokümanlarına bakın.

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

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 (yinelemeli değildir). Listelenecek öğe sayısı ve döndürülecek tutar ayrıntıları 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 öğedeki 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ş simgesini tıklayın. İletişim kutusunda, öğeyi paylaşacağınız e-posta adresini veya alanı girin, ardından açılır listeden izin verilecek izin düzeyini seçin. Değişikliği onaylamak için ERİŞİM EKLE düğmesini tıklayın. Herhangi bir öğeye okuma izni vermek için "Herkes okuyabilir" kutusunu işaretleyin. Ayrıca, açılır listeden uygulamanın adını seçerek (etkin Code Editor projesine ait öğeler) iletişim kutusunda Earth Engine uygulamalarına erişim izni verebilirsiniz.

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 izinlerini ayrı ayrı ayarlamak için 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ş simgesini tıklayın. İletişim kutusunda, e-posta ve alanların listesi ile ilgili erişim düzeyleri 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, düzenle simgesini tıklayın ve 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. Yinelenen ve kuru çalıştırma 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 açma/kapatma 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 dokümanlarını inceleyin.

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. Kullanım ve kota sınırları sayfasında öğe kotası hakkında daha fazla bilgi edinin.

Python istemcisi

Bir öğe kökünün depolama alanı kotası kullanımını almak 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. Bilgi iletişim kutusu görünür.

Komut satırı

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