Beginner Tutorial

Visualize a Proposed Building

入门基础45 分钟

这个主题把“城市背景 + 设计方案”放到一起,非常接近真实项目。你要学会隐藏现状建筑,再把新方案放进真实城市空间中。

Overview

为什么这篇很重要

它把 CesiumJS 从“看地图”推进到“看方案”。你不只是加载建筑,而是要在城市级上下文里做替换、比对和讲解,这正是建筑、规划、地产、园区项目里常见的表达方式。

Core Tasks

关键任务

  1. 加载城市级背景数据,先确保环境真实可信。
  2. 准确找到目标建筑物或目标地块。
  3. 过滤或隐藏原有建筑,让方案位置空出来。
  4. 导入自定义 3D 模型,并调整位置、朝向和比例。
  5. 设计几个关键视角,让汇报和演示更有说服力。

Starter Code

方案模型插入骨架

viewer.entities.add({
  position: Cartesian3.fromDegrees(lon, lat, height),
  model: {
    uri: "./proposal.glb",
    scale: 1.0,
  },
});

Project Advice

做展示页时要抓住什么

先校准模型 比任何 UI 都更重要的是位置、比例和朝向准确。
准备对比视角 一定要有几个固定视角,用于展示现状与方案差异。
减少无关干扰 原建筑、周边遮挡和过重底图都可能削弱方案表达。

What You Gain

学完后能做什么

  • 在真实城市环境里展示拟建建筑。
  • 做现状与方案的空间对比。
  • 把 3D 设计结果放到面向业务的 Web 应用里。

Pitfalls

常见风险

  • 模型坐标和朝向如果不准,效果会立刻失真。
  • 建筑过滤逻辑不准确,会让原建筑和新模型重叠。
  • 相机视角设计太少,会浪费这个场景的展示价值。

Good For

适合用在

  • 建筑方案展示。
  • 规划设计比选。
  • 地产和园区演示。

Debug

排错顺序

  • 先查模型位置。
  • 再查模型朝向与比例。
  • 最后查原建筑过滤和视角设计。