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

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

内容网址

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

请求和响应

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

根 tileset 请求示例:

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 图块服务的 API 密钥。您必须将其附加到所有后续功能块请求中。

显示提供方说明

提供方说明需要确认地图图块的来源,这是使用此 API 的一项要求,其中包括 Google 品牌提供方说明(徽标)以及数据提供方说明。您可以在 Map Tiles API 政策页面上找到 Google 徽标。每个功能块响应中都会返回数据归因信息。请在响应正文的 asset.copyright 下的 JSON 中查找该密钥。

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

您必须在一行文本(通常位于渲染的底部)上对这些信息进行聚合、排序和显示。此过程包括以下步骤:

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

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

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

  4. 在屏幕上按出现次数从多到少的顺序显示版权来源,与 Google 地球显示方式类似。