统一开发 API

Appearance

事件图操作 ​

目录 ​

1. 添加事件图 ​

引入版本：3.2 起支持

功能描述 ​

在三维场景中添加事件图

调用方法 ​

JavaScript
let jsonData = {
  id: 'eventLayerId', // 图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
  name: 'layerName', // 图层名称，支持为图层自定义名称
  coordType: 0, // XY 轴坐标类别，0：X 经度，Y 纬度；1：X 米，Y米，相对世界00点
  coordTypeZ: 0, // Z 轴坐标类别，0：相对 3D 世界 0 海拔；1：相对 3D 世界地表；2：相对 3D 模型表面（单位：米）
  visible: true, // 添加当前图层时默认是显示还是隐藏
  legends: [
    // 定义图层包含图例，支持为不同图例定义各自样式
    {
      name: '摄像头', // 图层内图例名称，新建时调用者自己传入的唯一名称，用于各种操作的图例识别
      icon: 'camera', // 内置图标名称，或根据项目，在场景中预置好的图标对象的名称，包含文字样式定义，具体图标名称参考下表和下图
      iconScale: 1,
      labelScale: 1,
      color: '#ff0000', // 颜色（HEX 颜色值）
      speed: 50, // 气泡扩散速度（单位：米/秒）
      radius: 100, // 气泡最大半径（单位：米）
    },
    {
      name: '汽车', // 图层内图例名称，新建时调用者自己传入的唯一名称，用于各种操作的图例识别
      icon: 'car', // 内置图标名称，或根据项目，在场景中预置好的图标对象的名称，包含文字样式定义，具体图标名称参考下表和下图
      iconScale: 1,
      labelScale: 1,
      color: '#ff0000', // 颜色（HEX 颜色值）
      speed: 50, // 气泡扩散速度（单位：米/秒）
      radius: 100, // 气泡最大半径（单位：米）
    },
  ],
  data: [
    // 定义图层可视化数据
    {
      id: '事件01', // 图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
      coord: [113.93629142691101, 22.5222703163178], // XY 轴坐标，X：经度；Y：纬度
      coordZ: 64, // Z 轴高度（单位：米）
      message: '摄像头损坏', // 数据点事件信息
      type: '摄像头', // 数据点图例类别
    },
    {
      id: '事件02', // 图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
      coord: [113.93829142691101, 22.521270316317803], // XY 轴坐标，X：经度；Y：纬度
      coordZ: 64, // Z 轴高度（单位：米）
      message: '汽车损坏', // 数据点事件信息
      type: '汽车', // 数据点图例类别
    },
  ],
};
appInstance.uniCall('addEventLayer', jsonData, (result) => {
  console.log(result);
});

参数描述 ​

属性类型说明
idString图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
nameString图层名称，支持为图层自定义名称
coordTypeNumberXY 轴坐标类别，0：X 经度，Y 纬度；1：X 米，Y 米，相对世界 00 点
coordTypeZNumberZ 轴坐标类别，0：相对 3D 世界 0 海拔；1：相对 3D 世界地表；2：相对 3D 模型表面（单位：米）
visibleBoolean添加当前图层时默认显示还是隐藏
legendsArray定义图层包含图例，支持为不同图例定义各自样式
legends[0].nameString图层内图例名称，新建时调用者自己传入的唯一名称，用于各种操作的图例识别
legends[0].iconString内置图标名称，或根据项目，在场景中预置好的图标对象的名称，包含文字样式定义，具体图标名称参考下表和下图
legends[0].iconScaleNumber默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率
legends[0].labelScaleNumber默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率
legends[0].colorString颜色（HEX 颜色值）
legends[0].speedNumber气泡扩散速度（单位：米/秒）
legends[0].radiusNumber气泡最大半径（单位：米）
dataArray定义图层可视化数据
data[0].idString图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
data[0].coordArrayXY 轴坐标，X：经度；Y：纬度
data[0].coordZNumberZ 轴高度（单位：米）
data[0].messageString数据点事件信息
data[0].typeString数据点图例类别

回调数据 ​

JSON
{
  "result": 1,
  "message": "成功。"
}

回调数据参数描述 ​

属性类型说明
resultNumber1：代表成功；0：代表失败
messageString成功或者失败原因

具体内置图标名称（iconName）详情 ​

图标类型图标名称
市政设施camera
streetlamp
manholecover
sensor
utilitypole
transmission
broadcast
wifi
firehydrant
equipmentbox
trafficlight
charge
gasstation
wc
dustbin
地点建筑trainstation
airport
anchor
government
netpoint
metro
finance
school
hospital
factory
constructionsite
residence
mergencyshelter
park
diningroom
warehouse
store
tollgate
officebuilding
busstation
人员people
policeman
doctor
specialpeople
criminal
交通car
policecar
fireengine
ambulance
taxi
truck
bus
newscar
militarycar
municipal
electriccar
watercar
train
ship
cargoship
飞行器airplane
helicopter
uav
satellite
rocket
事件event_01
event_03
event_03
通用icon_01
icon_02
icon_03
icon_04
地名site_01
site_02
site_03

具体内置图标名称（iconName）效果 ​

图标效果

返回本章目录

2. 更新事件图数据 ​

引入版本：3.2 起支持

功能描述 ​

更新三维场景中添加事件图的数据

调用方法 ​

