Mengelola aset

Aset Earth Engine adalah data geospasial milik project yang disimpan dalam platform. Anda dapat mengupload data Anda sendiri dan menyimpan data yang dihasilkan dari analisis Earth Engine sebagai aset.

Jenis aset

Earth Engine menawarkan berbagai format aset untuk berbagai jenis data, beserta elemen penampung untuk pengaturan.

Jenis aset
Image Raster, representasi informasi geografis berbasis petak dengan setiap sel dalam petak menyimpan nilai yang sesuai dengan lokasi tertentu di permukaan Bumi.
ImageCollection Kumpulan gambar raster terkait yang membentuk mosaik atau deret waktu. Secara fungsional, sampel ini mirip dengan folder, tetapi dapat diimpor ke Earth Engine sebagai objek ee.ImageCollection yang menyertakan kumpulan metode untuk pemfilteran dan analisis.
Table Struktur data tabel yang terdiri dari fitur vektor (baris), yang masing-masing berisi serangkaian properti (kolom). Ini diwakili oleh objek ee.FeatureCollection, yang mencakup serangkaian metode untuk pemfilteran dan analisis.
Classifier Model machine learning Earth Engine yang telah dilatih. Model ini diwakili oleh objek ee.Classifier, yang mencakup serangkaian metode untuk aplikasi dan analisis.
FeatureView Tampilan visualisasi tabel untuk digunakan di Aplikasi Earth Engine.
Folder Penampung untuk aset dan folder tambahan guna membantu pengaturan.

Organisasi aset

Aset Earth Engine diatur ke dalam sistem hierarkis folder dan koleksi. Strukturnya mirip dengan sistem file umum.

Root

Aset dimiliki oleh project Cloud. Nama project menentukan root direktori aset. Misalnya, root my-project adalah projects/my-project/assets. Semua aset yang termasuk dalam my-project berada di folder projects/my-project/assets atau subfolder (atau ImageCollection) di dalamnya.

Direktori

Earth Engine menggunakan struktur direktori seperti hierarki untuk mengatur aset. Setiap project Cloud memiliki direktori root yang dapat berisi setiap aset dan folder. ImageCollections adalah jenis aset khusus yang dirancang khusus untuk menyimpan kumpulan gambar terkait, seperti deret waktu atau mosaik. Tidak seperti folder, ImageCollections hanya dapat berisi aset gambar dan tidak dapat menyusun folder atau koleksi lain di dalamnya.

  • folder_dataprojects/my-project/assets/
    • folder nama-folder/
      • photo nama-gambar
      • view_comfy nama tabel
      • satellite featureview-name
      • bubble_chart classifier-name
      • photo_library imagecollection-name/
        • photo image-name-1
        • photo image-name-2

ID Aset

Earth Engine menggunakan ID aset untuk mereferensikan data dalam skrip dan operasi command line. Atribut ini menentukan lokasi aset menggunakan garis miring ke depan (/) sebagai pemisah antara direktori. Misalnya, projects/my-project/assets/my-asset menentukan aset bernama "my-asset" yang terletak di root "my-project". Berikut adalah contoh penggunaan ID ini untuk mendapatkan informasi tentang aset.

Python

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

Editor Kode

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

Command line

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

Buat aset

Anda dapat membuat folder dan ImageCollections serta menyerap gambar dan tabel dari file lokal atau file dalam bucket Google Cloud Storage. Format gambar yang didukung meliputi GeoTIFF (standar dan COG) dan TFRecord. Format tabel yang didukung meliputi Shapefile dan CSV. (Aset juga dapat dibuat dengan mengekspor hasil analisis Earth Engine menggunakan fungsi batch Export.*.toAsset).

Klien Python

Gambar

Gunakan fungsi ee.data.startIngestion untuk menyerap gambar dari Cloud Storage. Lihat halaman manifes image untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi upload.

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

Tabel

Gunakan fungsi ee.data.startTableIngestion untuk menyerap tabel dari Cloud Storage. Lihat halaman manifes image untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi upload.

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

Folder atau ImageCollection

Gunakan fungsi ee.data.createAsset untuk membuat folder kosong atau ImageCollections.

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

Editor Kode

Di dalam Pengelola Aset, klik tombol BARU dan pilih jenis aset yang ingin Anda upload atau buat dari menu drop-down. Konfigurasikan upload atau pembuatan aset dalam dialog.

Command line

Gambar atau tabel

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

Folder atau ImageCollection

Gunakan perintah earthengine create untuk membuat folder kosong atau ImageCollections.

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

Gambar eksternal

File GeoTIFF (COG) yang dioptimalkan untuk cloud yang Anda upload ke bucket Google Cloud Storage dapat didaftarkan sebagai aset gambar eksternal dan digunakan langsung di Earth Engine. Lihat dokumen referensi untuk mengetahui informasi selengkapnya tentang aset yang didukung COG dan membuat manifes.

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

Mencantumkan aset

Klien Python

