想象一下，地球在你眼前旋转，上面还有各种3D模型，是不是很酷？Cesium是一个超酷的库，专门用来创建超炫的3D地球和地图。好，言归正传，今天这篇文章就分享一下前端如何使用Cesium加载三维模型。

一：准备工作

首先，确保你已经安装了Cesium库。可以从Cesium官网下载最新版本的库文件，或者使用npm进行安装：

npm install cesium或者yarn add cesium

然后，找一个舒服的地方坐下，准备好开始你的3D之旅

二：加载模型

要加载一个3D模型，你需要知道模型在哪里，然后告诉Cesium去哪里找它。就像你告诉外卖小哥你的地址一样。然后，你就可以把这个模型加到你的地球上了！

// 创建你的Cesium Viewer let viewer = new Cesium.Viewer('cesiumContainer'); // 定义模型的坐标和大小 let modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame( Cesium.Cartesian3.fromDegrees(-75.628982, 40.028194), new Cesium.HeadingPitchRoll() ); // 定义模型的路径和其他选项 let modelOptions = { uri: 'path/to/your/model.gltf', scale: 1.0, minimumPixelSize: 128, maximumScale: 20000, modelMatrix: modelMatrix }; // 把模型加到场景里！ viewer.scene.primitives.add(new Cesium.Model(modelOptions));

我们首先创建了一个Cesium Viewer实例，然后定义了模型的路径和选项。其中，modelMatrix参数用于定义模型的变换矩阵，包括位置、方向、俯仰和偏航角度等。然后，我们使用new Cesium.Model()构造函数创建一个模型实例，并将模型添加到场景中。

当然别忘了把’path/to/your/model.gltf’替换成你自己的GLTF模型文件路径哦！如果你有Blender或者其他的3D建模软件，你可以导出为GLTF格式，然后放到你的项目里。建议用blender免费而且还比较好用。

三：交互和动画

当然，加载模型只是第一步。你还可以和模型互动哦！比如你可以给模型添加碰撞检测，这样你就可以知道哪些地方可以“撞”到模型。就像玩虚拟现实游戏一样！

首先，你需要定义一个碰撞器的形状和大小。然后，你可以把这个碰撞器加到场景里，和你的模型一起显示出来。就像给你的模型穿上盔甲一样！

// 定义碰撞器的位置和尺寸 var boxGeometry = new Cesium.BoxGeometry({ length: 100000, // 长度（单位：米） width: 100000, // 宽度（单位：米） height: 100000 // 高度（单位：米） }); var boxMaterial = new Cesium.Material({ fabric: { type: 'Grid', // 使用网格材质类型 unlit: true // 不进行光照计算，仅显示碰撞器轮廓线 } }); var boxPrimitive = new Cesium.Primitive({ // 创建碰撞器实体对象 geometryInstances: new Cesium.GeometryInstance({ // 定义碰撞器几何体实例 geometry: boxGeometry, // 使用BoxGeometry作为几何体类型 modelMatrix: modelMatrix, // 设置模型变换矩阵，使其与模型对齐 id: 'box' // 设置碰撞器标识符，方便后续查找和识别碰撞事件 }), asynchronous: false, // 是否异步加载碰撞器几何体数据，这里选择同步加载以提高性能和效率 material: boxMaterial // 设置碰撞器材质属性，这里使用网格材质类型显示轮廓线效果 }); viewer.scene.primitives.add(boxPrimitive); // 将碰撞器添加到场景中显示出来。

四：其他api实例

就写几个我用到的吧。

1.地理信息查询

当你想要查找某个地点的具体信息时，可以使用Cesium的地理信息查询功能。例如，你可以通过经纬度坐标或地名来查询相关的地理信息

viewer.geocoder.geocode({ text: '北京', view: Cesium.ScreenSpaceEventType.LEFT_CLICK }).then(function(results) { // 查询成功，获取查询结果 var entity = results[0].entity; console.log(entity); // 输出查询到的实体信息 });

2.轨迹绘制

如果你想要在地图上绘制轨迹，可以使用Cesium提供的轨迹绘制工具。通过定义一系列的经纬度坐标，你可以轻松地绘制出轨迹。

// 定义轨迹的坐标点数组 var waypoints = [ Cesium.Cartesian3.fromDegrees(116.407, 39.904), // 北京 Cesium.Cartesian3.fromDegrees(121.473, 31.230), // 上海 Cesium.Cartesian3.fromDegrees(104.065, 30.574) // 成都 ]; // 创建轨迹实体 var polyline = viewer.entities.add({ polyline: { positions: waypoints, width: 5, material: Cesium.Color.RED, leadTime: 0, trailTime: 0 } });

定义一个包含经纬度坐标的数组waypoints，表示轨迹上的点。然后，我们使用viewer.entities.add()方法创建了一个红色的轨迹实体，并将其添加到地图上。通过调整width参数可以改变轨迹的宽度，而leadTime和trailTime参数则分别控制轨迹的前导和尾迹时间

3.地理编码

如果你有一系列的地名或地址，并想要获取其对应的经纬度坐标，可以使用Cesium的地理编码功能。通过地理编码，你可以将地址转换为准确的坐标位置

var viewer = new Cesium.Viewer('cesiumContainer'); var encodedAddress = '北京市朝阳区'; // 需要地理编码的地址或地名 var request = { address : encodedAddress, // 地址或地名字符串 resource : 'address' // 地理编码资源类型，这里使用地址编码资源类型（address）进行示范。如果使用地名编码资源类型（geocode），需要传递地名相关的参数。例如：{ name : '北京' }。此外，还可以选择其他资源类型（例如：postalCode、intersection等）。具体可参考Cesium官方文档。 }; viewer.geocoder.geocode(request).then(function(results) { // 地理编码成功，获取地理编码结果（包含经纬度坐标等） var position = results[0].position; // 获取第一个结果的经纬度坐标位置信息，返回一个Cesium.Cartesian3对象。如果有多于一个结果，可以根据实际需求进行筛选或处理。例如：results[0].entity 等。可以参考Cesium官方文档了解更多关于地理编码结果的信息。使用经纬度坐标信息进行后续操作，例如：绘制标记点、添加轨迹等。 });