地标图操作

目录

• 1. 添加地标图
• 2. 更新地标图数据
• 3. 更新地标图样式
• 4. 删除地标图
• 5. 添加 Shp 地标图

1. 添加地标图

引入版本：3.0 起支持

功能描述

在三维场景中添加地标图

调用方法

let jsonData = {
  id: 'landmarkLayer',
  name: '地标图层',
  coordType: 0,
  coordTypeZ: 0,
  autoScale: false,
  visible: true,
  legends: [
    {
      name: '摄像头',
      color: '#73FFFF',
      iconName: 'camera',
      iconScale: 1,
      labelScale: 1，
    },
    {
      name: 'WIFI热点',
      color: '#2626FF',
      iconName: 'wifi',
      iconScale: 1,
      labelScale: 1，
    },
  ],
  data: [
    {
      id: '1',
      type: '摄像头',
      label: '摄像头1',
      coord: [113.934429644472, 22.5105568002601], //以深圳湾经纬度为例
      coordZ: 100,
    },
    {
      id: '2',
      type: '摄像头',
      label: '摄像头2',
      coord: [113.933593837038, 22.5099344521292],
      coordZ: 100,
    },
    {
      id: '3',
      type: '摄像头',
      label: '摄像头3',
      coord: [113.936979866625, 22.511939613347902],
      coordZ: 100,
    },
    {
      id: '4',
      type: '摄像头',
      label: '摄像头4',
      coord: [113.935147516865, 22.5123693181349],
      coordZ: 100,
    },
    {
      id: '5',
      type: '摄像头',
      label: '摄像头5',
      coord: [113.93276891595, 22.5104320222378],
      coordZ: 100,
    },
    {
      id: '6',
      type: 'WIFI热点',
      label: 'WIFI热点1',
      coord: [113.933326095652, 22.5115899172958],
      coordZ: 60,
    },
    {
      id: '7',
      type: 'WIFI热点',
      label: 'WIFI热点2',
      coord: [113.932480299133, 22.5104125714032],
      coordZ: 60,
    },
    {
      id: '8',
      type: 'WIFI热点',
      label: 'WIFI热点3',
      coord: [113.932705105515, 22.508776193495404],
      coordZ: 60,
    },
    {
      id: '9',
      type: 'WIFI热点',
      label: 'WIFI热点4',
      coord: [113.931762182516, 22.511235896344402],
      coordZ: 60,
    },
    {
      id: '10',
      type: 'WIFI热点',
      label: 'WIFI热点5',
      coord: [113.931365756868, 22.510176666936403],
      coordZ: 60,
    },
  ],
};

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

参数描述

属性	类型	说明
id	String	图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
name	String	图层名称，支持为图层自定义名称
coordType	Number	xy 轴坐标模式 坐标类型(0:x 经度 y 纬度；1:x 米 y 米，相对世界 00 点) 目前该属性仅支持属性值为 0
coordTypeZ	Number	Z 轴坐标类别，0：相对 3D 世界 0 海拔；1：相对 3D 世界地表；2：相对 3D 模型表面（单位：米） 目前该属性仅支持属性值为 0
autoScale	Boolean	默认 false, 如果开启 true 后，图标会按照摄像机远近自动缩放大小
visible	Boolean	添加当前图层时默认显示还是隐藏
legends	Array	定义图层包含图例，支持为不同图例定义各自样式
legends[0].name	String	图层内图例名称，新建时调用者自己传入的唯一名称，用于各种操作的图例识别
legends[0].color	String	颜色（HEX 颜色值）
legends[0].iconName	String	内置图标名称，具体图标名称参考下表和下图
legends[0].iconScale	Number	默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率
legends[0].labelScale	Number	默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率
data	Array	数据点位基本信息集合
data[0].id	String	图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
data[0].label	String	图标标签文本
data[0].coord	Array	XY 轴坐标，X：经度；Y：纬度
data[0].coordZ	Number	Z 轴高度（单位：米）
data[0].type	String	地标点的图例类别名称

回调数据

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

回调数据参数描述

属性	类型	说明
result	Number	1：代表成功；0：代表失败
message	String	成功或者失败原因

具体内置图标名称（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_02
	event_03
通用	icon_01
	icon_02
	icon_03
	icon_04
地名	site_01
	site_02
	site_03

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

返回本章目录

2. 更新地标图数据

引入版本：3.0 起支持

功能描述

更新三维场景中添加地标图的数据

调用方法

let jsonData = {
  id: 'landmarkLayer',
  name: '地标图层',
  coordType: 0,
  coordTypeZ: 0,
  isAppend: false,
  data: [
    {
      id: '11',
      type: '摄像头',
      label: '摄像头',
      coord: [113.932358252279, 22.513687693448002], //以深圳湾经纬度为例
      coordZ: 64,
    },
    {
      id: '12',
      type: '摄像头',
      label: '摄像头',
      coord: [113.934061940271, 22.513951407881102],
      coordZ: 64,
    },
    {
      id: '13',
      type: '摄像头',
      label: '摄像头',
      coord: [113.930654568696, 22.511470933294802],
      coordZ: 64,
    },
  ],
};

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