Gunakan fungsi ee.data.listAssets untuk mencantumkan aset dalam folder atau koleksi (tidak rekursif). Lihat dokumen referensi untuk mengetahui informasi selengkapnya tentang pemfilteran dan penomoran halaman.

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

Lihat juga ee.data.listImages dan ee.data.listFeatures.

Editor Kode

Luaskan folder di Pengelola Aset untuk melihat aset.

Command line

Gunakan perintah earthengine ls untuk mencantumkan aset dalam folder atau koleksi (tidak rekursif). Lihat dokumen referensi untuk mengetahui informasi selengkapnya tentang cara membatasi jumlah aset yang akan dicantumkan dan detail jumlah yang akan ditampilkan.

earthengine ls projects/my-project/assets

Menetapkan izin aset

Klien Python

Gunakan fungsi ee.data.setAssetAcl untuk menetapkan izin pada aset.

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)

Editor Kode

Dalam Pengelola Aset, arahkan kursor ke aset, lalu klik ikon bagikan. Dalam dialog, masukkan alamat email atau domain yang akan diajak berbagi aset, lalu pilih tingkat izin yang akan diberikan dari menu drop-down. Klik tombol TAMBAHKAN AKSES untuk mengonfirmasi perubahan. Centang kotak "Siapa saja dapat membaca" untuk memberikan izin baca kepada entitas mana pun. Anda juga dapat memberikan akses ke aplikasi Earth Engine dari dialog dengan memilih nama aplikasi dari daftar drop (aset yang dimiliki oleh project Editor Kode yang aktif).

Command line

Gunakan perintah earthengine acl set untuk menetapkan akses baca aset ke public atau private.

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

Gunakan perintah earthengine acl ch untuk menetapkan izin individual untuk baca dan tulis aset.

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

Lihat halaman referensi command line untuk mengetahui detail selengkapnya.

Memeriksa izin aset

Klien Python

Gunakan fungsi ee.data.getAssetAcl untuk mengambil daftar kontrol akses untuk aset.

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

Editor Kode

Dalam Pengelola Aset, arahkan kursor ke aset, lalu klik ikon bagikan. Dialog ini menampilkan daftar email dan domain beserta tingkat aksesnya masing-masing.

Command line

Gunakan perintah earthengine acl get untuk mengambil daftar kontrol akses untuk aset.

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

Menyalin aset

Klien Python

Gunakan fungsi ee.data.copyAsset untuk menyalin aset.

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

Editor Kode

Gunakan klien Python atau alat command line untuk menyalin aset.

Command line

Gunakan perintah earthengine cp untuk menyalin aset.

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

Memindahkan atau mengganti nama aset

Klien Python

Gunakan fungsi ee.data.renameAsset untuk memindahkan atau mengganti nama aset.

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

Editor Kode

Pindahkan

Di dalam Pengelola Aset, tarik aset ke folder baru.

Ganti nama

Di dalam Pengelola Aset, arahkan kursor ke aset, lalu klik ikon edit dan ketik nama baru di kolom input yang dapat diedit.

Command line

Gunakan perintah earthengine mv untuk memindahkan atau mengganti nama aset.

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

Menghapus aset

Klien Python

Gunakan fungsi ee.data.deleteAsset untuk menghapus aset.

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

Editor Kode

Klik aset untuk membuka halaman dialog aset, lalu klik tombol HAPUS.

Command line

Gunakan perintah earthengine rm untuk menghapus aset. Lihat referensi fungsi untuk opsi siklus berulang dan uji coba.

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

Melihat metadata aset

Klien Python

Gunakan fungsi ee.data.getAsset untuk mendapatkan metadata aset.

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

Editor Kode

Klik aset untuk membuka halaman dialog aset. Lihat informasi aset.

Command line

Gunakan perintah earthengine asset info untuk mendapatkan metadata aset.

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

Menetapkan metadata aset

Metadata aset berikut dapat ditetapkan:

  • start_time
  • end_time

  • properties

Klien Python

Gunakan fungsi ee.data.updateAsset untuk memperbarui metadata aset.

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)

Editor Kode

Klik aset untuk membuka halaman dialog aset, lalu aktifkan tombol edit di kanan atas. Anda dapat mengedit deskripsi, properti, serta tanggal mulai dan akhir. Nonaktifkan tombol edit untuk menyimpan perubahan.

Command line

Gunakan perintah earthengine asset set untuk memperbarui metadata aset. Lihat dokumen referensi untuk informasi selengkapnya.

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

Memeriksa kuota aset

Kuota diterapkan di level project. Pelajari kuota aset lebih lanjut di halaman batas penggunaan dan kuota.

Klien Python

Gunakan fungsi ee.data.getAssetRootQuota untuk mendapatkan penggunaan kuota penyimpanan untuk root aset.

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

Editor Kode

Dalam Pengelola Aset, arahkan kursor ke root project, lalu klik ikon data_usage. Dialog informasi akan muncul.

Command line

Gunakan klien Python atau Editor Kode untuk memeriksa kuota aset.