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

Earth Engine chạy trên Google Cloud và yêu cầu các dự án trên Cloud để truy cập và quản lý API. Tất cả các lệnh gọi Earth Engine (cho dù là từ Trình chỉnh sửa 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 Cloud, 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.

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 Cloud có:

• đã bật Earth Engine API,
• được đăng ký để sử dụng cho mục đích thương mại hoặc phi thương mại, và
• cấp cho bạn (hoặc người dùng) vai trò và quyền phù hợp.

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

earthengine create folder projects/my-project/assets/

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 khác nhau đối với các dịch vụ của Earth Engine.

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

Hàm ee.Initialize() dùng để chỉ định một dự án cho các yêu cầu của Earth Engine bắt nguồn từ thư viện ứng dụng Python và JavaScript. Có nhiều cách để định cấu hình quy cách dự án, hãy xem trang xác thực và khởi tạo để 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 chỉnh sửa 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 một Ứ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 Cloud, 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 REST API với một dự án trên Google Cloud, hãy đưa ra các lệnh gọi HTTP đã xác thực, trong đó quá trình 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ụ được 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ề REST API để 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 có hỗ trợ Earth Engine để người khác và tài khoản dịch vụ 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 bất kỳ số lượng tài khoản dịch vụ nào trên một dự án để sử dụng Earth Engine. Hãy 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 OAuth 2.0

Bạn có thể cần tạo một mã ứng dụng OAuth 2.0 từ một dự án, chẳng hạn như để tạo một ứng dụng chuyển thông tin đăng nhập 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 Cloud bằng cách chuyển đến trình đơn Cloud Console (menu) rồi chọn API và dịch vụ > Thông tin xác thực. (Chọn dự án nếu được nhắc).

Để tạo một mã ứng dụng 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 các nguồn JavaScript được phép, 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

Xoá dữ liệu trên 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 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 Earth Engine được liên kết 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 một dự án trên Google Cloud bị xoá, dữ liệu Earth Engine liên kết với dự án đó cũng sẽ bị xoá (ví dụ: mọi thành phầ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 Giám sát, v.v.). Quá trình này có thể đảo ngược trong vòng tối đa 30 ngày, nhưng bạn sẽ không bao giờ khôi phục được những dữ liệu đó sau 30 ngày.

Thành phần

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

Để xoá tài sản theo cách có lập trình đối với một tài sản có mã projects/{project-id}/assets/{asset-id} (ví dụ: projects/my-project/assets/my-asset):

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

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

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 chỉnh sửa mã Earth Engine:

Ứng dụng Earth Engine

Để xoá các ứng dụng Earth Engine, hãy dùng nút"Ứng dụng" trong Trình chỉnh sửa mã để quản lý các ứng dụng của bạn.

Tài liệu tham khảo về "Lấy đường liên kết"

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 chỉnh sửa mã. Bạn có thể tìm thấy trang này bằng cách chuyển đến lựa chọn"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 vào Earth Engine cho dự án phi thương mại (không phải trả phí), bạn cần điền vào bảng câu hỏi đăng ký trong bảng điều khiển Cloud để xác nhận dự án của bạn có đủ điều kiện hay không.

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 được đăng ký để truy cập cho mục đích phi thương mại. Quy trình xác minh được thực hiện trong quá trình đăng ký. Nếu hoàn thành bảng 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 phải 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 điền vào bảng 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 thực hiện 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 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 Earth Engine cho mục đích thương mại (có tính phí) cho dự án của mình, 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 một bối cảnh trả phí, bạn cần thực hiện một số thay đổi để ngừng phát sinh phí:

• Ngừng tính phí gói thuê bao

  • Để chấm dứt gói thuê bao Earth Engine trong tài khoản thanh toán của mình, 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 chỉnh sửa mã khi sử dụng một dự án đã đăng ký trên Cloud đượ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 bạn chọn gói "Có giới hạn", tài khoản thanh toán của bạn sẽ không phải trả thêm phí thuê bao nền tảng Earth Engine sau chu kỳ thanh toán hiện tại.

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

  • Để tránh bị tính phí mới liên quan đến hoạt động tính toán (EECU-time), hãy tắt Earth Engine API trên(các) dự án Cloud của bạn. Xin lưu ý rằng thao tác này không kết thúc các yêu cầu đang diễn ra 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 API bị vô hiệu hoá.
  • Hãy 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í bộ nhớ

  • Các tài sản Earth Engine được lưu trữ vẫn tiếp tục phát sinh chi phí ngay cả khi API bị vô hiệu hoá. Xoá thành phần sẽ giúp bạn không phải trả thêm phí lưu trữ EE.