Concepts

此 API 可提供对各种地理空间图像数据的简单统一的访问。地理空间是指数据与地球表面的位置相关联。图像数据是指以像素值均匀网格形式结构化的数据，与传统图像非常相似。

此类数据最常见的示例是卫星图像，与用户在 Google 地图和 Google 地球中看到的图像非常相似。不过，许多其他数据集具有相同的结构，例如网格化天气和气候数据集、地形和土地覆盖数据集以及人口密度数据集。

身份验证

Earth Engine API 使用 OAuth 2.0 协议进行身份验证和授权。我们提供了便捷的库，可用于以各种语言通过 OAuth 2.0 发出 API 调用。如果您之前未使用过 OAuth 2.0 访问 Google API，不妨先熟悉一下使用 OAuth 2.0 访问 Google API 文档。

此 API 使用 Earth Engine OAuth 2.0 范围 https://www.googleapis.com/auth/earthengine.readonly。如果您自行配置服务账号凭据，则需要明确请求该范围。如果您使用的是 Compute Engine 虚拟机实例中提供的默认应用凭据，则需要配置您的虚拟机实例以请求该范围。

素材资源

Earth Engine 数据模型的核心是类似文件系统的资源结构。资源主要有三种类型，具体说明如下：地理空间栅格数据本身存储在图片中，图片可以分组为大型集合，图片和集合还可以进一步整理到文件夹的层次结构中。

例如，以下路径描述了特定的 Landsat 影像：

LANDSAT/LC8_L1T/LC81180562013193LGN00

在此示例中，LANDSAT 是包含所有 Landsat 数据的顶级文件夹，LC8_L1T 用于标识一组特定的经过校准和地形校正的 Landsat 8 图像，而 LC81180562013193LGN00 用于标识该集合中的特定图像。资源路径可以包含字母、数字、下划线和连字符，并以正斜杠分隔。

每张图片都包含元数据，可用于轻松识别感兴趣的数据。这些图片级元数据属性通常包括：

• 图像的覆盖区几何图形，例如卫星图像或地形数据集的空间范围。
• 图片的相应时间戳，例如卫星图像采集时间，或气候模型数据集中的日期或月份。
• 任意键值属性，例如 Landsat 卫星图像的估计云覆盖百分比。

像素和地图投影

在 Earth Engine 中，每张图片都包含一个或多个数据波段。这些变量可能对应于普通 RGB 卫星影像的红色、绿色和蓝色波段，也可能对应于完全不同的内容，例如天气数据集中的温度和降水。每个波段中的像素都具有特定的数据类型，例如 uint8 或 float32。

像素网格中的像素通过一种称为地图投影的数学函数对应于地球表面上的点。这种关系通常包含两个组成部分。首先，坐标参考系 (CRS) 定义了表示地球曲面上的点的二维坐标。不同的坐标参考系具有不同的属性，因此适合在不同的应用中使用不同类型的数据。坐标参考系通常使用标准标识符代码进行标识；常见的示例包括等距圆柱、Web 墨卡托和 UTM 坐标。

然后，像素坐标通常通过控制像素网格的物理比例和原点的仿射转换与空间坐标参考系统相关联。在 Earth Engine 中，我们会为每个图片存储一个数据金字塔：金字塔的基础层包含原始分辨率的原始数据，而金字塔的更高级别则存储分辨率降低的概览数据。金字塔的这些层级由仿射转换描述，其缩放比例相差 2 的连续倍数。

集合和文件夹

图片通常以大型数据集合的形式呈现，例如特定卫星采集的所有图片集合，或随时间变化的全球温度估计值集合。Earth Engine 会构建元数据索引，让您可以根据集合中图片的元数据过滤或查询图片，包括按位置和时间进行过滤。通常，单个集合中的所有图片都具有相同的结构，即相同的波段和相同的元数据属性。

图片和合集本身会整理成文件夹层次结构。文件夹非常类似于传统文件系统中的普通文件夹或目录：它是一个简单的容器，用于存放其他资源，即图片、合集和其他文件夹。并非所有图片都包含在集合中：某些数据集（例如特定的全球地形模型）可能只包含一张图片。无论如何，每项资源都由一个特定路径唯一标识，该路径用于标识资源在 Earth Engine 数据目录中的位置。