Thư viện ứng dụng Earth Engine cho Python và JavaScript chuyển các bản phân tích không gian địa lý phức tạp thành yêu cầu cho Earth Engine. Mã mà bạn viết cho thư viện ứng dụng có thể chứa cả tệp đối chiếu đến đối tượng phía máy khách và biến đại diện cho đối tượng phía máy chủ.
Bạn cần phân biệt các đối tượng Earth Engine với các đối tượng hoặc dữ liệu gốc khác của Python hoặc Đối tượng JavaScript có thể có trong mã của bạn. Bạn có thể thao tác với các đối tượng trên máy chủ bằng cách thao tác với các đối tượng "proxy" phía máy khách trong tập lệnh của mình. Bạn có thể nhận ra đối tượng proxy là bất kỳ đối tượng nào bắt đầu bằng ee. Các đối tượng proxy Earth Engine này không chứa bất kỳ dữ liệu thực tế nào và chỉ là các đối tượng xử lý trên máy chủ. Để bắt đầu, hãy xem xét một đối tượng chuỗi phía máy khách (KHÔNG phải là đối tượng proxy):
Trình soạn thảo mã (JavaScript)
var clientString = 'I am a String'; print(typeof clientString); // string
import ee import geemap.core as geemap
Colab (Python)
client_string = 'I am a String' print(type(client_string)) # str
Quan sát kết quả đầu ra cho thấy ứng dụng khách (trình duyệt web hoặc sổ ghi chú) đã diễn giải và chạy mã này, xác định rằng biến này thuộc loại string. Bây giờ, giả sử bạn muốn Earth Engine có thể làm gì đó với chuỗi này. Để làm được điều đó, bạn cần gói chuỗi này vào một vùng chứa phù hợp
rồi gửi đến Google. Vùng chứa đó là đối tượng proxy. Ví dụ:
Trình soạn thảo mã (JavaScript)
var serverString = ee.String('I am not a String!'); print(typeof serverString); // object print('Is this an EE object?', serverString instanceof ee.ComputedObject); // true
import ee import geemap.core as geemap
Colab (Python)
server_string = ee.String('I am not a String!') print(type(server_string)) # ee.ee_string.String print( 'Is this an EE object?', isinstance(server_string, ee.ee_string.String) ) # True
Quan sát kết quả đầu ra, bạn sẽ thấy ee.String là object, KHÔNG phải string. Cụ thể hơn, đây là một ee.computedObject, tức là một đối tượng proxy cho một nội dung nào đó trên máy chủ. Hãy coi ee.Thing là cách để đưa một nội dung vào vùng chứa để gửi đến Google. Ứng dụng khách của bạn không biết
có gì trong vùng chứa, nhưng bạn có thể tìm hiểu nội dung trong đó bằng cách in:
Trình soạn thảo mã (JavaScript)
print(serverString); // I am not a String
import ee import geemap.core as geemap
Colab (Python)
print(server_string.getInfo()) # I am not a String
Để xem vùng chứa trông như thế nào, hãy in giá trị biểu thị đối tượng ở dạng chuỗi:
Trình soạn thảo mã (JavaScript)
print(serverString.toString()); // ee.String("I am not a String!")
import ee import geemap.core as geemap
Colab (Python)
print(server_string) # ee.String({"constantValue": "I am not a String!"})
Nếu vì lý do nào đó, bạn cần sử dụng Python hoặc JavaScript chạy trong ứng dụng để thao tác với bất kỳ nội dung nào trong vùng chứa, hãy sử dụng getInfo() để lấy nội dung của vùng chứa và gán nội dung đó cho một biến:
Trình soạn thảo mã (JavaScript)
var someString = serverString.getInfo(); var strings = someString + ' Am I?'; print(strings); // I am not a String! Am I?
import ee import geemap.core as geemap
Colab (Python)
some_string = server_string.getInfo() strings = some_string + ' Am I?' print(strings) # I am not a String! Am I?
Lặp
Vì ứng dụng không biết nội dung trong các đối tượng ee.Thing phía máy chủ, nên các thao tác phía máy khách như điều kiện và vòng lặp for không hoạt động với các đối tượng đó. Vì lý do đó và để tránh các lệnh gọi đồng bộ đến getInfo(), hãy sử dụng các hàm máy chủ trong phạm vi có thể. Ví dụ: hãy xem xét hai cách tạo danh sách sau đây:
Không nên — vòng lặp for phía máy khách
Trình soạn thảo mã (JavaScript)
var clientList = []; for(var i = 0; i < 8; i++) { clientList.push(i + 1); } print(clientList);
import ee import geemap.core as geemap
Colab (Python)
client_list = [] for i in range(8): client_list.append(i + 1) print(client_list)
Nên dùng – liên kết phía máy chủ
Trình soạn thảo mã (JavaScript)
var serverList = ee.List.sequence(0, 7); serverList = serverList.map(function(n) { return ee.Number(n).add(1); }); print(serverList);
import ee import geemap.core as geemap
Colab (Python)
server_list = ee.List.sequence(0, 7) server_list = server_list.map(lambda n: ee.Number(n).add(1)) print(server_list.getInfo())
Ví dụ về việc liên kết phía máy chủ có vẻ hơi ngớ ngẩn vì bạn có thể tạo cùng một danh sách chỉ bằng ee.List.sequence(1, 8), nhưng ví dụ này minh hoạ một số khái niệm quan trọng. Khái niệm đầu tiên là map(), chỉ đơn giản là áp dụng cùng một hàm cho mọi phần tử trong danh sách. Vì hàm này được thực thi trên máy chủ, nên các hàm phía máy khách như getInfo() và print() sẽ không hoạt động trong hàm được liên kết. Vì lý do đó, bạn phải thay thế mã i + 1 bằng mã phía máy chủ tương đương: ee.Number(n).add(1). n là một đối tượng
chỉ tồn tại trên máy chủ. Vì hàm không biết loại đối số, nên cần phải truyền đối số đó đến một ee.Number.
Cũng cần lưu ý rằng đôi khi chức năng phía máy khách sẽ thuận tiện hơn. Ví dụ: bạn có thể sử dụng vòng lặp for trước đó để tạo danh sách và gói danh sách đó bằng một đối tượng phía máy chủ:
Trình soạn thảo mã (JavaScript)
var toServerList = ee.List(clientList);
import ee import geemap.core as geemap
Colab (Python)
to_server_list = ee.List(client_list)
Hãy lưu ý rằng quá trình xử lý phía máy khách được thực hiện trong sổ tay hoặc trình duyệt của bạn, CPU của máy chủ lưu trữ, vì vậy, quá trình này có thể kém hiệu quả hơn so với việc sử dụng Earth Engine để thực hiện công việc trên máy chủ. Ngoài ra, để tránh kết quả có thể gây bất ngờ, bạn nên tránh kết hợp chức năng của ứng dụng và máy chủ trong tập lệnh. Mục Điều kiện đưa ra ví dụ về những hậu quả có thể không mong muốn.
Điều kiện
Các đối tượng phía máy chủ không nhất thiết phải hoạt động với các hàm phía máy khách và ngược lại. Ví dụ: hãy xem xét trường hợp của một biến Boolean phía máy chủ:
Trình soạn thảo mã (JavaScript)
var myList = ee.List([1, 2, 3]); var serverBoolean = myList.contains(5); print(serverBoolean); // false
import ee import geemap.core as geemap
Colab (Python)
my_list = ee.List([1, 2, 3]) server_boolean = my_list.contains(5) print(server_boolean.getInfo()) # False
Như trong ví dụ sau, biến không hoạt động trong điều kiện phía máy khách vì đây là đối tượng phía máy chủ. Để kiểm tra chính xác giá trị boolean phía máy chủ, hãy sử dụng một hàm phía máy chủ:
Không nên — điều kiện phía máy khách
Trình soạn thảo mã (JavaScript)
var clientConditional; if (serverBoolean) { clientConditional = true; } else { clientConditional = false; } print('Should be false:', clientConditional); // True!
import ee import geemap.core as geemap
Colab (Python)
if server_boolean: client_conditional = True else: client_conditional = False print('Should be False:', client_conditional) # True!
Nên dùng – có điều kiện phía máy chủ
Trình soạn thảo mã (JavaScript)
var serverConditional = ee.Algorithms.If(serverBoolean, 'True!', 'False!'); print('Should be false:', serverConditional); // False!
import ee import geemap.core as geemap
Colab (Python)
server_conditional = ee.Algorithms.If(server_boolean, 'True!', 'False!') print('Should be False:', server_conditional.getInfo()) # False!
Hàm máy khách và máy chủ
Các phần trước mô tả một số lý do khiến việc kết hợp các đối tượng và hàm của máy khách và máy chủ là không hiệu quả hoặc không hợp lý. Đối tượng và hàm nào thuộc phía máy khách và đối tượng và hàm nào thuộc phía máy chủ? Nhìn chung, mọi đối tượng được khởi tạo dưới dạng ee.Thing đều là đối tượng máy chủ và mọi phương thức trên đối tượng đó (ee.Thing.method()) đều là hàm máy chủ. Các đối tượng và hàm xuất hiện trong tài liệu tham khảo về Python hoặc JavaScript đều nằm ở phía máy khách. Như đã lưu ý trước đó, bạn có thể sử dụng chức năng phía máy khách để tạo một đối tượng, sau đó gói đối tượng đó bằng cách cung cấp đối tượng phía máy khách cho một hàm khởi tạo Earth Engine, ví dụ: ee.String().