JavaScript
let jsonData = {
  id: 'eventLayerId', // 图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
  name: 'layerName', // 图层名称，支持为图层自定义名称
  coordType: 0, // XY 轴坐标类别，0：X 经度，Y 纬度；1：X 米，Y米，相对世界00点
  coordTypeZ: 0, // Z 轴坐标类别，0：相对 3D 世界 0 海拔；1：相对 3D 世界地表；2：相对 3D 模型表面（单位：米）
  isAppend: true, // 是否追加数据（按数据顺序），true：按新数据 更新原有重复数据 & 追加新数据；false：清除原有数据 & 重建新数据
  data: [
    // 定义图层可视化数据
    {
      id: '事件01', // 图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
      coord: [113.93629142691101, 22.5222703163178], // XY 轴坐标，X：经度；Y：纬度
      coordZ: 64, // Z 轴高度（单位：米）
      message: '摄像头损坏', // 数据点事件信息
      type: '汽车', // 数据点图例类别
    },
    {
      id: '事件02', // 图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
      coord: [113.93829142691101, 22.521270316317803], // XY 轴坐标，X：经度；Y：纬度
      coordZ: 64, // Z 轴高度（单位：米）
      message: '汽车损坏', // 数据点事件信息
      type: '摄像头', // 数据点图例类别
    },
    {
      id: '事件03', // 图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
      coord: [113.94142608825801, 22.514970821783603], // XY 轴坐标，X：经度；Y：纬度
      coordZ: 500, // Z 轴高度（单位：米）
      message: '汽车又损坏', // 数据点事件信息
      type: '汽车', // 数据点图例类别
    },
  ],
};

appInstance.uniCall('updateEventLayerCoord', jsonData, (result) => {
  console.log(result);
});

参数描述 ​

属性类型说明
idString图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
nameString图层名称，支持为图层自定义名称
coordTypeNumberXY 轴坐标类别，0：X 经度，Y 纬度；1：X 米，Y 米，相对世界 00 点
coordTypeZNumberZ 轴坐标类别，0：相对 3D 世界 0 海拔；1：相对 3D 世界地表；2：相对 3D 模型表面（单位：米）
isAppendBoolean是否追加数据（按数据顺序），true：在原有数据后方追加数据；false：清除原有数据，更新数据
dataArray定义图层可视化数据
data[0].idString图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
data[0].coordArrayXY 轴坐标，X：经度；Y：纬度
data[0].coordZNumberZ 轴高度（单位：米）
data[0].messageString数据点事件信息
data[0].typeString数据点图例类别

回调数据 ​

JSON
{
  "result": 1,
  "message": "成功。"
}

回调数据参数描述 ​

属性类型说明
resultNumber1：代表成功；0：代表失败
messageString成功或者失败原因

返回本章目录

3. 更新事件图样式 ​

引入版本：3.2 起支持

功能描述 ​

更新三维场景中添加事件图的样式

调用方法 ​

JavaScript
let jsonData = {
  id: 'eventLayerId', // 图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
  legends: [
    // 定义图层包含图例，支持为不同图例定义各自样式
    {
      name: '摄像头', // 图层内图例名称，新建时调用者自己传入的唯一名称，用于各种操作的图例识别
      icon: 'anchor', // 内置图标名称，或根据项目，在场景中预置好的图标对象的名称，包含文字样式定义，具体图标名称参考上表和上图
      color: '#00ff00', // 颜色（HEX 颜色值）
      iconScale: 1,
      labelScale: 1,
      speed: 50, // 气泡扩散速度（单位：米/秒）
      radius: 100, // 气泡最大半径（单位：米）
    },
    {
      name: '汽车', // 图层内图例名称，新建时调用者自己传入的唯一名称，用于各种操作的图例识别
      icon: 'busstation', // 内置图标名称，或根据项目，在场景中预置好的图标对象的名称，包含文字样式定义，具体图标名称参考上表和上图
      color: '#00ffff', // 颜色（HEX 颜色值）
      iconScale: 1,
      labelScale: 1,
      speed: 50, // 气泡扩散速度（单位：米/秒）
      radius: 100, // 气泡最大半径（单位：米）
    },
  ],
};

appInstance.uniCall('updateEventLayerStyle', jsonData, (result) => {
  console.log(result);
});

参数描述 ​

属性类型说明
idString图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
legendsArray定义图层包含图例，支持为不同图例定义各自样式
legends[0].nameString图层内图例名称，新建时调用者自己传入的唯一名称，用于各种操作的图例识别
legends[0].iconString内置图标名称，或根据项目，在场景中预置好的图标对象的名称，包含文字样式定义，具体图标名称参考下表和下图
legends[0].colorString颜色（HEX 颜色值）
legends[0].iconScaleNumber默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率
legends[0].labelScaleNumber默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率
legends[0].speedNumber气泡扩散速度（单位：米/秒）
legends[0].radiusNumber气泡最大半径（单位：米）

回调数据 ​

JSON
{
  "result": 1,
  "message": "成功。"
}

回调数据参数描述 ​

属性类型说明
resultNumber1：代表成功；0：代表失败
messageString成功或者失败原因

返回本章目录

4. 删除事件图 ​

引入版本：3.0 起支持

功能描述 ​

删除事件图

调用方法 ​

JavaScript
let jsonData = {
  id: 'eventLayerId', // 图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
  overlayType: 'eventLayer', // 图层对象类别
};

appInstance.uniCall('removeOverlay', jsonData, (result) => {
  console.log(result);
});

参数描述 ​

属性类型说明
idString图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
overlayTypeString图层对象类别

回调数据 ​

JSON
{
  "result": 1,
  "message": "成功。"
}

回调数据参数描述 ​

属性类型说明
resultNumber1：代表成功；0：代表失败
messageString成功或者失败原因

端渲染效果图 ​

系统架构图

返回本章目录