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 mengatur data.

Jenis aset
Image Raster, representasi informasi geografis berbasis petak yang 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, aset ini mirip dengan folder, tetapi dapat diimpor ke Earth Engine sebagai objek ee.ImageCollection yang mencakup sekumpulan metode untuk pemfilteran dan analisis.
Table Struktur data tabel yang terdiri dari fitur vektor (baris), yang masing-masing berisi serangkaian properti (kolom). Objek ini diwakili oleh objek ee.FeatureCollection, yang mencakup serangkaian metode untuk pemfilteran dan analisis.
Classifier Model machine learning Earth Engine yang terlatih. Objek ini diwakili oleh objek ee.Classifier, yang mencakup serangkaian metode untuk penerapan dan analisis.
FeatureView Tampilan visualisasi tabel untuk digunakan di Aplikasi Earth Engine.
Folder Container untuk aset dan folder tambahan untuk membantu pengorganisasian.

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 pohon untuk mengatur aset. Setiap project Cloud memiliki direktori root yang dapat berisi aset dan folder individual. ImageCollection adalah jenis aset khusus yang didesain khusus untuk menyimpan kumpulan gambar terkait, seperti deret waktu atau mosaik. Tidak seperti folder, ImageCollection hanya dapat berisi aset gambar dan tidak dapat menyertakan folder atau koleksi lain di dalamnya.

  • folder_dataprojects/my-project/assets/
    • folder folder-name/
      • foto nama-gambar
      • view_comfy table-name
      • 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. Mereka menentukan lokasi aset menggunakan garis miring ke depan (/) sebagai pemisah antar-direktori. Misalnya, projects/my-project/assets/my-asset menentukan aset bernama "my-asset" yang berada 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 ImageCollection serta menyerap gambar dan tabel dari file lokal atau file dalam bucket Google Cloud Storage. Format gambar yang didukung mencakup GeoTIFF (standar dan COG) serta TFRecord. Format tabel yang didukung mencakup 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 manifest 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 manifest 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 atau ImageCollection kosong.

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

Editor Kode

Di Pengelola Aset, klik tombol BARU dan pilih jenis aset yang ingin Anda upload atau buat dari daftar drop-down. Konfigurasi 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 atau ImageCollection kosong.

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

Gambar eksternal

File GeoTIFF yang dioptimalkan untuk cloud (COG) 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 cara 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 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 menyetel 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, tahan kursor di atas aset, lalu klik ikon bagikan. Dalam dialog, masukkan alamat email atau domain untuk membagikan aset, lalu pilih tingkat izin yang akan diberikan dari daftar 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-down (aset yang dimiliki oleh project Code Editor yang aktif).

Command line

Gunakan perintah earthengine acl set untuk menyetel 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, tahan kursor di atas aset, lalu klik ikon bagikan. Dialog menampilkan daftar email dan domain beserta tingkat aksesnya masing-masing.

Command line

Gunakan perintah earthengine acl get untuk mengambil daftar kontrol akses 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 Pengelola Aset, tarik aset ke folder baru.

Ganti nama

Dalam Pengelola Aset, tahan kursor di atas 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 rekursif 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. Melihat 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 lebih lanjut kuota aset 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, tahan kursor di root project, lalu klik ikon data_usage. Dialog informasi akan muncul.

Command line

Gunakan klien Python atau Editor Kode untuk memeriksa kuota aset.