如果您无法将第三方渲染产品纳入您的解决方案,则可能需要创建自己的 3D 图块渲染程序。采用这种方法时,您需要考虑以下重要因素:
内容网址
在传送仿真 3D 图块时,Map Tiles API 会返回子图块集的 URI。这些图块集 URI 不是常规网址,它们仅包含路径和参数组成部分。它们不包含您的 API 密钥,而 API 密钥是授权请求的必需条件。如需了解详情,请参阅 3D 功能块规范。
请求和响应
下面是一些写实 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 图块 API 提供以下两个参数:
session
- 3D 加载会话的内置标识符。该 ID 由 API 自动生成。在构建后续功能块请求时,必须由渲染程序附加此标记。
key
- 您用于访问 3D 图块服务的 API 密钥。您必须将其附加到所有后续功能块请求。
显示提供方说明
提供归属信息是使用此 API 的必要条件,这包括提供 Google 品牌归属信息(徽标)以及数据归属信息。您可以在 Map Tiles API 政策页面上找到 Google 徽标。每个功能块响应中都会返回数据归因信息。在 glTF 功能块的 asset
下方 copyright
处查找它。
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
您必须汇总、排序并在一条文本中显示这些信息,通常位于渲染内容的底部。这涉及以下步骤:
从视图中的所有功能块中提取所有版权信息。
如有多个版权来源,请使用英文分号进行分隔。
根据出现次数对信息进行排序。
在屏幕上显示版权来源,按出现次数从高到低排序,类似于 Google 地球 的做法。