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 koleksiyonu. İşlevsel olarak bir klasöre benzer ancak Earth Engine'e filtreleme ve analiz için bir dizi yöntem içeren bir ee.ImageCollection nesnesi olarak 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 |
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'larından) birinde yer alır.
Dizin
Earth Engine, öğeleri düzenlemek için ağaç benzeri bir dizin yapısı kullanır. Her Cloud projesinde, ayrı öğeler ve klasörler içerebilen bir kök dizin bulunur. ImageCollections, 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ç 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. Öğ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ünde bulunan "my-asset" adlı bir öğeyi belirtir. Öğe hakkında bilgi edinmek için bu kimliğin nasıl kullanılacağına dair 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örler ve ImageCollection'lar oluşturabilir, yerel dosyalardan veya bir Google Cloud Storage paketindeki dosyalardan görüntü ve tablo alabilirsiniz. Desteklenen resim biçimleri arasında GeoTIFF ve TFRecord bulunur. Cloud Storage'daki Cloud Optimized GeoTIFF'ler (COG) 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 sonucu dışa aktarılarak 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 tablo 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.tifearthengine 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-nameearthengine 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'da kullanılabilir. Manifest oluşturma hakkında bilgi edinmek 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 belgelerine bakın.
earthengine ls projects/my-project/assetsÖğe izinlerini ayarlama
Python istemcisi
Bir öğenin izinlerini 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 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 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 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-nameDaha 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 simgesini tıklayın. İletişim kutusunda, e-posta adresleri ve alan adlarını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 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
Bir öğeyi tıklayarak öğe iletişim kutusu sayfasını açın, ardından SİL düğmesini tıklayın.
Komut satırı
Bir öğeyi silmek için earthengine rm komutunu kullanın. Yinelemeli ve prova 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_timeend_timeproperties
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 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.