创建和管理数据集

您可以利用数据集将地理空间数据从本地文件或 Google Cloud Storage 上传到 Google Maps Platform。然后,在 Cloud 控制台中将数据集与一个或多个地图样式相关联。将数据集与地图样式相关联后,便可使用数据驱动型样式 API 动态地设置地图应用的样式。

您还可以使用 REST API 将地理空间数据上传至数据集。如需更多信息 请参阅 Maps Datasets API

配置角色

如需在 Google Cloud 项目中创建和管理数据集,您必须具有项目的 Owner 或 Editor IAM 角色

或者,您可以将以下 IAM 角色分配给用于管理数据集的用户账号或服务账号:

  • Maps Platform Datasets Admin 角色可向用户账号或服务账号授予对项目中数据集的读写权限。具有此角色的用户可对数据集执行所有操作。
  • Maps Platform Datasets Viewer 角色可授予对项目中数据集的只读权限。具有此角色的用户可对数据集执行列出、获取或下载操作。

如需了解详情,请参阅使用 Google Cloud 控制台授予 IAM 角色

数据集的数据源

创建数据集后,您可以将数据从 Google Cloud Storage 或本地文件上传至数据集。
  • 从 Cloud Storage 上传数据时,请指定 Cloud Storage 中数据所属资源的文件路径。路径格式为:gs://GCS_BUCKET/FILE

    发出请求的用户需要具有 Storage Object Viewer 角色或包含 storage.objects.get 权限的任何其他角色。如需详细了解如何管理对 Cloud Storage 的访问权限,请参阅访问权限控制概览

  • 从本地文件上传数据时,请指定包含要上传的数据的 GeoJSON、KML 或 CSV 文件的路径。

前提条件

创建数据集时:

  • 显示名称在 Google Cloud 项目中必须是唯一的。
  • 显示名称长度必须少于 64 个字节(由于这些字符采用 UTF-8 编码表示,因此在某些语言中,每个字符可以由多个字节表示)。
  • 说明文字长度必须少于 1,000 个字节。

上传数据时:

  • 支持的文件类型为 CSV、GeoJSON 和 KML。
  • 支持的文件大小上限为 500 MB。
  • 属性列名称不能以字符串“?_”开头。
  • 不支持三维几何图形。此类图形在 WKT 格式中包含“Z”后缀,在 GeoJSON 格式中包含海拔高度坐标。

数据准备最佳做法

源数据复杂或大型(例如密集点、长线串或多边形) (通常超过 50 MB 的源文件属于此类别),考虑简化数据 然后再上传,以便在直观地图中实现最佳效果。

以下是一些准备数据的最佳做法:

  1. 最小化地图项属性。仅保留设置样式所需的地图项属性 您的地图,例如“id”和“category”您可以将其他媒体资源与客户端中的某项功能联接 在唯一标识符键上使用数据驱动型样式的应用。有关示例,请参见 使用数据驱动型样式设置实时查看数据
  2. 尽可能为属性对象使用简单的数据类型,例如整数、 以尽量减小图块大小并提高地图性能。
  3. 在上传文件之前简化复杂的几何图形。您可以在 您选择的地理空间工具,例如开源的 Mapshaper.org 实用程序,或在 BigQuery 中使用 ST_Simplify 绘制复杂多边形几何图形。
  4. 聚类非常密集的点,然后再上传文件。您可以在 您选择的地理空间工具,例如开源的 turf.js 集群函数,或者在 BigQuery 中 (使用 ST_CLUSTERDBSCAN) 来预测密集点几何图形

如需更多关于数据集最佳做法的指南,请参阅 使用数据集和 BigQuery 直观呈现您的数据

与 GeoJSON 相关的要求

Maps SDK for iOS 支持当前的 GeoJSON 规范。 Maps SDK for iOS 还支持包含以下任何对象类型的 GeoJSON 文件:

  • 几何图形对象。几何图形对象是一种空间形状,由一组点、线和具有可选孔的多边形所组成。
  • 地图项对象。地图项对象包含几何图形以及其他“名称-值”对,其含义因应用而异。
  • 地图项集合。地图项集合是一组地图项对象。

Maps SDK for iOS 不支持在坐标参考系统中包含数据的 GeoJSON 文件 (CRS)(除 WGS84 以外)。

如需详细了解 GeoJSON,请参阅符合 RFC 7946 标准

与 KML 相关的要求

Maps SDK for iOS 具有以下要求:

  • 所有网址都必须是文件本身的本地(或相对)网址。
  • 支持点、线和多边形几何图形。
  • 所有数据属性均被视为字符串。
