Quyền truy cập vào Earth Engine

Earth Engine chạy trên Google Cloud và cần có dự án trên đám mây để truy cập và quản lý API. Tất cả lệnh gọi Earth Engine (cho dù là từ Trình soạn thảo mã, thư viện ứng dụng, Ứng dụng hay API REST) đều được định tuyến thông qua một dự án trên đám mây, cho phép kiểm soát quyền truy cập, quản lý tài nguyên và giám sát mức sử dụng trong Cloud Console.

Yêu cầu quyền truy cập vào Earth Engine

Để sử dụng Earth Engine, bạn cần có quyền truy cập vào một dự án trên đám mây:

Tạo dự án

Truy cập vào trang đăng ký để tạo và đăng ký một dự án trên đám mây mới hoặc đăng ký một dự án hiện có. Sau khi đăng ký, bạn sẽ có quyền truy cập vào Earth Engine ngay lập tức.

Bạn có thể quản lý các dự án được tạo trong quá trình đăng ký trong Google Cloud Console. Bạn có thể kích hoạt hoặc huỷ kích hoạt Earth Engine API trên trang Earth Engine API trên Cloud Console.

Các bước thủ công (được tự động hoá bằng trang đăng ký)

Tạo một dự án trên đám mây

Nếu bạn chưa có, hãy tạo một Dự án Google Cloud. Bạn có thể thực hiện việc này trên trang dự án của Cloud Console hoặc nhấp vào nút sau:

Tạo dự án trên đám mây

Bật Earth Engine API

Để bật Earth Engine API cho dự án, hãy nhấp vào nút sau để chuyển đến trang Earth Engine API:

Bật Earth Engine API

Trên trang Earth Engine API, hãy đảm bảo rằng bạn đã chọn dự án của mình rồi nhấp vào nút BẬT.

Đăng ký dự án để sử dụng cho mục đích thương mại hoặc phi thương mại

Chỉnh sửa URL sau cho dự án của bạn, truy cập vào trang và hoàn tất quy trình đăng ký.

https://code.earthengine.google.com/register?project=my-project

Tạo thư mục thành phần (không bắt buộc)

Bạn có thể tạo một thư mục tài sản Earth Engine liên kết với một dự án trên Google Cloud mà bạn có quyền truy cập bằng lệnh earthengine create folder, sử dụng đường dẫn như mô tả tại đây. Ví dụ:

earthengine create folder projects/my-project/assets/

Bạn cũng có thể tạo thư mục tài sản cho một dự án trong Trình soạn thảo mã bằng cách thêm dự án trong bảng điều khiển Tài sản.

Bạn không cần tạo thư mục này trừ phi bạn dự định lưu trữ tài sản trong dự án.

Sử dụng dự án hiện có

Hãy liên hệ với nhân viên CNTT của tổ chức để biết về các dự án trên đám mây hiện có được định cấu hình cho Earth Engine. Đảm bảo rằng Tài khoản Google mà bạn sẽ dùng để truy cập vào các dịch vụ của Earth Engine được cấp đúng vai trò và quyền đối với dự án.

Chỉ định một dự án

Các phần sau đây mô tả cách chỉ định một dự án cho nhiều giao diện của dịch vụ Earth Engine.

Thư viện ứng dụng (Python, JavaScript)

Hàm ee.Initialize() được dùng để chỉ định một dự án cho các yêu cầu Earth Engine bắt nguồn từ thư viện ứng dụng Python và JavaScript. Có một số cách để định cấu hình thông số kỹ thuật của dự án, hãy xem trang xác thực và khởi chạy để biết thêm thông tin chi tiết.

Trình soạn thảo mã

Nhấp vào biểu tượng hồ sơ ở góc trên cùng bên phải của Trình soạn thảo mã rồi chọn "Thay đổi dự án trên đám mây" trong trình đơn. Chọn một dự án trong hộp thoại lựa chọn.

Ứng dụng Earth Engine

Khi xuất bản Ứng dụng Earth Engine, bạn sẽ được nhắc chọn một dự án để định tuyến các yêu cầu. Làm theo hướng dẫn trong hộp thoại xuất bản.

Công cụ dòng lệnh

Để liên kết các lệnh gọi Earth Engine từ công cụ dòng lệnh với một dự án trên đám mây, hãy sử dụng tham số --project trong lệnh gọi đến earthengine hoặc sử dụng set_project để đặt dự án mặc định.

API REST

Để liên kết các lệnh gọi đến API REST với một dự án trên đám mây, hãy thực hiện các lệnh gọi HTTP đã xác thực, trong đó việc xác thực do oauth2 xử lý. Trong môi trường cục bộ, bạn có thể sử dụng lệnh gcloud. Bạn cũng có thể sử dụng tài khoản dịch vụ liên kết với một Dự án trên đám mây. Hãy xem Hướng dẫn bắt đầu nhanh về API REST để biết ví dụ về cách sử dụng google.oath.service_account.Credentials.from_service_account_file() để xác thực bằng tài khoản dịch vụ.

