Öğeleri yönetme

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

Öğ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 Bir raster, coğrafi bilgilerin ızgara tabanlı bir gösterimidir. 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 görüntülerden oluşan bir koleksiyon. İşlevsel olarak 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ırlar) 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ılmak üzere bir tablonun görselleştirme görünümü.
Folder Öğeler ve düzenlemeye yardımcı olacak ek klasörler için bir kapsayıcıdır.

Öğe düzenleme

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 öğesinin kökü projects/my-project/assets'dir. my-project öğesine ait tüm öğeler, projects/my-project/assets klasöründe veya bu klasördeki bir alt klasörde (ya da ImageCollection) yer alıyor.

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. ImageCollection'lar, özellikle zaman serileri veya mozaikler gibi birbiriyle ilişkili resim gruplarını tutmak için tasarlanmış özel bir öğe türüdür. Klasörlerin aksine, ImageCollection'lar yalnızca resim öğeleri içerebilir ve başka klasörleri veya koleksiyonları iç içe yerleştiremez.

  • folder_dataprojects/my-project/assets/
    • folder klasör-adı/
      • photo image-name
      • view_comfy tablo_adı
      • 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. Dizinler arasında ayırıcı olarak eğik çizgi (/) kullanarak öğe konumlarını tanımlarlar. Örneğin, projects/my-project/assets/my-asset, "my-project" kökünde bulunan "my-asset" adlı bir öğeyi belirtir. Bu kimliği kullanarak öğe hakkında bilgi edinme örneğini 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 Google Cloud Storage paketindeki dosyalardan resim ve tablo alabilirsiniz. Desteklenen görüntü biçimleri arasında GeoTIFF (standart ve COG) ve TFRecord bulunur. Desteklenen tablo biçimleri arasında Shapefile ve CSV yer alır. (Öğeler, toplu işlevler kullanılarak Export.*.toAsset Earth Engine analiz sonucunu dışa aktararak da oluşturulabilir.)

Python istemcisi

Resim

Cloud Storage'dan görüntü almak 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'dan tabloları almak 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

Google Cloud Storage paketine yüklediğiniz Cloud Optimized GeoTIFF (COG) dosyaları, harici resim öğeleri olarak kaydedilebilir ve doğrudan Earth Engine'de kullanılabilir. COG destekli öğeler ve manifest oluşturma hakkında daha fazla bilgi için referans belgelerine bakın.

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

Öğeleri listeleme

Python istemcisi

Bir klasördeki veya koleksiyondaki öğeleri listelemek için (özyinelemeli olmayan) ee.data.listAssets işlevini kullanın. Filtreleme ve sayfalama hakkında daha fazla bilgi için referans belgelerine bakın.

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

Ayrıca ee.data.listImages ve ee.data.listFeatures politikaları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ördeki veya koleksiyondaki öğeleri listelemek için (özyinelemeli olmayan) earthengine ls komutunu kullanın. 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 belgelerine bakın.

earthengine ls projects/my-project/assets

Öğe izinlerini ayarlama

Python istemcisi

Bir öğede 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 getirip paylaş simgesini 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 varlığa 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 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

Varlığın okunması ve yazılması 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 getirmek 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 getirip paylaş simgesini tıklayın. İletişim kutusunda, e-posta adreslerinin ve alanların listesi ile ilgili erişim düzeyleri gösterilir.

Komut satırı

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

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

Öğeleri kopyalama

Python istemcisi

Öğe 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ı

Öğ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 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 belgeleri 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

Varlık Yöneticisi'nde, işaretçiyi bir proje kökünün üzerine getirip 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üzenleyiciyi kullanın.