导入表数据

上传表格素材资源

您可以使用素材资源管理器命令行界面 (CLI) 上传 Shapefile 或 CSV 格式的数据集。(如需详细了解如何使用代码编辑器或 CLI 导入栅格数据,请参阅导入栅格数据。)您上传的资源最初是私享的,但可以按照“共享资源”部分中所述的方式进行共享。

上传 Shapefile

如需从代码编辑器上传 Shapefile,请点击 按钮,然后选择 Table Upload(表格上传)部分下的 Shape files(Shapefile)。系统会显示一个类似于图 1 的上传对话框。点击 SELECT 按钮,然后在本地文件系统中找到包含 Shapefile 的 Shapefile 或 Zip 归档。选择 .shp 文件时,请务必选择相关的 .dbf、.shx 和 .prj 文件。如果未提供 .prj 文件,Earth Engine 将默认使用 WGS84(经度、纬度)坐标。如果您要上传 ZIP 归档文件,请确保其中仅包含一个 Shapefile(一组 .shp、.dbf、.shx、.prj 等文件),且没有重复的文件名。请确保文件名不包含额外的英文句点或圆点。(文件名将在扩展名前面包含一个英文句点。)

在您的用户文件夹中为表分配一个合适的素材资源 ID(该 ID 应不存在)。点击上传以开始上传。

资产
图 1. 资产管理器 Shapefile 上传对话框。请注意,.shp、.dbf 和 .shx 文件是必需的。其他边车文件为可选文件。如果未提供 .prj 文件,则假定为 WGS84。

上传 CSV 文件

如需通过代码编辑器上传 CSV 文件,请激活素材资源标签页,然后点击 按钮,然后选择表格上传部分下的 CSV 文件。系统会显示一个类似于图 2 的上传对话框。点击 SELECT(选择)按钮,然后前往本地文件系统中的 .csv 文件。为表指定一个相关且具有唯一性的素材资源 ID 名称。 点击“确定”以开始上传。

资产
图 2. 资产管理器 CSV 文件上传对话框。

CSV 文件应包含每项地图项对应的一行,并且列数应与地图项集的属性或变量数量相同。如果地图项是地理空间地图项,则必须具有由几何图形字符串 (GeoJSON、WKT) 或 x 和 y 位置属性定义的地理位置。 如果 CSV 文件是从 GIS 或地理空间数据工具(例如 GDAL/OGR)导出的,则应该已经存在格式正确且命名正确的几何图形列。 或者,您也可以在电子表格应用中定义两个表示点位置的 x 坐标和 y 坐标列,并将其与任何其他变量一起以 CSV 格式导出。

高级选项

在上传对话框的高级选项部分中,查看和更改默认设置。通过拆分具有大量顶点的几何图形,可以提升 Earth Engine 的性能。Earth Engine 不允许地图项的顶点数超过 100 万个。在表上传期间,Earth Engine 会自动拆分顶点数超过 100 万的几何图形。您可以指定较低的值以提高矢量渲染性能。

Earth Engine 会尝试检测主几何图形列,并假定数据投影为 WGS84,除非另有说明。几何图形的测地线状态由给定投影的默认边缘解读决定(例如,WGS84 使用测地线几何图形),但可以在“高级设置”菜单中替换此设置。如果数据的几何图形是由 x 列和 y 列定义的点,请务必将相应列命名为“经度”和“纬度”,或在“高级设置”下指定 x 列和 y 列名称。

跟踪上传进度

开始上传表后,系统会将“提取资源”任务添加到任务管理器中,该任务位于代码编辑器右侧的 Tasks 标签页下。点击 ? 查看上传状态图标。如需取消上传,请点击相应任务旁边的旋转图标 。提取完成后,任务单元格会变为蓝色,并且资源会显示在您的用户文件夹中的素材资源标签页下,带有 图标。

表上传限制

上传表时,表中特征的数量上限为 1 亿。地图项上的房源数量上限为 1,024 个。这些限制可确保能够高效地查询生成的素材资源。此外,每个地图项都有顶点数量上限,如上文“高级选项”部分所述。

将表格素材资源加载到脚本中

如需在脚本中根据表格素材资源创建 FeatureCollection,请按照管理素材资源页面中的说明导入该素材资源。