统一开发 API

Appearance

路径点热力图操作 ​

目录 ​

1. 添加路径点热力图 端 ​

引入版本：3.2 起支持

功能描述 ​

在三维场景中添加路径点热力图

调用方法 ​

JavaScript
let jsonData = {
  id: 'roadPtHeatLayerId', // 图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
  name: 'layerName', // 图层名称，支持为图层自定义名称
  coordType: 0, // XY 轴坐标类别，0：X 经度，Y 纬度；1：X 米，Y米，相对世界00点
  coordTypeZ: 0, // Z 轴坐标类别，0：相对 3D 世界 0 海拔；1：相对 3D 世界地表；2：相对 3D 模型表面（单位：米）
  alpha: 1, // 透明度，0：完全透明；1：完全不透明
  width: 30, // 路径宽度（单位：米）
  colorMax: '#FF0000', // 最大值上限颜色（HEX 颜色值）
  colorMin: '#0000FF', // 最小值下限颜色（HEX 颜色值）
  valueMax: 1000, // 最大值上限
  valueMin: 0, // 最小值下限
  visible: true, //添加当前图层时默认是显示还是隐藏
  data: [
    // 定义图层可视化数据
    {
      coord: [113.94833671656151, 22.52696741299701], // XY 轴坐标，X：经度；Y：纬度
      coordZ: 64, // Z 轴高度（单位：米）
      value: Math.floor(Math.random() * 1000), // 数据点权值
    },
    {
      coord: [113.93433671656152, 22.52696741299701],
      coordZ: 64,
      value: Math.floor(Math.random() * 1000),
    },
    {
      coord: [113.93433671656152, 22.52696741299701],
      coordZ: 64,
      value: Math.floor(Math.random() * 1000),
    },
    {
      coord: [113.93433671656152, 22.51296741299701],
      coordZ: 64,
      value: Math.floor(Math.random() * 1000),
    },
    {
      coord: [113.93433671656152, 22.51296741299701],
      coordZ: 64,
      value: Math.floor(Math.random() * 1000),
    },
    {
      coord: [113.94833671656151, 22.51296741299701],
      coordZ: 64,
      value: Math.floor(Math.random() * 1000),
    },
    {
      coord: [113.94833671656151, 22.51296741299701],
      coordZ: 64,
      value: Math.floor(Math.random() * 1000),
    },
    {
      coord: [113.94833671656151, 22.52696741299701],
      coordZ: 64,
      value: Math.floor(Math.random() * 1000),
    },
  ],
};

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

参数描述 ​

属性类型说明
idString图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
nameString图层名称，支持为图层自定义名称
coordTypeNumberXY 轴坐标类别，0：X 经度，Y 纬度；1：X 米，Y 米，相对世界 00 点
coordTypeZNumberZ 轴坐标类别，0：相对 3D 世界 0 海拔；1：相对 3D 世界地表；2：相对 3D 模型表面（单位：米）
snapSurfaceNumber启用自动贴地。0：不贴地；1：贴地
alphaNumber透明度，0：完全透明；1：完全不透明
widthNumber路径宽度（单位：米）
colorMaxString最大值上限颜色（HEX 颜色值）
colorMinString最小值下限颜色（HEX 颜色值）
valueMaxNumber最大值上限
valueMinNumber最小值下限
visibleBoolean添加当前图层时默认显示还是隐藏
dataArray定义图层可视化数据
data[0].coordArrayXY 轴坐标，X：经度；Y：纬度
data[0].coordZNumberZ 轴高度（单位：米）
data[0].valueNumber数据点权值

回调数据 ​

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

回调数据参数描述 ​

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

返回本章目录

2. 更新路径点热力图数据 端 ​

引入版本：3.2 起支持

功能描述 ​

更新三维场景中添加路径点热力图的数据

调用方法 ​

JavaScript
let jsonData = {
  id: 'roadPtHeatLayerId', // 图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
  name: 'layerName', // 图层名称，支持为图层自定义名称
  coordType: 0, // XY 轴坐标类别，0：X 经度，Y 纬度；1：X 米，Y米，相对世界00点
  coordTypeZ: 0, // Z 轴坐标类别，0：相对 3D 世界 0 海拔；1：相对 3D 世界地表；2：相对 3D 模型表面（单位：米）
  isAppend: false, // 是否追加数据（按数据顺序），true：在原有数据后方追加数据；false：清除原有数据，更新数据
  data: [
    // 定义图层可视化数据
    {
      coord: [113.93967447227938, 22.52532337801553], // XY 轴坐标，X：经度；Y：纬度
      coordZ: 64, // Z 轴高度（单位：米）
      value: Math.floor(Math.random() * 1000), // 数据点权值
    },
    {
      coord: [113.9327107675685, 22.51151051774577],
      coordZ: 64,
      value: Math.floor(Math.random() * 1000),
    },
    {
      coord: [113.94671076706415, 22.511521090984978],
      coordZ: 64,
      value: Math.floor(Math.random() * 1000),
    },
    {
      coord: [113.93967447227938, 22.52532337801553],
      coordZ: 64,
      value: Math.floor(Math.random() * 1000),
    },
  ],
};

appInstance.uniCall('updateRoadPtHeatLayerCoord', 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：清除原有数据，更新数据
xdataArray
data[0].coordArrayXY 轴坐标，X：经度；Y：纬度
data[0].coordZNumberZ 轴高度（单位：米）
data[0].valueNumber数据点权值

回调数据 ​

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

回调数据参数描述 ​

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

返回本章目录

3. 更新路径点热力图样式 端 ​

引入版本：3.2 起支持

功能描述 ​

更新三维场景中添加路径点热力图的样式

调用方法 ​

JavaScript
let jsonData = {
  id: 'roadPtHeatLayerId', // 图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
  alpha: 0.5, // 透明度，0：完全透明；1：完全不透明
  width: 50, // 路径宽度（单位：米）
  colorMax: '#ff00ff', // 最大值上限颜色（HEX 颜色值）
  colorMin: '#00ffff', // 最小值下限颜色（HEX 颜色值）
  valueMax: 500, // 最大值上限
  valueMin: 100, // 最小值下限
};

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

参数描述 ​

属性类型说明
idString图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
alphaNumber批号消批时间长度
widthNumber路径宽度（单位：米）
colorMaxString最大值上限颜色（HEX 颜色值）
colorMinString最小值下限颜色（HEX 颜色值）
valueMaxNumber最大值上限
valueMinNumber最小值下限

回调数据 ​

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

回调数据参数描述 ​

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

返回本章目录

4. 删除路径点热力图 端 ​

引入版本：3.0 起支持

功能描述 ​

删除路径点热力图

调用方法 ​

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

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

参数描述 ​

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

回调数据 ​

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

回调数据参数描述 ​

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

端渲染效果图 ​

系统架构图

返回本章目录