地标点操作

目录

• 1. 添加地标点
• 2. 更新地标点数据
• 3. 更新地标点样式
• 4. 查询地标点屏幕位置
• 5. 删除地标点

1. 添加地标点

引入版本：3.0 起支持

功能描述

在三维场景中添加地标点

调用方法

let jsonData = {
  id: 'landmark',
  coordType: 0,
  coordTypeZ: 0,
  iconName: 'utilitypole',
  autoScale: false,
  visible: true,
  label: '电线杆',
  iconScale: 1,
  labelScale: 1,
  tags: ['tag1', 'tag2', 'tag3'],
  coord: [113.94171988006201, 22.5162698894782], //以深圳湾经纬度为例
  coordZ: 64,
};

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

参数描述

属性	类型	说明	端渲染	流渲染
id	String	图层 ID （唯一标识）	支持	支持
coordType	Number	XY 轴坐标类别，0：X 经度，Y 纬度；1：X 米，Y 米，相对世界 00 点	支持	支持
coordTypeZ	Number	Z 轴坐标类别，0：相对 3D 世界 0 海拔；1：相对 3D 世界地表；2：相对 3D 模型表面（单位：米） 目前该属性仅支持属性值为 0	支持	支持
iconName	String	内置图标名称，或根据项目，在场景中预置好的图标对象的名称，包含文字样式定义，具体图标名称参考下表和下图	支持	支持
autoScale	Boolean	如果开启后，图标会按照摄像机远近自动缩放大小	支持	支持
visible	Boolean	添加当前图层时默认显示还是隐藏	支持	支持
label	String	图标标签文本	支持	支持
iconScale	Number	默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率	支持	支持
labelScale	Number	默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率	支持	支持
tags	Anything	用户自定标签数组，用于保存用户的扩展数据，或者可以控制显隐	不支持	支持
coord	Array	XY 轴坐标，X：经度；Y：纬度	支持	支持
coordZ	Number	Z 轴高度（单位：米）	支持	支持

回调数据

{
  "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: 'landmark',
  coordType: 0,
  coordTypeZ: 0,
  tags: ['tag1', 'tag2', 'tag3'], // 用户自定标签数组，用于保存用户的扩展数据，或者可以控制显隐
  coord: [113.934336750075, 22.510934971088503], //以深圳湾经纬度为例
  coordZ: 100,
};

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

参数描述

属性	类型	说明	端渲染	流渲染
id	String	图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别	支持	支持
coordType	Number	XY 轴坐标类别，0：X 经度，Y 纬度；1：X 米，Y 米，相对世界 00 点	支持	支持
coordTypeZ	Number	Z 轴坐标类别，0：相对 3D 世界 0 海拔；1：相对 3D 世界地表；2：相对 3D 模型表面（单位：米） 目前该属性仅支持属性值为 0	支持	支持
tags	Anything	用户自定标签数组，用于保存用户的扩展数据，或者可以控制显隐	不支持	支持
coord	Array	XY 轴坐标，X：经度；Y：纬度	支持	支持
coordZ	Number	Z 轴高度（单位：米）	支持	支持

回调数据

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

回调数据参数描述

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

返回本章目录

3. 更新地标点样式

引入版本：3.0 起支持

功能描述

更新三维场景中地标点样式

调用方法

let jsonData = {
  id: 'landmark',
  iconName: 'firehydrant',
  iconScale: 1,
  labelScale: 1,
  label: '消防栓',
};

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

参数描述

属性	类型	说明
id	String	图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
iconName	String	内置图标名称，或根据项目，在场景中预置好的图标对象的名称，包含文字样式定义，具体图标名称参考上表和上图
iconScale	Number	默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率
labelScale	Number	默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率
label	String	图标标签文本

回调数据

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

回调数据参数描述

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

返回本章目录

4. 查询地标点屏幕位置

引入版本：3.2 起支持

功能描述

查询地标点在屏幕上位置

调用方法

let jsonData = { id: 'addLandmark1' };

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

参数描述

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

查询地标点 基于控件矩形区域的 左上角，右上角的位置
基于 3D 世界渲染窗口左上角比值
基于 3D 世界渲染窗口右下角比值

回调数据

{
  "result": 1,
  "message": "成功。",
  "id": "addLandmark1",
  "ndc": [0.6691358024691358, 0.5272952853598015],
  "screenPosition": [271, 425]
}

回调数据参数描述

属性	类型	说明
result	Number	1：代表成功；0：代表失败
message	String	成功或者失败原因
id	String	图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
ndc	Array	Native Device Coordinate：左上角为 -1, -1，右下角为 1, 1
screenPosition	Array	屏幕像素坐标，左上角为 0, 0

返回本章目录

5. 删除地标点

引入版本：3.0 起支持

功能描述

删除地标点

调用方法

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

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

参数描述

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

回调数据

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

回调数据参数描述

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

流渲染效果图

端渲染效果图

返回本章目录