Appearance
模型型号操作
目录
- 1. 连接资产服务器
- 2. 断开资产服务器链接
- 3. 添加模型型号
- 4. 更新模型型号样式
- 5. 删除模型型号
- 6. 添加模型型号地标图
- 7. 更新模型型号地标图数据
- 8. 更新模型型号地标图样式
- 9. 删除模型型号地标图
- 10. 添加模型型号轨迹图
- 11. 更新模型型号轨迹图数据
- 12. 更新模型型号轨迹图样式
- 13. 删除模型型号轨迹图
1. 连接资产服务器
引入版本：≤ 3.3
功能描述
连接资产服务器
调用方法
JavaScript
let jsonData ={
name: "serverName"
address: "//cimserver.com/cim/webapi/v1/resource/",
token: "ABCDEFG",
}
appInstance.uniCall('connectAssetServer', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| name | String | 资产服务器名称 |
| address | String | 资产服务器地址 例如: http://ip:port/partNumber/ |
| token | String | token |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
2. 断开资产服务器链接
引入版本：≤ 3.3
功能描述
断开资产服务器链接
调用方法
JavaScript
let jsonData = {
name: 'serverName',
};
appInstance.uniCall('disconnectAssetServer', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| name | String | 资产服务器名称 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
3. 添加模型型号
引入版本：3.4.0 起支持
功能描述
添加模型型号
调用方法
JavaScript
let jsonData ={
id: "iconModelId",
serverName:"serverName"，
coordType: 0,
coordTypeZ: 0,
coord: [114.560257, 37.09079],
coordZ: 10,
rotation: [20,80,90],
alpha: 0.5,
scale: 25,
behavior: "normal",
labelText: “地标”,
labelScale: 1,
iconScale: 1
iconModelId: "1234"
}
appInstance.uniCall('addIconModel', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 模型对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| serverName | String | 连接的资产服务器的名称 |
| coordType | Number | xy 轴坐标模式 坐标类型(0:x 经度 y 纬度；1:x 米 y 米，相对世界 00 点) 目前该属性仅支持属性值为 0 |
| coordTypeZ | Number | z 轴坐标模式 坐标高度类型，单位：米(0:相对 3D 世界 0 海拔；1:相对 3D 世界地表；2:相对 3D 模型表面) 目前该属性仅支持属性值为 0 |
| coord | Array | XY 轴坐标，X：经度；Y：纬度 |
| coordZ | Number | Z 轴高度（单位：米） |
| rotation | Array | [Yaw、Pitch、Roll] Yaw 偏航（单位：角度，正南为 0 度，以天为正方向的左手法则, 值域：-360 到 360），Pitch 俯仰角（单位：角度，水平面模型前进方向为 0 度，前进方向左侧的左手法则, 值域：-360 到 360），Roll 翻滚角（单位：角度，水平面模型前进方向右侧为 0 度，模型前进方向的左手法则, 值域：-360 到 360） |
| alpha | Number | 透明度，0：完全透明；1：完全不透明 |
| scale | Number | 模型的放缩倍数（单位：倍），支持单一数值，或者[scaleX, scaleY, scaleZ]的写法。（不包括图标） |
| behavior | String | 模型型号的行为，"normal"：默认行为，无交互，"toggle"：在模型可见距离内，显示标签，隐藏模型，鼠标悬浮，显示半透明模型，和黄色包围盒，单击，一直显示模型，再次单击，隐藏模型 |
| labelText | String | 文字标签内容 |
| labelScale | Number | 文字标签的缩放，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率 |
| iconScale | Number | 图标的缩放，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率 |
| iconModelId | String | 模型型号 Id |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
4. 更新模型型号样式
引入版本：≤ 3.3
功能描述
更新模型型号样式
调用方法
JavaScript
let jsonData ={
id: "iconModelId",
alpha: 0.5,
behavior: "normal",
labelText: “地标”,
labelScale: 1,
iconScale: 1
iconModelId: "1234"
}
appInstance.uniCall('updateIconModelStyle', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 模型对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| alpha | Number | 透明度，0：完全透明；1：完全不透明 |
| behavior | String | 模型型号的行为，"normal"：默认行为，无交互，"toggle"：在模型可见距离内，显示标签，隐藏模型，鼠标悬浮，显示半透明模型，和黄色包围盒，单击，一直显示模型，再次单击，隐藏模型 |
| labelText | String | 文字标签内容 |
| labelScale | Number | 文字标签的缩放，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率 |
| iconScale | Number | 图标的缩放，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率 |
| iconModelId | String | 模型型号 Id，如果更新，可以变换模型 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
5. 删除模型型号
引入版本：3.2 起支持
功能描述
删除模型型号
调用方法
JavaScript
let jsonData = {
id: 'iconModelId',
};
appInstance.uniCall('removeModel', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 模型型号 ID |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
6. 添加模型型号地标图
引入版本：3.4.0 起支持
功能描述
添加模型型号地标图
调用方法
JavaScript
let jsonData ={
id: "iconModelLandmarkLayerId",
serverName:"serverName"，
coordType: 0,
coordTypeZ: 0,
snapSurface: 0,
alpha: 0.5,
visible: true,
legends: [
{
name: "legendName1",
iconModelId:"1111",
labelScale: 1,
iconScale: 1
},
{
name: "legendName2",
iconModelId:"2222",
labelScale: 1,
iconScale: 1
},
{
name: "legendName3",
iconModelId:"3333",
labelScale: 1,
iconScale: 1
}
],
data: [
{
id: "objId",
label: "poi title",
label2: "poi description",
coord: [134.55, 34.577],
coordZ: 0,
scale: [1, 1, 1],
rotation: [20,80,90],
type: "legendName1"
},
{
id: "objId",
label: "poi title",
label2: "poi description",
coord: [134.55, 34.577],
coordZ: 0,
scale: [1, 1, 1],
rotation: [20,80,90],
type: "legendName1"
},
{
id: "objId",
label: "poi title",
label2: "poi description",
coord: [134.55, 34.577],
coordZ: 0,
scale: [1, 1, 1],
rotation: [20,80,90],
type: "legendName1"
}
]
}
appInstance.uniCall('addIconModelLandmarkLayer', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 模型型号地标图层 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| serverName | String | 连接的资产服务器的名称 |
| coordType | Number | xy 轴坐标模式 坐标类型(0:x 经度 y 纬度；1:x 米 y 米，相对世界 00 点) 目前该属性仅支持属性值为 0 |
| coordTypeZ | Number | z 轴坐标模式 坐标高度类型，单位：米(0:相对 3D 世界 0 海拔；1:相对 3D 世界地表；2:相对 3D 模型表面) 目前该属性仅支持属性值为 0 |
| snapSurface | Number | 启用自动贴地,0：不贴地；1：贴地 |
| alpha | Number | 透明度，0：完全透明；1：完全不透明 |
| visible | Boolean | 添加当前图层时默认显示还是隐藏 |
| legends | Array | 定义图层包含图例，支持为不同图例选取不同模型型号 |
| legends[0].name | String | 图层内图例名称，新建时调用者自己传入的唯一名称，用于各种操作的图例识别 |
| legends[0].iconModelId | String | 模型型号 Id |
| legends[0].labelScale | Number | 文字标签的缩放，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率 |
| legends[0].iconScale | Number | 图标的缩放，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率 |
| data | Array | 定义图层可视化数据 |
| data[0].id | String | 模型型号对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| data[0].label | String | 标签文本 |
| data[0].label2 | String | 第二行标签文本 |
| data[0].coord | Array | XY 轴坐标，X：经度；Y：纬度 |
| data[0].coordZ | Number | Z 轴高度（单位：米） |
| data[0].scale | Array | XYZ 三轴的放缩倍数（单位：倍），不包含图标 |
| data[0].rotation | Array | [Yaw、Pitch、Roll] Yaw 偏航（单位：角度，正南为 0 度，以天为正方向的左手法则, 值域：-360 到 360），Pitch 俯仰角（单位：角度，水平面模型前进方向为 0 度，前进方向左侧的左手法则, 值域：-360 到 360），Roll 翻滚角（单位：角度，水平面模型前进方向右侧为 0 度，模型前进方向的左手法则, 值域：-360 到 360） |
| data[0].type | String | 模型型号地标图例类别 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
7. 更新模型型号地标图数据
引入版本：3.4.2 起支持
功能描述
更新模型型号地标图数据
调用方法
JavaScript
let jsonData = {
id: 'iconModelIdarkLayerId',
coordType: 0,
coordTypeZ: 0,
isAppend: true,
data: [
{
id: 'objId',
label: 'poi title',
label2: 'poi description',
coord: [134.55, 34.577],
coordZ: 0,
scale: [1, 1, 1],
rotation: [20, 80, 90],
type: 'legendName1',
},
{
id: 'objId',
label: 'poi title',
label2: 'poi description',
coord: [134.55, 34.577],
coordZ: 0,
scale: [1, 1, 1],
rotation: [20, 80, 90],
type: 'legendName1',
},
{
id: 'objId',
label: 'poi title',
label2: 'poi description',
coord: [134.55, 34.577],
coordZ: 0,
scale: [1, 1, 1],
rotation: [20, 80, 90],
type: 'legendName1',
},
],
};
appInstance.uniCall('updateIconModelLandmarkLayerCoord', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 模型型号地标对象图层 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| coordType | Number | xy 轴坐标模式 坐标类型(0:x 经度 y 纬度；1:x 米 y 米，相对世界 00 点) 目前该属性仅支持属性值为 0 |
| coordTypeZ | Number | z 轴坐标模式 坐标高度类型，单位：米(0:相对 3D 世界 0 海拔；1:相对 3D 世界地表；2:相对 3D 模型表面) 目前该属性仅支持属性值为 0 |
| data | Array | 定义图层可视化数据 |
| data[0].id | String | 模型型号对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| data[0].label | String | 标签文本 |
| data[0].label2 | String | 第二行标签文本 |
| data[0].coord | Array | XY 轴坐标，X：经度；Y：纬度 |
| data[0].coordZ | Number | Z 轴高度（单位：米） |
| data[0].scale | Array | XYZ 三轴的放缩倍数（单位：倍），不包含图标 |
| data[0].rotation | Array | [Yaw、Pitch、Roll] Yaw 偏航（单位：角度，正南为 0 度，以天为正方向的左手法则, 值域：-360 到 360），Pitch 俯仰角（单位：角度，水平面模型前进方向为 0 度，前进方向左侧的左手法则, 值域：-360 到 360），Roll 翻滚角（单位：角度，水平面模型前进方向右侧为 0 度，模型前进方向的左手法则, 值域：-360 到 360） |
| data[0].type | String | 模型型号地标图例类别 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
8. 更新模型型号地标图样式
引入版本：≤ 3.3
功能描述
更新模型型号地标图样式
调用方法
JavaScript
let jsonData = {
id: 'iconModelIdarkLayerId',
alpha: 0.5,
legends: [
{
name: 'legendName1',
iconModelId: '1111',
labelScale: 1,
iconScale: 1,
},
{
name: 'legendName2',
iconModelId: '2222',
labelScale: 1,
iconScale: 1,
},
{
name: 'legendName3',
iconModelId: '3333',
labelScale: 1,
iconScale: 1,
},
],
};
appInstance.uniCall('updateIconModelLandmarkLayerStyle', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 模型型号地标图层 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| alpha | Number | 透明度，0：完全透明；1：完全不透明 |
| legends | Array | 定义图层包含图例，支持为不同图例选取不同模型型号 |
| legends[0].name | String | 图层内图例名称，新建时调用者自己传入的唯一名称，用于各种操作的图例识别 |
| legends[0].iconModelId | String | 模型型号 Id |
| legends[0].labelScale | Number | 文字标签的缩放，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率 |
| legends[0].iconScale | Number | 图标的缩放，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
9. 删除模型型号地标图
引入版本：3.0 起支持
功能描述
删除模型型号地标图
调用方法
JavaScript
let jsonData = {
id: 'iconModelLandmarkLayerId',
overlayType: 'IconModelLandmarkLayer',
};
appInstance.uniCall('removeOverlay', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| overlayType | String | 图层对象类别 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
10. 添加模型型号轨迹图
引入版本：3.4.0 起支持
功能描述
添加模型型号轨迹图
调用方法
JavaScript
let jsonData ={
id: "iconModelIdLayerId",
serverName:"serverName"，
name: "layerName",
coordType: 0,
coordTypeZ: 0,
snapSurface: 0,
duration: 1,
isAutoRotation: false,
trackStyle: "style001",
trackDuration: 50,
trackWidth: 10,
objLife: 500,
visible: true,
legends: [
{
name: "legendName1",
iconModelId:"1111",
labelScale: 1,
iconScale: 1
},
{
name: "legendName2",
iconModelId:"2222",
labelScale: 1,
iconScale: 1
},
{
name: "legendName3",
iconModelId:"3333",
labelScale: 1,
iconScale: 1
}
],
data: [
{
id: "objId",
label: "poi title",
label2: "poi description",
coord: [134.55, 34.577],
coordZ: 0,
scale: [1, 1, 1],
rotation: [20,80,90],
type: "legendName1"
},
{
id: "objId",
label: "poi title",
label2: "poi description",
coord: [134.55, 34.577],
coordZ: 0,
scale: [1, 1, 1],
rotation: [20,80,90],
type: "legendName2"
},
{
id: "objId",
label: "poi title",
label2: "poi description",
coord: [134.55, 34.577],
coordZ: 0,
scale: [1, 1, 1],
rotation: [20,80,90],
type: "legendName3"
}
],
tleData: [
{
id: "objId",
label: "poi title",
label2: "poi description",
line1: "1 60379U 24140A 25001.32435384 .00000109 00000+0 14768-3 0 9994",
line2: "2 60379 88.9883 334.8035 0019127 129.0921 231.1935 13.51870555 20715",
scale: [1, 1, 1],
rotation: [20,80,90],
type: "legendName1"
},
{
id: "objId",
label: "poi title",
label2: "poi description",
line1: "1 60380U 24140B 25001.79631721 .00000189 00000+0 27440-3 0 9999",
line2: "2 60380 88.9874 334.6407 0014715 101.6272 258.6532 13.50905401 20839",
scale: [1, 1, 1],
rotation: [20,80,90],
type: "legendName2"
}
]
}
appInstance.uniCall('addIconModelTrailLayer', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 模型型号轨迹对象 Id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| serverName | String | 连接的资产服务器的名称 |
| name | String | 图层名称，支持为图层自定义名称 |
| coordType | Number | xy 轴坐标模式 坐标类型(0:x 经度 y 纬度；1:x 米 y 米，相对世界 00 点) 目前该属性仅支持属性值为 0 |
| coordTypeZ | Number | z 轴坐标模式 坐标高度类型，单位：米(0:相对 3D 世界 0 海拔；1:相对 3D 世界地表；2:相对 3D 模型表面) 目前该属性仅支持属性值为 0 |
| snapSurface | Number | 启用自动贴地,0：不贴地；1：贴地 |
| duration | Number | 从上一位置运动到新位置花费的时间（单位：秒），如果启用 modelTrailData 数据服务，同时表示同步数据的时间周期 |
| isAutoRotation | Boolean | 是否自动根据当前位置和上一位置计算运动方向，如果为 true 的话，data 中的 rotation 将不起作用。 |
| trackStyle | String | 尾迹风格，端：style001，流：particle-粒子效果，vector-矢量线效果，belt-条带效果，none-无 |
| trackDuration | Number | 尾迹粒子生命周期 |
| trackWidth | Number | 尾迹粒子的宽度 |
| objLife | Number | 批号消批时间长度 |
| visible | Boolean | 添加当前图层时默认显示还是隐藏 |
| legends | Array | 定义图层包含图例，支持为不同图例选取不同模型型号 |
| legends[0].name | String | 图层内图例名称，新建时调用者自己传入的唯一名称，用于各种操作的图例识别 |
| legends[0].iconModelId | String | 模型型号 Id |
| legends[0].labelScale | Number | 文字标签的缩放，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率 |
| legends[0].iconScale | Number | 图标的缩放，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率 |
| data | Array | 定义图层可视化数据 |
| data[0].id | String | 图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| data[0].label | String | 标签文本 |
| data[0].label2 | String | 第二行标签文本 |
| data[0].coord | Array | XY 轴坐标，X：经度；Y：纬度 |
| data[0].coordZ | Number | Z 轴高度（单位：米） |
| data[0].scale | Array | XYZ 三轴的放缩倍数（单位：倍），不包含图标 |
| data[0].rotation | Array | [Yaw、Pitch、Roll] Yaw 偏航（单位：角度，正南为 0 度，以天为正方向的左手法则, 值域：-360 到 360），Pitch 俯仰角（单位：角度，水平面模型前进方向为 0 度，前进方向左侧的左手法则, 值域：-360 到 360），Roll 翻滚角（单位：角度，水平面模型前进方向右侧为 0 度，模型前进方向的左手法则, 值域：-360 到 360） |
| data[0].type | String | 模型型号图例类别 |
| tleData | Array | 定义图层可视化 TLE（双行根数）数据，根据 TLE 和场景时间，计算目标在地惯系下的位置 |
| tleData[0].id | String | 图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| tleData[0].label | String | 标签文本 |
| tleData[0].label2 | String | 第二行标签文本 |
| tleData[0].line1 | String | 双行根数第一行，注意空格和符号，格式必须是："1 NNNNNU NNNNNAAA NNNNN.NNNNNNNN +.NNNNNNNN +NNNNN-N +NNNNN-N N NNNNN" |
| tleData[0].line2 | String | 双行根数第一行，注意空格和符号，格式必须是："2 NNNNN NNN.NNNN NNN.NNNN NNNNNNN NNN.NNNN NNN.NNNN NN.NNNNNNNNNNNNNN" |
| tleData[0].scale | String | XYZ 三轴的放缩倍数（单位：倍），不包含图标 |
| tleData[0].rotation | String | [Yaw、Pitch、Roll] Yaw 偏航（单位：角度，正南为 0 度，以天为正方向的左手法则, 值域：-360 到 360)，Pitch 俯仰角（单位：角度，水平面模型前进方向为 0 度，前进方向左侧的左手法则, 值域：-360 到 360)，Roll 翻滚角（单位：角度，水平面模型前进方向右侧为 0 度，模型前进方向的左手法则, 值域：-360 到 360) |
| tleData[0].type | String | 模型型号图例类别 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
11. 更新模型型号轨迹图数据
引入版本：3.4.2 起支持
功能描述
更新模型型号轨迹图数据
调用方法
JavaScript
let jsonData = {
id: 'iconModelIdLayerId',
name: 'layerName',
coordType: 0,
coordTypeZ: 0,
isAppend: true,
duration: 1,
data: [
{
id: 'objId',
label: 'poi title',
label2: 'poi description',
coord: [134.55, 34.577],
coordZ: 0,
scale: [1, 1, 1],
rotation: [20, 80, 90],
type: 'legendName1',
},
{
id: 'objId',
label: 'poi title',
label2: 'poi description',
coord: [134.55, 34.577],
coordZ: 0,
scale: [1, 1, 1],
rotation: [20, 80, 90],
type: 'legendName2',
},
{
id: 'objId',
label: 'poi title',
label2: 'poi description',
coord: [134.55, 34.577],
coordZ: 0,
scale: [1, 1, 1],
rotation: [20, 80, 90],
type: 'legendName3',
},
],
tleData: [
{
id: 'objId',
label: 'poi title',
label2: 'poi description',
line1: '1 60379U 24140A 25001.32435384 .00000109 00000+0 14768-3 0 9994',
line2: '2 60379 88.9883 334.8035 0019127 129.0921 231.1935 13.51870555 20715',
scale: [1, 1, 1],
rotation: [20, 80, 90],
type: 'legendName1',
},
{
id: 'objId',
label: 'poi title',
label2: 'poi description',
line1: '1 60380U 24140B 25001.79631721 .00000189 00000+0 27440-3 0 9999',
line2: '2 60380 88.9874 334.6407 0014715 101.6272 258.6532 13.50905401 20839',
scale: [1, 1, 1],
rotation: [20, 80, 90],
type: 'legendName2',
},
],
};
appInstance.uniCall('updateIconModelTrailLayerCoord', 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：清除原有数据 & 重建新数据 |
| duration | Number | 从上一位置运动到新位置花费的时间（单位：秒），如果启用 modelTrailData 数据服务，同时表示同步数据的时间周期 |
| data | Array | 定义图层可视化数据 |
| data[0].id | String | 图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| data[0].label | String | 标签文本 |
| data[0].label2 | String | 第二行标签文本 |
| data[0].coord | Array | XY 轴坐标，X：经度；Y：纬度 |
| data[0].coordZ | Number | Z 轴高度（单位：米） |
| data[0].scale | Array | XYZ 三轴的放缩倍数（单位：倍），不包含图标 |
| data[0].rotation | Array | [Yaw、Pitch、Roll] Yaw 偏航（单位：角度，正南为 0 度，以天为正方向的左手法则, 值域：-360 到 360），Pitch 俯仰角（单位：角度，水平面模型前进方向为 0 度，前进方向左侧的左手法则, 值域：-360 到 360），Roll 翻滚角（单位：角度，水平面模型前进方向右侧为 0 度，模型前进方向的左手法则, 值域：-360 到 360） |
| data[0].type | String | 模型型号地标图例类别 |
| tleData | Array | 定义图层可视化 TLE（双行根数）数据，根据 TLE 和场景时间，计算目标在地惯系下的位置 |
| tleData[0].id | String | 图层子对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| tleData[0].label | String | 标签文本 |
| tleData[0].label2 | String | 第二行标签文本 |
| tleData[0].line1 | String | 双行根数第一行，注意空格和符号，格式必须是："1 NNNNNU NNNNNAAA NNNNN.NNNNNNNN +.NNNNNNNN +NNNNN-N +NNNNN-N N NNNNN" |
| tleData[0].line2 | String | 双行根数第一行，注意空格和符号，格式必须是："2 NNNNN NNN.NNNN NNN.NNNN NNNNNNN NNN.NNNN NNN.NNNN NN.NNNNNNNNNNNNNN" |
| tleData[0].scale | String | XYZ 三轴的放缩倍数（单位：倍），不包含图标 |
| tleData[0].rotation | String | [Yaw、Pitch、Roll] Yaw 偏航（单位：角度，正南为 0 度，以天为正方向的左手法则, 值域：-360 到 360)，Pitch 俯仰角（单位：角度，水平面模型前进方向为 0 度，前进方向左侧的左手法则, 值域：-360 到 360)，Roll 翻滚角（单位：角度，水平面模型前进方向右侧为 0 度，模型前进方向的左手法则, 值域：-360 到 360) |
| tleData[0].type | String | 模型型号图例类别 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
12. 更新模型型号轨迹图样式
引入版本：≤ 3.3
功能描述
更新模型型号轨迹图样式
调用方法
JavaScript
let jsonData = {
id: 'iconModelIdLayerId',
objLife: 500,
isAutoRotation: false,
trackStyle: 'style001',
trackDuration: 50,
trackWidth: 10,
legends: [
{
name: 'legendName4',
iconModelId: '4444',
labelScale: 1,
iconScale: 1,
},
{
name: 'legendName5',
iconModelId: '5555',
labelScale: 1,
iconScale: 1,
},
{
name: 'legendName6',
iconModelId: '6666',
labelScale: 1,
iconScale: 1,
},
],
};
appInstance.uniCall('updateIconModelTrailLayerStyle', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 模型型号轨迹对象 Id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| objLife | Number | 批号消批时间长度 |
| isAutoRotation | Boolean | 是否自动根据当前位置和上一位置计算运动方向，如果为 true 的话，data 中的 rotation 将不起作用。 |
| trackStyle | String | 尾迹风格，端：style001，流：particle-粒子效果，vector-矢量线效果，belt-条带效果，none-无 |
| trackDuration | Number | 尾迹粒子生命周期 |
| trackWidth | Number | 尾迹粒子的宽度 |
| legends | Array | 定义图层包含图例，支持为不同图例选取不同模型型号 |
| legends[0].name | String | 图层内图例名称，新建时调用者自己传入的唯一名称，用于各种操作的图例识别 |
| legends[0].iconModelId | String | 模型型号 Id |
| legends[0].labelScale | Number | 文字标签的缩放，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率 |
| legends[0].iconScale | Number | 图标的缩放，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |
13. 删除模型型号轨迹图
引入版本：3.0 起支持
功能描述
模型型号轨迹图
调用方法
JavaScript
let jsonData = {
id: 'iconModelTrailLayerId',
overlayType: 'IconModelTrailLayer',
};
appInstance.uniCall('removeOverlay', jsonData, (result) => {
console.log(result);
});参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别 |
| overlayType | String | 图层对象类别 |
回调数据
JSON
{
"result": 1,
"message": "成功。"
}回调数据参数描述
| 属性 | 类型 | 说明 |
|---|---|---|
| result | Number | 1：代表成功；0：代表失败 |
| message | String | 成功或者失败原因 |