Định cấu hình quyền truy cập vào dự án

Các phần sau đây mô tả cách định cấu hình các dự án đã bật Earth Engine để các cá nhân và tài khoản dịch vụ khác sử dụng.

Tài khoản dịch vụ

Tài khoản dịch vụ sẽ tự động có quyền truy cập sau khi dự án mẹ được đăng ký và bật Earth Engine API. Họ cũng cần có quyền phù hợp trong dự án. Bạn có thể định cấu hình số lượng tài khoản dịch vụ bất kỳ trong một dự án để sử dụng Earth Engine. Truy cập vào trang tài khoản dịch vụ để tìm hiểu thêm về cách sử dụng tài khoản dịch vụ với Earth Engine.

Tài khoản Google

Các dự án trên đám mây sử dụng Cloud IAM để quản lý vai trò và quyền. Để những người khác có thể truy cập vào Earth Engine thông qua dự án của bạn, bạn cần sử dụng Cloud Console để cấp cho họ vai trò và quyền phù hợp.

Mã ứng dụng khách OAuth 2.0

Bạn có thể cần tạo Mã ứng dụng khách OAuth 2.0 từ một dự án, chẳng hạn như để tạo một ứng dụng truyền thông tin xác thực của người dùng đến Earth Engine. Bạn có thể quản lý thông tin xác thực cho dự án trên đám mây bằng cách chuyển đến trình đơn Cloud Console () rồi chọn API & Services (API và dịch vụ) > Credentials (Thông tin xác thực). (Chọn dự án nếu được nhắc).

Để tạo Mã ứng dụng OAuth mới cho dự án, hãy nhấp vào + CREATE CREDENTIALS (TẠO THÔNG TIN XÁC THỰC) > OAuth client ID (Mã ứng dụng OAuth) > Web application (Ứng dụng web).

Trong cấu hình của ứng dụng web:

  • Chỉ định nguồn gốc JavaScript được uỷ quyền, ví dụ:
http://localhost:8080
https://foo-ee-project.appspot.com
  • Chỉ định URI chuyển hướng được uỷ quyền, ví dụ:
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

Tìm hiểu thêm về cách xác thực người dùng bằng OAuth.

Các trường hợp phổ biến

Tôi đang dạy một lớp học...

Tuyệt vời! Nếu bạn đăng ký một dự án phi thương mại, thì không cần phải định cấu hình thông tin thanh toán. Sau đó, bạn có thể thêm học viên vào dự án.

Tôi là thành viên của một nhóm vận hành/tổ chức thương mại...

Tuyệt vời! Bạn có thể đăng ký một dự án để sử dụng cho mục đích thương mại và thêm cộng tác viên vào dự án đó. Ngoài ra, vui lòng chú ý đến giới hạn về số lượng người dùng trong gói thuê bao Earth Engine mà bạn chọn.

Xoá dữ liệu Earth Engine

Xoá ở cấp tài khoản

Thao tác xoá ở cấp tài khoản sẽ xoá tất cả dữ liệu Earth Engine khỏi tài khoản của bạn.

Nếu tài khoản của bạn thuộc một tổ chức Google Workspace, thì quản trị viên của bạn sẽ kiểm soát dữ liệu tài khoản của bạn. Khi quản trị viên xoá một Tài khoản Google, tất cả dữ liệu liên quan trên Earth Engine sẽ bị xoá trong vòng khoảng 30 ngày.

Nhóm Earth Engine không thể khôi phục dữ liệu sau khi dữ liệu bị xoá.

Dự án trên đám mây

Khi bạn xoá một dự án trên đám mây, thao tác này sẽ kích hoạt việc xoá dữ liệu Earth Engine liên kết với dự án đó (bao gồm, ví dụ: mọi tài sản được lưu trữ trong thư mục gốc của dự án, mọi Ứng dụng EE ở cấp dự án, dữ liệu Monitoring, v.v.). Quá trình này có thể đảo ngược được trong tối đa 30 ngày, nhưng bạn không thể khôi phục dữ liệu đó sau 30 ngày.

Thành phần

Cách đơn giản nhất để xoá tài sản là sử dụng thẻ "Tài sản" trong Trình soạn thảo mã để xem và xoá tài sản Earth Engine theo cách thủ công.

Để xoá thành phần có mã nhận dạng projects/{project-id}/assets/{asset-id} theo phương thức có lập trình (ví dụ: projects/my-project/assets/my-asset):

Ứng dụng Python

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

Ứng dụng JavaScript

Lưu ý rằng hộp cát bảo mật của Trình soạn thảo mã ngăn lệnh gọi này hoạt động trong môi trường đó.

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

Công cụ dòng lệnh

Sử dụng lệnh rm:

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

