CBRSGEE专栏 | 1 JavaScript and the Earth Engine API（一）

1 理论介绍

1.1 Earth Engine API简介

       Google Earth Engine是一个基于云的科学数据分析平台。它提供了现成的、云托管的数据集及一个庞大的服务器池。使GEE特别吸引人的一个特点是通过在大型服务器池中分布它们来快速运行大型计算。有效地使用云托管的数据集和计算是通过Earth Engine API实现的。

       API是与GEE服务器通信的一种方式。它允许您指定您想要进行的计算，然后接收结果。API的设计使用户无需担心计算如何在一组机器集群中分布和汇总结果。API的用户只需指定需要完成的任务。这极大地简化了代码，将实现细节隐藏在用户之外。这也使GEE对于不熟悉编写代码的用户非常易于使用。

       GEE API被设计为与语言无关。Google提供了官方客户端库，可用于从JavaScript和Python使用API。无论使用哪种编程语言，API基本保持不变。主要区别在于调用API函数时使用的语法。一旦掌握了编程语言的语法，您的代码可以轻松适应，因为它们都使用相同的API函数。

1.2 为什么选择JavaScript编程语言?

       对许多人来说，JavaScript可能不是首选的编程语言，一些人可能会想知道为什么会基于JavaScript API而不是Python或R。

       GEE JavaScript API是最成熟和最易于使用的API。GEE平台配备了基于Web的代码编辑器，让您可以在不需要任何安装的情况下开始使用GEE JavaScript API。它还提供额外的功能，可以在地图上显示您的结果，保存您的脚本，访问文档，管理任务等。它具有一键RUN机制，可与其他用户共享您的代码，从而实现易于重现性和协作。此外，JavaScript API还配备了用户界面库，可以帮助您轻松创建图表和基于Web的应用程序。

       在实践中，您无需成为JavaScript专家即可使用GEE。这里描述的基本语法应该足够了。一个好的建议是，如果您发现在JavaScript中做某些复杂的事情，那么在GEE中可能会做得更好。GEE中的所有重要计算都需要使用API函数，即使是基本操作——例如在Earth Engine中将两个数字相加，也应该使用Earth Engine API完成。

2 实操练习

2.1 在代码编辑器中入门

       代码编辑器是用于GEE JavaScript API的集成开发环境。它提供了一个简单的方法来输入、调试、运行和管理代码。当您首次访问代码编辑器时，您将看到一个类似于下图所示的屏幕。

       代码编辑器（见图1.1）允许您输入JavaScript代码并执行它。当您首次学习一门新语言并适应新的编程环境时，习惯上会编写一个程序来显示“Hello World”这几个单词。这是一个开始编码的有趣方式，它向您展示如何向程序输入数据以及如何执行它。同时，它显示程序输出的位置。在JavaScript中，这样做非常简单。将以下代码复制到中央面板中：

print('Hello World');

       以上代码使用JavaScript的“print”函数将文本“Hello World”打印到屏幕上。输入代码后，点击Run按钮。输出将显示在Console选项卡下方右上角面板上。

       现在您知道在哪里输入您的代码，如何运行它，以及在哪里查找输出。您刚编写了您的第一个Earth Engine脚本，可能想要保存它。点击Save按钮。

       如果这是您第一次使用代码编辑器，系统将提示您创建一个主文件夹。这是一个云端文件夹，您所有的代码都将保存在其中。您可以选择一个您喜欢的名称，但请记住，它将无法更改，并且将永远与您的账户关联。一个好的选择是使用您的谷歌账户用户名作为文件夹名称。

       一旦您的主文件夹创建完成，系统将提示您输入一个新的存储库。存储库可以帮助您组织和共享代码。您的账户可以拥有多个存储库，每个存储库内可以包含多个脚本。初次使用时，您可以创建一个名为“default”的存储库。

       最后，您将能够将脚本保存在新创建的存储库中。输入名称“hello_world”，然后点击确定（OK）。

       脚本保存后，它将显示在脚本管理器面板（Script）中。脚本保存在云端，当您打开代码编辑器时将始终对您可见。

       现在，您应该熟悉了在代码编辑器中创建、运行和保存脚本的方法。