Appearance
地标点操作
目录
1. 添加地标点
引入版本：3.0 起支持
功能描述
在三维场景中添加地标点
调用方法
JavaScript
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 轴高度（单位：米） | 支持 | 支持 |
回调数据
JSON
{
"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 起支持
功能描述
更新三维场景中地标点数据
调用方法
JavaScript
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 轴高度（单位：米） | 支持 | 支持 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
3. 更新地标点样式
引入版本：3.0 起支持
功能描述
更新三维场景中地标点样式
调用方法
JavaScript
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 | 图标标签文本 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
4. 查询地标点屏幕位置
引入版本：3.2 起支持
功能描述
查询地标点在屏幕上位置
调用方法
JavaScript
let jsonData = { id: 'addLandmark1' };
appInstance.uniCall('getLandmarkScreenPosition', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
回调数据
JSON
{
"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 起支持
功能描述
删除地标点
调用方法
JavaScript
let jsonData = {
id: 'landmark',
overlayType: 'landmark',
};
appInstance.uniCall('removeOverlay', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| overlayType | String | 图层对象类别 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |