Клиент и сервер

Клиентские библиотеки Earth Engine для Python и JavaScript преобразуют сложный геопространственный анализ в запросы Earth Engine. Код, который вы пишете для клиентской библиотеки, может содержать смесь ссылок на объекты на стороне клиента и переменные, представляющие объекты на стороне сервера.

Важно отличать объекты Earth Engine от других объектов или примитивов Python или JavaScript, которые могут быть в вашем коде. Вы можете управлять объектами на сервере, управляя клиентскими "прокси-объектами" в скрипте. Объекты-прокси можно распознать по префиксу ee. Эти прокси-объекты Earth Engine не содержат фактических данных и являются лишь дескрипторами объектов на сервере. Для начала рассмотрим клиентский строковый объект (который НЕ является прокси-объектом):

Редактор кода (JavaScript)

var clientString = 'I am a String';
print(typeof clientString);  // string

Настройка Python

Информацию о Python API и использовании geemap для интерактивной разработки можно найти на странице Среда Python.

import ee
import geemap.core as geemap

Colab (Python)

client_string = 'I am a String'
print(type(client_string))  # str

Обратите внимание, что клиент (браузер или блокнот) интерпретировал и выполнил этот код, определив, что переменная относится к типу string. Теперь предположим, что вы хотите, чтобы Earth Engine мог что-то сделать с этой строкой. Для этого нужно поместить строку в контейнер и отправить его в Google. Этот контейнер и есть прокси-объект. Пример:

Редактор кода (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

Настройка Python

Информацию о Python API и использовании geemap для интерактивной разработки можно найти на странице Среда Python.

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

Обратите внимание, что в выходных данных ee.String – это object, а не string. Точнее, это ee.computedObject, то есть прокси-объект для чего-то на сервере. Представьте, что ee.Thing – это способ поместить объект в контейнер для отправки в Google. Клиент не знает, что находится в контейнере, но вы можете узнать это, распечатав его:

Редактор кода (JavaScript)

print(serverString);  // I am not a String

Настройка Python

Информацию о Python API и использовании geemap для интерактивной разработки можно найти на странице Среда Python.

import ee
import geemap.core as geemap

Colab (Python)

print(server_string.getInfo())  # I am not a String

Чтобы посмотреть, как выглядит сам контейнер, выведите строковое представление объекта:

Редактор кода (JavaScript)

print(serverString.toString());  // ee.String("I am not a String!")

Настройка Python

Информацию о Python API и использовании geemap для интерактивной разработки можно найти на странице Среда Python.

import ee
import geemap.core as geemap

Colab (Python)

print(server_string)  # ee.String({"constantValue": "I am not a String!"})

Если вам по какой-то причине нужно использовать Python или JavaScript на стороне клиента для работы с содержимым контейнера, используйте getInfo(), чтобы получить содержимое контейнера и присвоить его переменной:

Редактор кода (JavaScript)

var someString = serverString.getInfo();
var strings = someString + '  Am I?';
print(strings);  // I am not a String!  Am I?

Настройка Python

Информацию о Python API и использовании geemap для интерактивной разработки можно найти на странице Среда Python.

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?

Повтор

Поскольку клиент не знает, что находится в серверных ee.Thing объектах, клиентские операции, такие как условные выражения и циклы for, не работают с ними. По этой причине, а также чтобы избежать синхронных вызовов getInfo(), по возможности используйте серверные функции. Например, рассмотрим два способа создания списка:

Не рекомендуется – клиентский цикл for

Редактор кода (JavaScript)

var clientList = [];
for(var i = 0; i < 8; i++) {
  clientList.push(i + 1);
}
print(clientList);

Настройка Python

Информацию о Python API и использовании geemap для интерактивной разработки можно найти на странице Среда Python.

import ee
import geemap.core as geemap

Colab (Python)

client_list = []
for i in range(8):
  client_list.append(i + 1)
print(client_list)

Рекомендуемый вариант – сопоставление на стороне сервера

Редактор кода (JavaScript)

var serverList = ee.List.sequence(0, 7);
serverList = serverList.map(function(n) {
  return ee.Number(n).add(1);
});
print(serverList);

Настройка Python

Информацию о Python API и использовании geemap для интерактивной разработки можно найти на странице Среда Python.

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())