不支持以下 KML 地图项:
  • 在文件以外定义的图标或 <styleUrl>
  • 网络链接,例如 <NetworkLink>
  • 地面叠加层,例如 <GroundOverlay>
  • 三维几何图形或与海拔高度相关的任何标记,例如 <altitudeMode>
  • 摄像头规范,例如 <LookAt>
  • 在 KML 文件内定义的样式。

与 CSV 相关的要求

下方列出了 CSV 文件支持的列名称(按优先级顺序):

  • latitudelongitude
  • latlong
  • xy
  • wkt(已知文本)
  • addresscitystatezip
  • address
  • 包含所有地址信息的单个列,例如 1600 Amphitheatre Parkway Mountain View, CA 94043

例如,您的文件包含名为 xywkt 的列。根据上面列表中受支持的列名称的顺序,xy 的优先级较高,因此,系统将使用 xy 列中的值,并忽略 wkt 列。

此外:

  • 每个列名称都必须属于单个列。也就是说,不能有同时包含 x 和 y 坐标数据的名为 xy 的列。x 坐标和 y 坐标的数据必须位于不同的列中。
  • 列名称不区分大小写。
  • 列名称的顺序无关紧要。例如,如果您的 CSV 文件包含 lat 列和 long 列,这两列可以按任意顺序显示。

处理数据上传错误

将数据上传到数据集时,您可能会遇到本部分所述的某种常见错误。

GeoJSON 错误

常见的 GeoJSON 错误包括:

  • 缺少 type 字段,或者 type 不是字符串。上传的 GeoJSON 数据文件必须在每个地图项对象和几何图形对象的定义中包含名为 type 的字符串字段。

KML 错误

常见的 KML 错误包括:

  • 数据文件不得包含上面列出的不受支持的 KML 地图项,否则数据导入操作可能会失败。

CSV 错误

常见的 CSV 错误包括:

  • 某些行缺少几何图形列的值。CSV 文件中的所有行都必须包含几何图形列的非空值。几何图形列包括:
    • latitudelongitude
    • latlong
    • xy
    • wkt
    • addresscitystatezip
    • address
    • 包含所有地址信息的单个列,例如 1600 Amphitheatre Parkway Mountain View, CA 94043
  • 如果 xy 是几何图形列,请确保相应单位分别为经度和纬度。某些公共数据集会在标头 xy 下使用不同的坐标系。如果用错单位,或许能成功导入数据集,但渲染的数据可能会在非预期的位置显示数据集点。

创建数据集

如需创建数据集,请执行以下操作:

  1. 在 Google Cloud 控制台中,前往数据集页面
  2. 点击创建数据集
  3. 输入数据集名称。此名称在所有数据集中必须是唯一的。
  4. (可选)输入数据集的说明
  5. 点击继续。系统随即会显示导入数据页面。
  6. 选择桌面设备作为用于填充数据集的数据的上传来源,即您系统中的本地文件,您也可以选择 Google Cloud Storage 存储桶
    • 如果选择的是桌面设备,点击浏览,然后通过文件选择器选择文件。
    • 如果选择的是 Google Cloud Storage 存储桶,点击浏览,然后选择包含相应数据的存储桶和文件。
  7. 选择文件格式
  8. 点击继续以检查您的设置。
  9. 点击创建。系统随即会显示数据集页面,其中显示了您的新数据集,且其状态应为正在处理

    如果数据上传成功:

    • 数据集的状态会设置为 COMPLETED
    • 数据集即会变为“有效”version,即您的应用使用的版本。

    如果上传过程中出错:

    • 新数据集版本的状态设置为 COMPLETED

查看或修改数据集

创建数据集后,您可以查看或修改数据集:

  1. 在 Google Cloud 控制台中,前往数据集页面
  2. 点击数据集的名称。系统随即会显示数据集详细信息页面。
    1. 点击详细信息标签页可查看数据集的相关信息。您还可以在此标签页上修改数据集的名称和说明。
    2. 点击预览标签页可在地图上查看您的数据集(具有 状态为 COMPLETEDREVERTED)。
    3. 点击表数据标签页以查看数据集(数据集)的所有属性 状态为 COMPLETEDREVERTED)。这些是 可用于在地图上设置数据集样式的属性。
    4. 点击下载按钮可将数据下载至本地文件。
    5. 点击删除按钮可删除数据集。
    6. 点击导入数据文件按钮,将新数据上传到数据集。

      将新数据上传到数据集会创建新版数据集。如果新数据 上传成功:

      • 新版数据集的状态设置为 COMPLETED
      • 新版本会变为“有效”版本version,即您的应用使用的版本。

      如果上传过程中出错:

      • 新数据集版本的状态设置为 COMPLETED。例如,如果某个之前的“有效”版本, 数据集的状态设置为 REVERTED
      • 之前的“有效”数据集版本仍为“有效”版本是 应用版本