FeatureView 是 FeatureCollection 的只能观看加速表示。与 FeatureCollection(其光栅地图图块是实时生成的)不同,FeatureView 光栅图块是预先计算的,可提供快速渲染。除了渲染速度更快之外,FeatureView 资源还实现了依赖于缩放级别的地图项稀疏化。其效果是,密集的数据集在缩小时可能看起来不完整(未绘制小地图项),但随着您放大,更多数据会变得可见,这可以改善较低缩放级别下的地图美观度。数据集的稀疏行为由多个优化参数控制,这些参数是在将 FeatureCollection 导出到 FeatureView 资源期间设置的。
作为只能查看的资源,FeatureView 对象不能包含在计算或表达式中,但可以在 JavaScript 代码编辑器和 Earth Engine 应用中作为 FeatureViewLayer 进行可视化和检查。它们还可以集成到 Google 地图 API 应用中。
创建 FeatureView
创建 FeatureView 涉及准备包含数据的 FeatureCollection、调用 Export.table.toFeatureView 函数以及启动导出任务。以下示例演示了如何导出 WDPA 多边形数据集的视图。在您自己的应用中,使用 Earth Engine Data Catalog 中归档的任何 FeatureCollection 数据集,或通过上传矢量数据集作为 Earth Engine 资产来创建您自己的数据集。
您可以使用 Export.table.toFeatureView 函数中的多个参数自定义 FeatureView。
maxFeaturesPerTile- 定义在给定缩放级别下,地图图块中显示的地物数量上限。使用此参数可针对速度或特征密度进行优化。thinningStrategy- 控制是否应针对给定图块和缩放级别优化地图项稀疏化,以提高密度或图块间密度的一致性。请注意,针对更高密度进行优化可能会导致图块边界变得明显,因为每个图块的地图项密度是独立的。thinningRanking- 定义特征细化优先级。例如,您可以优化稀疏化,以保留具有高值的特定要素属性,也就是说,当您缩小比例时,所选属性值较低的要素将首先被稀疏化,从而使最重要的要素(根据您的规则)保持可见。zOrderRanking- 定义地图上显示的地图项的 Z 轴顺序(叠放顺序)。此参数可让您根据地图项属性、几何图形类型和缩放级别设置优先级规则,从而控制重叠地图项的显示方式。例如,您可以优先显示具有特定属性高值的地图项,使其叠加在具有低值的相交地图项之上。
如需详细了解这些参数及其接受的实参,请参阅 FeatureView 优化页面。
在以下示例中,为这些参数指定的实参会生成一个 FeatureView,其中在给定缩放级别下,每个图块的最大地图项数为 1500,每个图块的地图项密度是独立的,并且允许达到最大值 1500,较小的多边形会先被剔除,较小的多边形位于较大的多边形之上。
代码编辑器 (JavaScript)
// Import the WDPA feature collection. var wdpa = ee.FeatureCollection('WCMC/WDPA/current/polygons'); // Export the WDPA FeatureCollection as a FeatureView asset. Export.table.toFeatureView({ collection: wdpa, assetId: 'wdpa-featureview-demo', description: 'wdpa-featureview-demo', maxFeaturesPerTile: 1500, thinningStrategy: 'HIGHER_DENSITY', thinningRanking: ['REP_AREA DESC'], zOrderRanking: ['REP_AREA DESC'], });
在代码编辑器中执行上述代码段将生成一个导出任务;运行该任务即可启动导出。
FeatureView 资产位置
FeatureView 资源可以在公共Data Catalog中找到,也可以在代码编辑器的资源标签页中的个人资源中找到。Data Catalog 中的所有相关 FeatureCollection 资源都有一个随播 FeatureView 资源,该资源具有普遍适用的提取设置。您的个人素材资源归档将包含您创建的所有 FeatureView 素材资源。
将 FeatureView 资源导入脚本
您可以使用代码编辑器资源对话框和个人资源条目中的按钮,以及通过向 ui.Map.FeatureViewLayer 构造函数提供 FeatureView 资产 ID 作为输入,将 FeatureView 资产导入代码编辑器脚本。
Data Catalog 资产对话框
从代码编辑器的搜索栏访问的 Data Catalog 表资源对话框右下角有一个导入按钮,该按钮带有下拉菜单。从下拉菜单中选择“导入 FeatureView”。该素材资源将包含在脚本顶部的导入部分中。
“个人资产”对话框
个人 FeatureView 资产对话框(通过从代码编辑器的资产标签页中选择资产来访问)的右上角有一个导入按钮。启用该按钮后,该资源将包含在脚本顶部的导入部分中。您还可以使用导入快捷按钮(向右箭头图标),该按钮会在您将鼠标悬停在素材资源标签页中的素材资源上时显示。
资产 ID
FeatureView 素材资源具有一个 ID,该 ID 可作为输入提供给 ui.Map.FeatureViewLayer 构造函数,以便您在脚本中访问该素材资源。您可以在代码编辑器中的数据目录资产页面和资产对话框中找到预先构建的导入代码段。