Tập lệnh Trình soạn thảo mã

Cách xoá tập lệnh trong Trình soạn thảo mã của Earth Engine:

Trình soạn thảo mã

Trong thẻ "Scripts" (Tập lệnh) trong Trình soạn thảo mã, hãy chọn một tập lệnh hoặc kho lưu trữ rồi xoá. Sau khi được đánh dấu là đã xoá, kho lưu trữ sẽ không thể khôi phục được trong vòng 30 ngày.

Sử dụng Git

Người dùng nâng cao có thể sử dụng Git để quản lý tập lệnh của họ. Hãy truy cập vào https://earthengine.googlesource.com/ để xem danh sách các kho lưu trữ mà bạn có thể xem.

Ứng dụng Earth Engine

Để xoá Ứng dụng Earth Engine, hãy dùng nút "Ứng dụng" trong Trình soạn thảo mã để quản lý Ứng dụng.

Sử dụng trang Quản lý đường liên kết để xem và xoá các đường liên kết "Lấy đường liên kết" khỏi Trình soạn thảo mã. Bạn có thể tìm thấy trang này bằng cách chuyển đến mục "Quản lý đường liên kết" trong trình đơn thả xuống bên cạnh nút "Lấy đường liên kết".

Định cấu hình quyền truy cập phi thương mại

Để thiết lập quyền truy cập phi thương mại (không tốn phí) vào Earth Engine cho dự án, bạn cần điền vào bộ câu hỏi đăng ký trong Cloud Console để xác nhận rằng dự án của bạn đủ điều kiện.

Xác minh

Vì Earth Engine cấp quyền truy cập miễn phí vào một lượng lớn tài nguyên điện toán, nên Google yêu cầu xác minh từng dự án đã đăng ký để truy cập phi thương mại. Quy trình xác minh được thực hiện trong quá trình đăng ký. Nếu bạn hoàn tất bộ câu hỏi xác minh và dự án của bạn được xác định là dự án thương mại, thì bạn sẽ không đủ điều kiện sử dụng Earth Engine mà không trả phí.

Kể từ ngày 26 tháng 9 năm 2025, tất cả dự án phi thương mại đều phải hoàn tất bộ câu hỏi trong Cloud Console. Bạn nên hoàn tất quy trình xác minh càng sớm càng tốt. Nếu bạn không hành động trước ngày 26 tháng 9 năm 2025, quyền truy cập của dự án vào Earth Engine sẽ bị tạm dừng cho đến khi bạn hoàn tất quy trình xác minh.

Xác minh lại

Tất cả dự án có quyền truy cập phi thương mại đều cần phải xác minh lại để có quyền truy cập theo định kỳ.

Định cấu hình quyền truy cập thương mại

Để thiết lập quyền truy cập thương mại (có tính phí) vào Earth Engine cho dự án, bạn cần định cấu hình dự án bằng trang đăng ký và chọn một gói trên tài khoản thanh toán.

Chấm dứt quyền truy cập thương mại

Nếu bạn là khách hàng trực tiếp của Earth Engine và muốn ngừng sử dụng Earth Engine trong bối cảnh có tính phí, thì bạn cần thực hiện một số thay đổi để ngừng phát sinh phí:

  • Ngừng tính phí thuê bao

    • Để chấm dứt gói thuê bao Earth Engine trên tài khoản thanh toán, bạn cần sử dụng trang "Quản lý gói" (có thể truy cập từ trình đơn thả xuống cài đặt người dùng ở trên cùng bên phải của Trình soạn thảo mã khi sử dụng một dự án trên đám mây đã đăng ký được liên kết với tài khoản thanh toán đó).
    • Bạn cũng có thể truy cập trực tiếp vào trang "Quản lý gói" cho một tài khoản thanh toán:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID
      
    • Khi chọn gói "Giới hạn", tài khoản thanh toán của bạn sẽ không phải trả thêm bất kỳ khoản phí thuê bao nào cho nền tảng Earth Engine sau chu kỳ thanh toán hiện tại.

  • Ngừng tính phí điện toán

    • Để tránh bị tính phí mới liên quan đến tài nguyên điện toán (thời gian EECU), hãy tắt Earth Engine API trên (các) dự án trên đám mây của bạn. Xin lưu ý rằng việc này không chấm dứt các yêu cầu đang thực hiện hoặc xoá các đối tượng đã lưu trữ, vì vậy, bạn vẫn có thể phải trả phí Earth Engine ngay cả khi đã tắt API.
    • Xem phần Trợ giúp về API Console để biết thông tin về cách tắt API.
  • Ngừng tính phí lưu trữ

    • Các tài sản được lưu trữ trên Earth Engine vẫn tiếp tục phát sinh chi phí ngay cả khi API bị tắt. Khi xoá tài sản, bạn sẽ không phải trả thêm phí lưu trữ trên EE.