3D 区域探索器使用入门

概览

3D 区域探索器解决方案为您提供了一种全新的地点探索和体验方式。此解决方案利用 Google Maps Platform 仿真 3D 图块和 Places API 的功能，打造引人入胜的互动式 3D 环境。

3D 区域探索器可用于多种用途：

• 增强区域探索：用户可以虚拟探索社区，获得高度视觉细节，深入了解当地特色和地标。

• 推广基于位置的叙事：能够将 POI（地图注记）与丰富的描述相结合，从而打造叙事驱动型体验，向用户介绍特定位置并提供相关信息。

• 激发使用 Google 地图 3D 功能进行开发的灵感：它展示了 Google 3D 地图数据在创建沉浸式交互式地图方面的潜力

使用入门

启用

• 仿真 3D 图块 API
• Places API

关键技术

此解决方案使用两项关键技术构建：

Google Maps Platform API

我们使用 Google Maps Platform 中的多个 API 来获取基本地图和数据，以打造这种体验：

• Google 地图仿真 3D 图块：建筑物和地形的高分辨率 3D 模型，可逼真且直观地呈现城市环境。
• Places API：应用可以识别并显示所探索区域内地图注点 (POI) 的详细信息，从而利用本地知识丰富用户体验。
• 自动补全可帮助用户搜索特定位置或感兴趣的区域。

CesiumJS

CesiumJS 负责渲染和显示高分辨率 3D 地球。它负责加载和呈现 Google 的仿真 3D 图块，这些图块提供了建筑物和地形的 3D 网格模型。

相机管理：CesiumJS 提供了用于控制相机位置、方向和移动的工具。其中包括：

• 设置初始视点，以便在加载应用时聚焦于指定街区。
• 实现动态镜头移动，例如用于探索的自动环绕动画。
• 处理用户与地球仪的互动（如果包含此类功能，例如平移、缩放、旋转）。

了解仿真 3D 图块如何与 3D 图块渲染器搭配使用。

关键组件

该应用分为两个不同的应用，即：

• 管理应用
• 演示应用

下图概述了这两个应用之间的差异和相关性：

进一步调查每个应用会很有帮助：

管理应用

此应用提供了一个人性化的界面，可让您自定义 3D 体验：

• 位置搜索：使用集成的 Google Maps Platform 自动补全搜索栏，查找您要展示的区域。选择地点后，镜头会顺畅地飞到该区域。

• 相机：调整相机移动速度和轨道类型，以打造所选的观看体验。

• 地点 (POI)：定义您要展示的地图注点（例如餐厅、咖啡馆、地标）的密度、搜索半径和类型。

使用此应用为最终用户打造个性化体验。

• 沿着缓慢的镜头路径探索 Google 的芝加哥办公室。

• 查看芝加哥地区的所有机场

• 请参阅拉斯维加斯大道周围旅游景点的密集视图。

• 现在沿着高速正弦相机路径探索拉斯维加斯

• 探索大峡谷，游览所有主要旅游景点

如需详细了解所有自定义设置，请参阅 3D 区域探索器自定义设置。

演示应用

这是最终面向用户的应用，它会加载您在管理应用中创建的配置。在这个沉浸式 3D 环境中，用户将能够探索所选区域并发现您突出显示的地点。

使用管理应用自定义外观和风格后，您可以下载配置并从源代码运行自定义应用。

用户体验

该应用的一些主要功能如下：

1. 用户可以以 3D 形式交互式探索某个区域，包括建筑物、地标和地形。
2. 用户可以搜索和发现附近的地点（例如博物馆、公园、餐馆）。

3. 选择地点后，用户可以查看与该地点相关的详细信息或说明。

4. 开发者可以通过设置和控件（如果使用管理应用）来个性化其探索体验。

5. 自动旋转功能已启用，允许摄像头围绕所选区域的中心自动旋转。

前提条件

1. Google 地图 API 密钥：您需要一个有效的 API 密钥，并启用以下 API：

   • Maps JavaScript API
   • Places API
   • Maps Tiles API

2. Web 服务器：您可以通过以下任一方式提供应用：

   • 本地 Web 服务器（例如，使用 Node.js、http-server）
   • 静态网站托管服务（应用附带 Dockerfile）

您可以在 GitHub 项目的自述文件部分中找到部署选项的详细说明。

部署

您可以在任何容器环境（例如 GKE 或 GAE）中将应用部署为节点应用或 Docker 容器。托管式演示使用以下架构：

• 在此架构中，代码位于 GitHub 项目中。
• Cloud Build 会在每次推送到 main 分支时获取代码，并触发构建操作。
• 在构建过程中，它会注入 API 密钥并创建一个映像，然后将其存储在 Artifact Registry 中。
• 最后，它会将 Artifact Registry 中的最新稳定映像部署到 Cloud Run。
• 我们还运行了一些健康检查和监控，以检查已部署应用的健康状况。

结算信息

3D 区域探索器解决方案使用 Google Maps Platform 服务提供沉浸式动态体验。某些 API 可能会产生费用。下面简要介绍了这些 API 并提供了价格链接。

Google Maps Platform - 3D Tiles API

3D 区域探索器解决方案利用 3D Tiles API，通过地理空间数据增强视觉体验。如需了解与 3D Tiles API 相关的价格详情，请参阅 Google Maps Platform - 3D Tiles API 价格。

Google Maps Platform - Places API

Places API 用于提供基于位置的数据，为 3D 区域探索工具体验添加丰富的信息。如需了解与 Google Places API 相关的费用，请访问 Google Maps Platform - Places API 价格。

Google Maps Platform - Autocomplete API

自动补全功能可增强用户互动。如需了解 Google Maps Autocomplete API 的价格详情，请访问 Google Maps Platform - 地点自动补全价格。

CesiumJS

CesiumJS 用于 3D 地球可视化。虽然 CesiumJS 本身是开源的，但其他功能或服务可能会产生相关费用。如需了解任何高级产品，请参阅 CesiumJS 文档。

请务必查看每个 API 的价格详情，因为费用是根据用量单独确定的。请注意，Google Maps Platform 提供免费层级，其中包含一定数量的免费用量，具体价格可能会因请求数量和使用区域等因素而异。

请始终参阅官方价格页面，了解有关 Google Maps Platform 和 CesiumJS 使用费用的最新准确信息。请务必遵守这些服务规定的条款及条件，以便有效管理和了解任何相关费用。

总结

本文档简要介绍了 3D 区域探索器的功能、组件、用户体验和技术要求。

该解决方案利用 Google 的仿真 3D 图块和 Places API，让用户能够以虚拟方式探索社区、发现地图注点并了解当地历史。

无论是展示某个区域、增强探索体验，还是促进数字叙事，3D 区域探索器都能提供一个视觉效果惊艳的平台。

试用演示版，并使用管理应用对其进行自定义，打造引人入胜且信息丰富的 3D 体验。