开发者必看！图观™统一开发API及API调试器入门第七讲-CSDN博客

本文链接：https://blog.csdn.net/tuguan_digitail/article/details/126544882

课程7：模型图层操作

哈喽，小伙伴们大家好，欢迎大家来到图观统一开发API及 API调试器入门课程的第7课。上节内容，我们为大家详细介绍了模型的操作、如何获取建筑、如何拆解楼层、3DMarker的操作等内容。

本节课程，我们主要讲解“模型地标图、模型轨迹图“的相关操作，主要包含“添加模型地标图、更新模型地标图、添加模型轨迹图、更新模型轨迹图数据”等内容，并会在统一API调试器中进行相关的演示操作。

本节课程安排

第一部分：【模型地标图操作】

第二部分：【模型轨迹图操作】

图观™引擎统一API调试器零基础入门课程7《模型图层操作》#统一API调试器教程

本节课程详解

一、模型地图操作

模型地标图就是在摄像机视野距离不同的情况下，可以展示成模型或者是地标图的样式。使用图例属性可以设置多个模型类型，并且支持批量操作。

接下来我们先看一下API调试器中预置的模型地标图代码范例。

首先是添加模型地标图，并聚焦到该图层，然后每隔5秒更新模型地标图数据。场景中添加了一个“小汽车”的地标点，视角拉近，地标点变成了模型，并在5秒后更新了模型的位置数据；将视角拉远，模型又变回了地标点，这就是模型地标图根据视野距离切换地标点或模型的效果。

我们使用addModelLandmarkLayer方法来添加地标图，在上方的参数中，与id相关的这里我们就不做过多介绍了，modelMaxDistance 是模型最大显示距离，超过这个距离将不再显示模型，而显示图标。iconMaxDistance 是图标最大显示距离，超过这个距离将不再显示图标。legends用于定义模型类型、图标名称等样式属性，通过legends和data方法可以定义多个模型地标图层。data是实际添加图层数据属性，可以通过数组传入模型地标图每个对象的显示文字、图例类别、中心点位置、旋转角度。

我们使用addModelLandmarkLayer方法给演示一下模型地标图添加，先清除后面的代码，点击执行。可以看到，场景中添加了一个模型地标图，并且可以根据我们刚刚设定的最大视野距离动态切换显示模型或图标。

更新模型地标图使用的是：updateModelLandmarkLayerCoord方法。

上方的参数中，我们可以重新定义地标图的数据，如id、XYZ轴坐标、旋转角度等，这里我们将label改为“大汽车1”，并对coord进行修改，同时设定添加地标图后5秒执行数据更新。点击执行，可以看到场景中先添加一个地标图，5秒后，地标图显示文字和位置数据都发生了变化。

以上就是添加模型地标图和更新模型地标图的方法。

二、模型轨迹图操作

模型轨迹图和轨迹图的区别在于，模型轨迹图能够根据距离的远近，来显示成一个模型或者是一个地标点，并且比模型地标图多了平滑移动、尾迹显示、按时长消批的功能。使用addModelTailLayer方法可以添加模型轨迹图，使用uppdateModelTrailLayerCoord这个方法可以更新模型轨迹图。

我们来看一下添加模型轨迹图的数据参数:

snapSurface是指是否启用自动贴地，“0”为不贴地，“1”为贴地。

duration：当前点到下一点的过渡动画时长，如果您每1秒更新模型轨迹图的位置，这个时间设置成1.1会比较平滑一些。

modelMaxDistance：模型可见的最大距离。

iconMaxDistance：图标的最大可见距离，这两个属性的含义和模型地标图一样。trackStyle：轨迹的效果。

objLife：轨迹的消批时间，消批的意思是，如果再这个时间长度内，没有更新过这一个图层子对象，那么这个图层子对象将会自动删除并消失。

trackWidth：轨迹的宽度。

legends：来定义模型轨迹图的样式，包括modelType模型的类型、iconName图标的类型。

Data：模型轨迹图的数据，在这里我们定义了三个点位，id分别是“1”、“2”、“3”，用type去指定样式、label是文字、coord是坐标、coordZ是高度、rotation是XYZ三个轴的旋转值。

clearOverlayType：清除模型轨迹图。

当用addModelTrailLayer方法，就可以添加模型轨迹图，可以看到addModelTrailLayer方法中有一个uppdateLayer方法，是更新模型轨迹图，更新轨迹图同样是定义新的点位数据，最后通过计时器来实现一定间隔时间后更新图层。

接下来调整摄像机的视角，可以看到，当距离拉远时，汽车模型变成了图标，再次点击执行，在当前视角下可以看到移动的图标，当视野拉近，图标又变回模型，