← 返回文档中心

地图插件

地图插件在交互式 OpenStreetMap 地图上显示静止和移动对象的状态和参数。该插件提供了对地理分布的可视化控制...

模块适用版本：V6.4更新时间：2026-04-28负责人：ScadaDoc

地图插件

概述

地图插件在交互式 OpenStreetMap 地图上显示静止和移动对象的状态和参数。该插件提供对地理分布式系统和传输的可视化控制。通过单击，用户将进入包含感兴趣对象的详细信息的页面。使用以下命令下载插件关联。地图插件外观如下图所示。

Map Plugin

安装

地图插件按照指示。在安装过程中，完成以下附加步骤：复制PlgMap.xml文件从插件分发到您的项目。该文件应显示在项目资源管理器中的网站 > 配置文件节点。

配置

插件设置

影响所有地图显示的常规插件设置位于PlgMap.xml文件。

这GeneralOptions部分包含常规插件选项：
PopupOnClick- 是否显示用户点击点的坐标。

这TileLayers部分包含图块图层设置。根据瓷砖供应商的不同，每个TileLayer有自己的一组选项。用户可以在地图上切换图块层。

这MarkerIcons部分定义地图上可用的标记图标。有两种类型的标记图标：

  1. 的图标Classic类型图标基于图像文件。文件名有一个与对象状态对应的后缀：undefined,normal,error， 和unbound（状态未绑定到通道）。图标文件位于SCADA\ScadaWeb\wwwroot\plugins\Map\images目录。
  2. 的图标Awesome类型使用流行的图形字体字体真棒。

创建地图

每个地图都保存在单独的 XML 文件中，其中包含map扩大。地图示例，MapExample.map，包含在插件安装包中。地图文件应位于views 目录或其子目录中。

因此，要创建新地图，请在管理员应用程序中创建一个新的 XML 文件，其中包含map扩展在视图项目部分，然后在中指定创建的文件的路径视图桌子。

New file
Map file
Views table

地图文件结构

使用以下方式考虑地图文件的结构MapExample.map举个例子。所有地图 XML 元素都包含在根中MapView元素。

这InitialView元素包含地图的初始坐标和比例。比例是 0 到 18 之间的整数。

<InitialView>
  <Lat>48.8430</Lat>
  <Lon>2.3275</Lon>
  <Zoom>13</Zoom>
</InitialView>

接下来是LayerGroup元素，每个元素包含一组地图对象。用户可以通过 Web 界面显示和隐藏组。

这Optionsa 内的元素LayerGroup指定组的选项。

<Options>
  <Name>Main</Name>
  <DefaultIcon>Site</DefaultIcon>
  <Visible>true</Visible>
  <ShowTooltips>true</ShowTooltips>
</Options>

Name- 团体名称；
DefaultIcon- 默认标记图标；
Visible- 组对象的可见性；
ShowTooltips- 是否显示对象的工具提示。

让我们看一个静止物体的例子，Location元素：

<Location>
  <Name>Eiffel Tower</Name>
  <Descr>Avenue Anatole France, Paris, France</Descr>
  <Icon></Icon>
  <Lat>48.858222</Lat>
  <Lon>2.2945</Lon>
  <StatusCnlNum>0</StatusCnlNum>
  <DataItems>
    <DataItem cnlNum="101" />
    <DataItem cnlNum="104">My text</DataItem>
  </DataItems>
  <Links>
    <Link viewID="2" />
    <Link viewID="2">My link</Link>
  </Links>
</Location>

Name- 对象名称；
Descr- 对象描述；
Icon- 标记图标。如果不指定，则使用默认图标；
Lat和Lon- 物体的纬度和经度；
StatusCnlNum- 显示对象状态的输入通道号。如果未指定通道，则等于 0。有效通道数据：通道状态等于0表示对象状态未定义，通道值等于0表示对象正常，通道值等于1表示对象处于错误状态；
DataItems- 其值显示在对象信息弹出窗口中的通道；
Links- 可以从信息弹出窗口访问的视图链接。

让我们考虑一个移动对象的例子，Vehicle元素：

<Vehicle>
  <Name>Taxi</Name>
  <Descr>Uber</Descr>
  <Icon>Car</Icon>
  <LatCnlNum>201</LatCnlNum>
  <LonCnlNum>202</LonCnlNum>
  <BearingCnlNum>203</BearingCnlNum>
  <StatusCnlNum>204</StatusCnlNum>
  <DataItems />
  <Links />
</Vehicle>

这Name,Descr,Icon,StatusCnlNum,DataItems和Links参数类似于静止物体。
LatCnlNum和LonCnlNum- 确定对象的纬度和经度的通道号；
BearingCnlNum- 决定对象旋转的通道号。旋转以度为单位测量。通道值 0 对应于中性对象旋转。正值表示顺时针旋转，负值表示逆时针旋转。

这Circle,Polygon,Polyline和Rectangle元素用于向地图添加相应的几何形状。