标记点概述

1.标记点简介

在智慧园区或智慧城市项目中，标记点是非常常用的一个功能，也是最常用的和数据进行交互的功能。
标记点分为自由标记点和数据标记点。两种标记方式是根据添加的方式来区分的，通过手动添加，可以移动位置的称为自由标记点；通过数据添加，例如经纬度，XYZ 坐标，称为数据标记点。

2.标记点的样式设置

2.1.添加标记点

2.1.1.添加自由标记点

在项目后，双击场景或者鲸孪生图层右击可以进入编辑模式，这个状态下鲸孪生之外的其他组件都会自动隐藏掉，左侧的面板会切换成鲸孪生相关功能。

在鲸孪生组件编辑界面左侧菜单栏中点击标绘，展开后在“标记”中可以看到软件为我们添加了许多预设自由标记点样式。
我们选择其中一个标记点样式添加在场景中的楼层上：

可以看到添加到模型中的标记点在左侧组件图层中自动形成了一个标记组，当我们在鲸孪生场景中添加标记点时，实际上是添加一个标记组。标记组即一组标记点的结合，可以通用地设置这组标记的交互，比如弹窗、高亮等。

当选中标记组时在场景编辑界面左上角可以看到一个符号，点击这个符号可以在场景中继续添加该标记组中的标记点样式。

2.1.2.数据标记点（空间坐标系）

很多时候，我们需要数据联动，数据筛选时。光用自由标记点是不够的，我们需要将自由标记点转换为数据标记点。这个时候，我们可以先选中所有的自由标记点，右击选择复制数据：

然后新建一个 Excel，并按下 Ctrl+V：

保存这个 Excel 为示例数据，然后在山海鲸中点击左上角数据中的添加数据，为项目添加一个数据来源



这样数据就成功导入了。
我们复制出来的数据都是空间直角坐标系的，因此需要在右上角选择数据栏，将坐标类型改成空间坐标。并将数据中名字与位置字段依标签填入。特别需要注意的是，标记 Key 也是要有输入的，标记 Key 是在数据发生变化时来比对每一个数据标记点本身是否变化，因此一定要用不会重复的字段来设置到标记 Key 上。这里如果名字是不重复的，则推荐用名字来作为标记 Key，否则建议单独给标记一个 ID 来作为标记 Key。

设置完之后，再删除原有的自由标记点，这样数据标记点就添加完毕了，同时自有标记点也被转换成了数据标记点，我们可以在这个基础上进一步设置数据联动和数据筛选：

注意位置也可以直接从导入的元素模型上进行复制，具体操作和标记点的位置复制一样。
这里需要说明的是，这个 Excel 文件我们也可以替换成 API 或者数据库，这样标记点的名称，位置和数量都会自动根据数据来动态生成。

2.1.3.数据标记点（经纬度坐标系）

经纬度数据一般都是有 GPS 设备（或者北斗设备）采集而来，我们一般来说需要将数据整理成如下格式：

位置是有经度，维度，海拔三个值以逗号分隔。特别注意，这个逗号一定要是英文的逗号。
将这个数据引入后，选择标记点组，将数据字段一一拖入对应的数据项上，即可看到标记点已经自动生成。如下图：

如果出现位置明显偏差的情况，请根据标记点的坐标，选择一个合适的原点坐标：

2.2.标记样式设置

设置标记样式的时候，是在标记组上统一设置的，交互也是在标记组上统一设置的。标记组下所有的标记共享标记组的样式和交互。

下面对这些配置项进行说明：

2.2.1.基础设置

2.2.2.标记主体

标记主体即标记点组成部分，在标记主体中可以对标记点样式进行设置。
每个标记点预设样式都默认设置了不同的状态，分为三种“默认状态、选中状态、悬浮状态”，若需要修改预设标记点样式需要在对应状态下进行修改。

我们可以看到，标记主体不同配置项中由于使用不同材质，设置项会有所不同，主体材质整体分为两类：一是二维材质，如视频、图片；二是三维材质，主要指模型。
标记主体配置项会根据添加的材质不同区分不同设置项。

同时标记主体配置项根据标记点样式不同配置项数量也会不同，标记点样式越复杂，标记主体配置越多。
例如基础标记组只由一个标记点模型构成，配置中只有一个配置 1。

标记 4预设样式由标记点模型、标记点底座、文本框三部分构成，配置项中就会有 3 个配置。

下面我们根据标记点不同材质区别介绍一下这些配置项：

二维材质

三维材质

2.2.3.标记文本

即标记点文本样式，在此处设置文本样式会应用与整个标记组中标记点内。

2.2.4.标记面板

标记面板主要用于标记点设置交互弹窗，当我们需要点击标记点显示某一弹窗时可在此处进行设置。