Google App Engine cho phép bạn xây dựng và chạy các ứng dụng tuỳ chỉnh của riêng mình trên máy chủ của Google. Ứng dụng App Engine rất dễ tạo, duy trì và mở rộng quy mô khi lưu lượng truy cập và nhu cầu lưu trữ dữ liệu của bạn thay đổi. Bạn chỉ cần tải mã nguồn ứng dụng lên là có thể bắt đầu. Nếu bạn mới phát triển cho App Engine, hãy nhớ xem hướng dẫn bắt đầu nhanh về Python hoặc Node.js của App Engine trước khi tiếp tục.
Bạn có thể sử dụng Earth Engine và App Engine cùng nhau để xây dựng các ứng dụng không gian địa lý có thể mở rộng. Thông thường, mã App Engine của bạn sẽ bao gồm thư viện ứng dụng Python của Earth Engine và gửi yêu cầu đến phần phụ trợ của Earth Engine bằng một tài khoản dịch vụ. Điều này có lợi vì cho phép bất kỳ ai cũng có thể sử dụng ứng dụng của bạn mà không cần đăng nhập hoặc là người dùng đã đăng ký của Earth Engine. Xin lưu ý rằng hạn mức sử dụng tiêu chuẩn của Earth Engine áp dụng cho từng tài khoản dịch vụ.
Một phương pháp phát triển khác là sử dụng phương thức xác thực phía máy khách thay vì tài khoản dịch vụ. Với phương pháp này, khách truy cập vào ứng dụng của bạn phải đăng ký Earth Engine và đăng nhập. Lợi ích của phương pháp này là các yêu cầu đến Earth Engine được thực hiện bằng thông tin xác thực của người dùng cuối, vì vậy, bạn ít có khả năng đạt đến hạn mức sử dụng. Thách thức là người dùng của bạn phải đăng ký Earth Engine và đăng nhập trước khi sử dụng ứng dụng.
Thư mục minh hoạ Earth Engine App Engine trên GitHub chứa một tập hợp các ví dụ hữu ích về App Engine. Hãy xem trang Ứng dụng mẫu để biết nội dung mô tả ngắn gọn về từng ví dụ. Tài liệu này hướng dẫn cách thiết lập và triển khai các ví dụ hoặc ứng dụng tuỳ chỉnh mà bạn tạo.
Triển khai ứng dụng App Engine bằng Earth Engine
Những hướng dẫn dưới đây sẽ giải thích cách triển khai ứng dụng minh hoạ. Hướng dẫn về Python dành cho Mac OS và Linux. Nếu bạn đang sử dụng Python trên Windows, hãy thử cách này.
Bật Earth Engine API trong dự án trên đám mây của Google Cloud của bạn
Tạo hoặc chọn một dự án trên đám mây của Google rồi bật Earth Engine API theo các hướng dẫn này.
Thiết lập thông tin đăng nhập
Tài khoản dịch vụ
Bạn có thể sử dụng tài khoản dịch vụ để uỷ quyền cho các yêu cầu gửi đến Earth Engine thay mặt cho bất kỳ ai đang sử dụng ứng dụng của bạn. Tệp config.py chứa mã xác thực sử dụng địa chỉ email của tài khoản dịch vụ và tệp khoá riêng tư. Để thiết lập quy trình xác thực bằng tài khoản dịch vụ, hãy làm theo hướng dẫn này để tạo tài khoản dịch vụ và tệp khoá riêng tư. Đặt tên cho tệp khoá là .private-key.json rồi di chuyển tệp đó
vào thư mục dự án của bạn.
Python
Nếu bạn chưa làm, trước tiên, hãy thiết lập API Python của Earth Engine. Kiểm tra tài khoản dịch vụ theo hướng dẫn này.
Nếu kiểm thử thành công, hãy cập nhật config.py (hoặc tệp tương đương trong mã nguồn của bạn) bằng địa chỉ email của tài khoản dịch vụ. (Đường dẫn đến tệp khoá không được thay đổi vì tệp này nằm trong thư mục dự án của bạn).
Node.js
Cài đặt các phần phụ thuộc của dự án bằng cách chạy npm install. Earth Engine
API Node.js và mọi phần phụ thuộc khác sẽ được sao chép vào thư mục ./node_modules
trong thư mục dự án của bạn. Nếu quá trình cài đặt không thành công, hãy kiểm tra để đảm bảo rằng bạn đã cài đặt phiên bản Node.js gần đây. Xác thực và khởi chạy thư viện,
thay thế my-project bằng mã dự án Google Cloud của bạn:
const ee = require('@google/earthengine'); ee.data.authenticateViaPrivateKey('.private-key.json'); ee.initialize(null, null, null, null, null, 'my-project');
Mã ứng dụng khách OAuth 2.0
Nếu muốn người dùng tự xác thực (thay vì sử dụng tài khoản dịch vụ), bạn cần thiết lập Mã ứng dụng khách OAuth trong Dự án trên đám mây. Cách thực hiện như sau:
- Thiết lập mã ứng dụng khách theo hướng dẫn này.
- Cập nhật
static/script.js(hoặc tệp tương đương trong mã nguồn của bạn) để sử dụng mã ứng dụng khách. - Đảm bảo
ee_api_js.jscó trong thư mục/static/(hoặc tương đương). Bạn có thể tải thư viện này xuống trực tiếp từ GitHub, cài đặt từ npm hoặc nếu đã sao chép toàn bộ kho lưu trữ API EE, hãy sao chép thư viện này từearthengine-api/javascript/buildtrên hệ thống tệp cục bộ của bạn.
Thiết lập môi trường phát triển cục bộ
Python
Làm theo hướng dẫn trong từng thư mục ví dụ trên GitHub để tải xuống và xây dựng dự án. Nếu có tệp build.sh, hãy chạy tệp đó từ thư mục gốc của ứng dụng bằng lệnh:
./build.sh
Tập lệnh thiết lập sẽ tải các phần phụ thuộc xuống và cài đặt các công cụ dòng lệnh của Google nếu các công cụ này chưa có trên hệ thống của bạn. Earth Engine Python API và các phần phụ thuộc của API này sẽ được sao chép vào thư mục ./lib trong thư mục dự án của bạn.
Xác minh rằng các công cụ dòng lệnh của App Engine có sẵn bằng cách chạy:
dev_appserver.py
Nếu không tìm thấy lệnh, hãy thử tải xuống và cài đặt Google App Engine SDK cho Python theo cách thủ công. Nếu lệnh này có sẵn, thì lệnh này sẽ không thành công và báo lỗi "error: too few arguments" (lỗi: quá ít đối số).
Node.js
Không cần thiết lập.
Chạy cục bộ
Sau khi tài khoản dịch vụ của bạn được đăng ký để truy cập vào Earth Engine, bạn có thể dùng tài khoản đó để xác thực (xem config.py) khi thử nghiệm các ví dụ. Trước tiên, hãy thử kiểm thử các ví dụ trên máy bằng cách chuyển đến thư mục dự án và chạy:
Python
dev_appserver.py .
Node.js
npm install npm start
Chuyển trình duyệt của bạn đến http://localhost:8080 để xem ứng dụng đang chạy trên máy chủ cục bộ. Mọi thay đổi bạn thực hiện (và lưu) sẽ được tự động áp dụng khi bạn làm mới trang.