3D 区域探索器使用入门

图片

概览

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

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

  • 增强区域探索：用户可以对具有高度视觉细节的社区进行虚拟探索，从而深入了解当地地图项和地标。

  • 宣传基于位置的叙述：通过将地图注点（地图注点）与丰富的说明相结合，可以打造叙事型体验，从而向用户介绍具体位置，并让用户了解这些位置。

  • 利用 Google 地图的 3D 功能激发开发灵感：该示例展示了 Google 的 3D 地图数据在制作沉浸式、交互式地图方面的潜力

开始使用：

启用

关键技术

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

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)：定义您想要展示的密度、搜索半径和地图注点类型（例如餐馆、咖啡馆、地标）。

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

如需查看所有自定义设置的详细说明，请参阅 3D 区域浏览器自定义设置。

演示版应用

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

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

用户体验

图片

该应用的一些主要功能包括：

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

  3. 选择某个地点后，用户可以查看与该位置相关的详细信息或言论。

  4. 开发者可以通过相关设置和控件（如果使用“管理”应用）打造个性化的探索体验。

  5. 自动旋转已启用，允许相机自动绕所选区域的中心旋转。

前提条件

  1. Google Maps API 密钥：您需要有效的 API 密钥并启用以下 API：

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

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

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

部署

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

图片

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

结算信息

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

Google Maps Platform - 3D Tiles API：

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

Google Maps Platform - Places API：

Places API 用于基于位置的数据，为故事讲述体验增添了丰富的信息。如需了解与 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 区域探索器都能提供一个具有惊艳视觉效果的平台。

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