图 1. Data Catalog 资产对话框,其中突出显示了 FeatureView 导入方法。
FeatureView 元数据
FeatureView 信息和元数据可在上述 FeatureView 资产位置部分中提到的资产对话框中找到。除了可能与来源 FeatureCollection 共享的说明和属性之外,FeatureView 还有五个独有的属性。它们包括创建 FeatureView 部分中介绍的提取参数设置,以及 sourceVersion,即创建 FeatureView 的表资产的“上次修改”时间戳。上图 1 显示了 Data Catalog 资产对话框中FeatureView特有的属性。与其他资源一样,您也可以通过编程方式从 ee.data.getAsset 返回的字典中提取属性。
直观呈现 FeatureView
FeatureView 对象可在代码编辑器、Earth Engine 应用和 Google 地图中直观呈现。
代码编辑器
代码编辑器包含 ui.Map.FeatureViewLayer 组件,用于在地图上直观呈现 FeatureView 资源。以下示例定义了一个 FeatureView 资产 ID,将该资产导入为 FeatureViewLayer,并将其显示在地图上。
代码编辑器 (JavaScript)
// Define the FeatureView asset ID. var assetId = 'WCMC/WDPA/current/polygons_FeatureView'; // Import the FeatureView asset as a FeatureViewLayer. var layer = ui.Map.FeatureViewLayer(assetId); // Add the FeatureViewLayer to the map. Map.add(layer);
样式
您可以通过以下方式设置 FeatureViewLayer 的样式:将样式字典传递给 ui.Map.FeatureViewLayer 函数,或使用 setVisParams 方法将样式字典添加到图层。以下示例设置了以下内容的样式:
- 轮廓颜色基于“MARINE”属性(保护区是完全还是部分位于海洋环境中),
- 填充颜色基于“IUCN_CAT”属性(国际自然保护联盟 [IUCN] 类别),
- 填充不透明度。
如需详细了解可用的样式选项,请访问 FeatureView 样式页面。
代码编辑器 (JavaScript)
// Set visualization properties for the defined layer. layer.setVisParams({ color: { property: 'MARINE', categories: [ ['0', 'purple'], ['1', 'green'], ['2', 'blue'], ] }, fillColor: { property: 'IUCN_CAT', defaultValue: 'd3d3d3', categories: [ ['Ia', 'a6cee3'], ['Ib', '1f78b4'], ['II', 'b2df8a'], ['III', '33a02c'], ['IV', 'fb9a99'], ['V', 'e31a1c'], ['VI', 'fdbf6f'], ] }, fillOpacity: { property: 'REP_AREA', mode: 'interval', palette: [ [0, 0.5], [80, 0.35], [2000, 0.22], [5000, 0.15], ], }, width: 1.0, pointSize: 6.0, });
过滤条件
您可以应用过滤规则,根据地图项的属性有选择地设置地图项样式或隐藏地图项。例如,如需滤除小于滑块微件给定的特定面积的保护区,您可以使用以下代码。如需详细了解 rules 字段,请参阅 FeatureView 样式设置页面的具体规则部分。
代码编辑器 (JavaScript)
// Define the FeatureView asset ID. var assetId = 'WCMC/WDPA/current/polygons_FeatureView'; // Import the FeatureView asset as a FeatureViewLayer. var layer = ui.Map.FeatureViewLayer(assetId, null, 'WDPA FeatureViewLayer'); // Callback function to update FeatureViewLayer style. var updateVisParams = function() { layer.setVisParams({ color: { property: 'MARINE', categories: [ ['0', 'purple'], ['1', 'green'], ['2', 'blue'], ] }, fillColor: { property: 'IUCN_CAT', defaultValue: 'd3d3d3', categories: [ ['Ia', 'a6cee3'], ['Ib', '1f78b4'], ['II', 'b2df8a'], ['III', '33a02c'], ['IV', 'fb9a99'], ['V', 'e31a1c'], ['VI', 'fdbf6f'], ] }, fillOpacity: { property: 'REP_AREA', mode: 'interval', palette: [ [0, 0.5], [80, 0.35], [2000, 0.22], [5000, 0.15], ], }, width: 1.0, pointSize: 6.0, rules: [ { filter: ee.Filter.lt('REP_AREA', filterSlider.getValue()), isVisible: false, }, ], }); }; // Slider widget that calls the updateVisParams function on change. var filterSlider = ui.Slider({ min: 0, max: 10000, step: 10, value: 0, style: { stretch: 'horizontal'}, onChange: updateVisParams, }); var filterSliderLabel = ui.Label( 'Adjust slider to hide features less than the specified area (km²)'); // Add the slider to the map. Map.add(ui.Panel([filterSliderLabel, filterSlider])); // Initialize the FeatureViewLayer style. updateVisParams(); // Add the FeatureViewLayer to the map. Map.add(layer);

图 2. FeatureViewLayer可视化,其中包含一个滑块微件,用于隐藏小于指定面积的要素。
Google 地图 API
使用 Google 地图 API 将 FeatureView 资源可视化的过程分为四个部分:使用 ee.data.getFeatureViewTilesKey 获取图块键,将其传递给 FeatureViewTileSource 的实例,构建 ee.layer.ImageOverlay,然后将叠加层添加到 google.maps.Map 实例。下面显示了用于在 JavaScript 中构建 ImageOverlay 的示例代码。
var tilesKey = ee.data.getFeatureViewTilesKey({
assetId: 'WCMC/WDPA/current/polygons_FeatureView',
visParams: { … },
});
var tileSource = new ee.layers.FeatureViewTileSource(tilesKey);
var overlay = new ee.layers.ImageOverlay(tileSource);
完成后,您可以将叠加层添加到 google.maps.Map 实例,如下所示。
// embeddedMap is your google.maps.Map instance.
embeddedMap.overlayMapTypes.setAt(0, overlay);
检查 FeatureView
您可以使用检查器工具检查添加到默认代码编辑器地图中的 FeatureViewLayer 图层。其功能与 FeatureCollection 相同。请注意,针对所点击位置返回的结果仅会列出在当前缩放级别下可见的地图项。由于几何图形在 FeatureView 导出过程中被简化,因此不会显示在检查的地图项中。

图 3. 检查 FeatureViewLayer。检查器会显示图层、地图项、资产 ID 和可视化参数。