参数描述

属性	类型	说明
id	String	图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
name	String	图层名称，支持为图层自定义名称
coordType	Number	xy 轴坐标模式 坐标类型(0:x 经度 y 纬度；1:x 米 y 米，相对世界 00 点) 目前该属性仅支持属性值为 0
coordTypeZ	Number	Z 轴坐标类别，0：相对 3D 世界 0 海拔；1：相对 3D 世界地表；2：相对 3D 模型表面（单位：米） 目前该属性仅支持属性值为 0
isAppend	Boolean	是否追加数据（按顺序），true：按新数据 更新原有重复数据 & 追加新数据；false：清除原有数据 & 重建新数据
data	Array	定义图层可视化数据
data[0].id	String	图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
data[0].coord	Array	XY 轴坐标，X：经度；Y：纬度
data[0].coordZ	Number	Z 轴高度（单位：米）
data[0].type	String	地标点的图例类别名称
data[0].label	String	图标标签文本

回调数据

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

回调数据参数描述

属性	类型	说明
result	Number	1：代表成功；0：代表失败
message	String	成功或者失败原因

返回本章目录

3. 更新地标图样式

引入版本：3.0 起支持

功能描述

更新三维场景中添加地标图的样式

调用方法

let jsonData = {
  id: 'landmarkLayer',
  isAppend: true,
  legends: [
    {
      name: '摄像头',
      color: '#00ef00',
      iconName: 'firehydrant',
      iconScale: 1,
      labelScale: 1,

    },
    {
      name: 'WIFI热点',
      color: '#00ad00',
      iconName: 'streetlamp',
      iconScale: 1,
      labelScale: 1,
    },
  ],
};

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

参数描述

属性	类型	说明
id	String	图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
isAppend	Boolean	是否追加数据（按顺序），true：按新数据 更新原有重复数据 & 追加新数据；false：清除原有数据 & 重建新数据
legends	Array	图例图层定义
legends[0].name	String	图标对象名称，和数据集合中 type 属性对应，本身也可以代表内置的图标名称
legends[0].color	String	图标颜色设置
legends[0].iconName	String	内置图标名称
legends[0].iconScale	Number	默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率
legends[0].labelScale	Number	默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率

回调数据

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

回调数据参数描述

属性	类型	说明
result	Number	1：代表成功；0：代表失败
message	String	成功或者失败原因

返回本章目录

4. 删除地标图

引入版本：3.0 起支持

功能描述

删除地标图

调用方法

let jsonData = {
  id: 'landmarkLayer',
  overlayType: 'landmarkLayer',
};

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

参数描述

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

回调数据

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

回调数据参数描述

属性	类型	说明
result	Number	1：代表成功；0：代表失败
message	String	成功或者失败原因

流渲染效果图

端渲染效果图

返回本章目录

5. 添加 Shp 地标图 端

引入版本：3.6.4 起支持

功能描述

在三维场景中添加 Shp 地标图

调用方法

let jsonData = {  
  id: 'idObj',
  name: 'layerName',
  coordZ: 150,
  coordZFiled: 'heightField',
  autoScale: false,
  visible: true,
  idField: 'idField',
  labelField: 'poititleField',
  legendsField: 'legendField',
  shpEncoding: 'utf8',
  shpPath: 'http://tuguan.net/test.shp'
  legends: [
    {
        name: 'legendName1',
        color: '#ff0000'，
        iconName: 'camera',
        iconScale: 1,
        labelScale: 1
    },
    {
        name: 'legendName2',
        color: '#ff0000'，
        iconName: 'camera',
        iconScale: 1,
        labelScale: 1
    }
  ]
};

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

参数描述

属性	类型	说明
id	String	图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
name	String	图层名称，支持为图层自定义名称
coordZ	Number	高度（单位：米）
coordZFiled	String	高度在 SHP 文件中属性表的字段名称，如果有这个字段则 coordZ 不起作用（单位：米）
autoScale	Boolean	默认 false, 如果开启 true 后，图标会按照摄像机远近自动缩放大小
visible	Boolean	添加当前图层时默认显示还是隐藏
idField	String	对象唯一标识在 SHP 文件中属性表的字段名称
labelField	String	标签文字在 SHP 文件中属性表的字段名称，如果不写或为空就只显示图标
legendsField	String	对象图例字段在 SHP 文件中属性表的字段名称
shpEncoding	String	shp 文件的编码格式，可以是"utf8"或者"gb2312"
shpPath	String	在线地址：shp 文件 URL ; 本地地址一："file:///D:/xxx/shpData.shp"；D: 云渲染所在盘符 ; 本地地址二："path:/UserData/shpData.shp"，资源由云渲染后台管理
legends[0].name	String	图层内图例名称，新建时调用者自己传入的唯一名称，用于各种操作的图例识别
legends[0].color	String	颜色（HEX 颜色值）
legends[0].iconName	String	内置图标名称
legends[0].iconScale	Number	默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率
legends[0].labelScale	Number	默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率

回调数据

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

回调数据参数描述

属性	类型	说明
result	Number	1：代表成功；0：代表失败
message	String	成功或者失败原因

返回本章目录