Пример сопоставления на стороне сервера может показаться немного глупым, поскольку вы можете создать такой же список, просто используя ee.List.sequence(1, 8), но он иллюстрирует некоторые важные концепции. Первая концепция – map(), которая просто применяет одну и ту же функцию ко всем элементам списка. Поскольку эта функция выполняется на сервере, клиентские функции, такие как getInfo() и print(), не будут работать в сопоставленной функции. Поэтому код i + 1 нужно заменить эквивалентным кодом на стороне сервера: ee.Number(n).add(1). n – это объект, который существует только на сервере. Поскольку функция не знает тип своего аргумента, его необходимо привести к ee.Number.

Подробнее о функциях, выполняемых на стороне клиента и сервера…

Также стоит отметить, что иногда клиентская функциональность может быть удобна. Например, предыдущий цикл for можно использовать для создания списка и его упаковки в объект на стороне сервера:

Редактор кода (JavaScript)

var toServerList = ee.List(clientList);

Настройка Python

Информацию о Python API и использовании geemap для интерактивной разработки можно найти на странице Среда Python.

import ee
import geemap.core as geemap

Colab (Python)

to_server_list = ee.List(client_list)

Помните, что клиентская обработка выполняется в вашем блокноте или браузере, на ЦП хост-машины, поэтому она может быть менее эффективной, чем использование Earth Engine для выполнения работы на сервере. Кроме того, чтобы избежать неожиданных результатов, рекомендуется не смешивать в скриптах клиентские и серверные функции. В разделе Условные операторы приведен пример возможных непредвиденных последствий.

Условные предложения

Серверные объекты не всегда работают с клиентскими функциями, и наоборот. Рассмотрим пример с логической переменной на стороне сервера:

Редактор кода (JavaScript)

var myList = ee.List([1, 2, 3]);
var serverBoolean = myList.contains(5);
print(serverBoolean);  // false

Настройка Python

Информацию о Python API и использовании geemap для интерактивной разработки можно найти на странице Среда Python.

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

Как показано в примере ниже, переменная не работает в клиентском условии, поскольку она является серверным объектом. Чтобы правильно проверить логическое значение на стороне сервера, используйте функцию на стороне сервера:

Не рекомендуется – клиентское условное выражение

Редактор кода (JavaScript)

var clientConditional;
if (serverBoolean) {
  clientConditional = true;
} else {
  clientConditional = false;
}
print('Should be false:', clientConditional);  // True!

Настройка Python

Информацию о Python API и использовании geemap для интерактивной разработки можно найти на странице Среда Python.

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!

Рекомендуется – условная на стороне сервера.

Редактор кода (JavaScript)

var serverConditional = ee.Algorithms.If(serverBoolean, 'True!', 'False!');
print('Should be false:', serverConditional);  // False!

Настройка Python

Информацию о Python API и использовании geemap для интерактивной разработки можно найти на странице Среда Python.

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!

Функции клиента и сервера

В предыдущих разделах описано несколько причин, по которым неэффективно или нелогично смешивать объекты и функции клиента и сервера. Какие объекты и функции относятся к клиентской стороне, а какие – к серверной? В общем случае все, что инициализировано как ee.Thing, является объектом сервера, а любой метод этого объекта, ee.Thing.method(), – функцией сервера. Объекты и функции, которые появляются в справочнике по Python или JavaScript, являются клиентскими. Как отмечалось ранее, вы можете использовать клиентскую функциональность для создания объекта, а затем обернуть его, передав клиентский объект конструктору Earth Engine, например ee.String().