Earth Engine chạy trên Google Cloud và yêu cầu các dự án trên Google Cloud để truy cập và quản lý API. Tất cả lệnh gọi Earth Engine (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 Google 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 Google Cloud đáp ứng các yêu cầu sau:
- đã 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 chính xác.
Truy cập vào trang đăng ký để tạo và đăng ký dự án mới trên Cloud hoặc đăng ký dự án hiện 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 API Earth Engine trên trang Earth Engine API trên Cloud Console.
Các bước thủ công (do trang đăng ký tự động)
Tạo dự án trên Cloud
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 CloudBật API Earth Engine
Để bật API Earth Engine cho dự án của bạn, hãy nhấp vào nút sau đây để chuyển đến trang API Earth Engine:
Bật Earth Engine APITrên trang Earth Engine API, hãy đảm bảo 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 đây 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 thành phầ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
thông qua một đườ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 thành phầ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 Thành phần.
Bạn không cần tạo thư mục này trừ phi dự định lưu trữ tài sản trong dự án.
Hãy hỏi nhân viên CNTT của tổ chức về các dự án hiện có trên Google Cloud được định cấu hình cho Earth Engine. Đảm bảo rằng Tài khoản Google mà bạn sẽ sử dụng để truy cập vào các dịch vụ Earth Engine được cấp vai trò và quyền chính xác trên 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 đến 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 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 Code Editor (Trình soạn thảo mã) rồi chọn "Change Cloud Project" (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 phát hành Ứ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 phát hành.
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 Google 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 API REST 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 mà oauth2
sẽ xử lý việc xác thực. 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 phần Bắt đầu nhanh với API REST để biết ví dụ về cách sử dụng google.oath.service_account.Credentials.from_service_account_file()
nhằm 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 hỗ trợ 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 gốc của tài khoản được đăng ký và bật API Earth Engine. Họ cũng cần có quyền chính xác 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. 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. Để người khác 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 chuyể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 Google Cloud bằng cách chuyển đến trình đơn Cloud Console ( ) 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ã ứng dụng khách 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 khách 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 bổ túc...
Tuyệt vời! Nếu bạn đăng ký một dự án phi thương mại, thì bạn không cần phải thiết lập cấu hình 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 sự vào dự án đó. Ngoài ra, vui lòng chú ý đến hạn mức chỗ ngồi 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 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á sạch trong 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ự án đó sẽ kích hoạt quá trình xoá dữ liệu Earth Engine liên kết với dự án đó (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.). Bạn có thể huỷ quá trình này trong tối đa 30 ngày, nhưng không thể khôi phụ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 soạn thảo mã để xem và xoá tài sản Earth Engine theo cách thủ công.
Đối với việc xoá thành phần có lập trình của một thành phầ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 ')
Xin lưu ý rằng hộp cát bảo mật của Trình soạn thảo mã sẽ 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 ')
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ã Earth Engine:
Trong thẻ"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á tập lệnh hoặc kho lưu trữ đó. Sau khi một kho lưu trữ được đánh dấu là đã xoá, bạn sẽ không thể khôi phục kho lưu trữ đó trong vòng 30 ngày.
Người dùng nâng cao có thể sử dụng Git để quản lý tập lệnh. Hãy xem 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 sử dụng nút"Ứng dụng" trong Trình soạn thảo mã để quản lý Ứng dụng.
Tham chiếu "Get Link" (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 soạn thảo mã. Bạn có thể tìm thấy trang này bằng cách chuyển đến tuỳ 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".
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 trả phí, bạn cần thực hiện một số thay đổi để không bị tính phí nữa:
Ngừng tính phí gói 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 Cloud đã đă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 bạn 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 phí thuê bao 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 các khoản phí mới liên quan đến điện toán (thời gian EECU), hãy tắt Earth Engine API trên(các) dự án trên Google Cloud. Xin lưu ý rằng việc này không chấm dứt các yêu cầu đang xử lý hoặc xoá các đối tượng đã lưu trữ, vì vậy, bạn vẫn có thể phải trả phí cho Earth Engine ngay cả khi API bị tắt.
- Hãy xem phần Trợ giúp của 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ữ sẽ tiếp tục làm tăng chi phí ngay cả khi API bị tắt. Việc xoá tài sản sẽ giúp bạn không phải trả thêm phí lưu trữ ở EE.