使用您自己的 3D 卡片渲染程序

欧洲经济区 (EEA) 开发者

如果您无法将第三方渲染产品整合到您的解决方案中，则可能需要创建自己的 3D Tiles 渲染器。此方法要求您考虑以下重要因素：

内容网址

在提供仿真 3D 图块时，Map Tiles API 会返回子图块集的 URI。这些图块集 URI 不是常规网址。它们仅包含路径和参数组件。它们不包含您的 API 密钥，而该密钥是授权请求所必需的。如需了解详情，请参阅 3D Tiles 规范。

请求和响应

以下是一些仿真 3D 图块请求和响应示例。您可以使用 Chrome 开发者工具检查这些请求。

根图块集请求示例：

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

示例图块集响应 URI：

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

渲染程序使用的示例图块请求网址：

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

在构建后续图块请求时，您应将图块集 URI 中显示的任何参数与 API 密钥一起附加。3D Tiles API 提供以下两个参数：

session
3D 加载会话的内置标识符。它由 API 自动生成。渲染程序在构建后续图块请求时必须附加该令牌。
key
您用于访问 3D Tiles 服务的 API 密钥。您必须将其附加到所有后续图块请求。

显示提供方信息

注明出处是指确认地图图块的来源，这是使用此 API 的一项要求，包括 Google 品牌出处（徽标）以及数据出处。您可以在 Map Tiles API 政策页面上找到 Google 徽标。每个图块响应中都会返回数据出处信息。在 asset、copyright 下的 glTF 图块中查找。

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

您必须在一行文本中汇总、排序和显示这些信息，通常位于渲染图的底部。这需要执行以下步骤：

  1. 从视图中的所有图块中提取所有版权信息。

  2. 多个版权来源之间请用英文分号分隔。

  3. 根据出现次数对信息进行排序。

  4. 在屏幕上显示版权来源，按出现次数从多到少排序，类似于 Google 地球的做法。