<5-1>功能-点Point
# <5-1>功能接口(点Point)：
## --- 配置场景标签：
----------*对场景的点标签进行配置，添加、删除等；*
### ==5-1-Point-1==：添加 固定三维标签
**接口方法名**：==STU_AddTag==
**参数说明：**
>i< id > 三维标签唯一id，自行生成设置，不要用特殊敏感字符，通过此id查询查询并激活相应标签；
< longitude > 经度；
< latitude > 纬度；
< height > 高度，单位米；
< scale > 标签缩放大小；
< vertical > 是否全正面朝向相机，true全正面朝向相机，fasle垂直地面朝向相机，默认fasle；
< text > 标签内的数据等信息；
< iconUrl > 可以配置icon的标签，传入icon的图片地址，优先加载自定义图标；
< rotation > 标签的三维朝向，0度代表正方向朝北；自动朝向相机的标签，此参数无效；
**< type > 标签类型：打不同类型的标签，字符串参数；(==完整标签类型，见附录1==)**
### -----------1.类型参数标签(==无配置参数==)：-----------
|tag_a_1|tag_a_2|tag_a_3|tag_a_4|...|
|-|-|-|-|-|
|||||**[更多见附录<内置type标签类型编号查询>](doc:CaZn0WAh)**|
### -----------2.类型参数标签(==带icon图标参数==)：-----------
|tag_b_1|tag_b_2|tag_b_3|tag_b_4|...|
|-|-|-|-|-|
|||||**[更多见附录<内置type标签类型编号查询>](doc:CaZn0WAh)**|
### -----------3.类型参数标签(==带文字参数==)：-----------
*多组文字，通过增加数组传入，顺序自行测试即可*
|tag_c_1|tag_c_2|tag_c_3|tag_c_4|...|
|-|-|-|-|-|
|||||**[更多见附录<内置type标签类型编号查询>](doc:CaZn0WAh)**|
### -----------4.类型参数标签(==带icon图标 和 文字 参数==)：-----------
*图标可以自行url图标地址引入，优先使用自定义图标*
|tag_d_1|tag_d_2|tag_d_3|tag_d_4|-|
|-|-|-|-|-|
|||||-|
### -----------5.纯自定义内容通用标签：-----------
*图标可以自行url图标地址引入，优先使用自定义图标*
|tag_e_1|tag_e_2|tag_e_3|tag_e_4|-|
|-|-|-|-|-|
|-|-|-|-|-|
**< icon > 标签图标：标签中的图标；(==完整图标编号，见附录2==)**
|图标（icon）样式|编号参数|
|-|-|
|iconcamera |icon_a_1|
|iconvr |icon_a_2|
|iconwifi探针 |icon_a_3|
|icon车辆卡口 |icon_a_4|
|**[更多见附录<内置icon编号查询>](doc:gKrnH5e6)**|...|
**参数示例：**
```
{
"tagData": [
{
"id": "测试0",
"type": "tag_c_3",
"icon": "icon_a_1",
"iconUrl": "xx/xxx/xxx.png",
"longitude": "113.25163907",
"latitude": "23.10045305",
"height": "1.18000",
"scale": 3.34056687,
"rotation": 0,
"text": [
"测试0"
]
},
{
"id": "测试1",
"type": "a3",
"icon": "icon_a_4",
"longitude": "113.26795882",
"latitude": "23.09083306",
"height": "1000",
"scale": 2.722965,
"text": [
"测试1"
]
},
{
"id": "测试2",
"type": "tag_b_1",
"icon": "icon_a_2",
"longitude": "113.28905848",
"latitude": "23.09863304",
"height": "1000",
"scale": 2.81722021,
"rotation": 0,
"text": [
"测试2"
]
},
{
"id": "测试3",
"type": "tag_b_2",
"icon": "icon_a_3",
"longitude": "113.29045845",
"latitude": "23.08383306",
"height": "1000",
"scale": 3.19546986,
"text": [
"测试3"
]
},
{
"id": "测试4",
"type": "tag_d_1",
"icon": "icon_a_8",
"longitude": "113.29735835",
"latitude": "23.07263306",
"height": "500",
"scale": 3.00138855,
"text": [
"测试4"
]
}
]
}
```
>i 返回参数：
{
"method": "STU_AddTag",
"exception": null,
"data": "success"
}
---
### ==5-1-Point-2-1==：删除 固定三维标签(按id删除)
**接口方法名**：==STU_DeleteTagById==
**参数说明：**
>i< id > 按id参数删除标签（删除标签是id的一个标签）
**参数示例：**
```
{
"data": [
"id_0",
"id_1",
"id_2",
"id_3",
"id_4",
"id_5"
]
}
```
>i 返回参数：
{
"method": "STU_DeleteTagById",
"exception": null,
"data": "success"
}
---
### ==5-1-Point-2-2==：删除 固定三维标签(按类型删除)
**接口方法名**：==STU_DeleteTagByType==
**参数说明：**
>i< type > 按类型删除标签（删除标签是type类型的所有标签）
**参数示例：**
```
{
"data": [
"type_0",
"type_1",
"type_2",
"type_3",
"type_4",
"type_5"
]
}
```
>i 返回参数：
{
"method": "STU_DeleteTagByType",
"exception": null,
"data": "success"
}
---
### ==5-1-Point-2-3==：删除 所有 固定三维标签
**接口方法名**：==STU_DeleteAllTag==
>i无参数 清除所有的标签
>i 返回参数：
{
"method": "STU_DeleteAllTag",
"exception": null,
"data": "success"
}
---
### ==5-1-Point-2-4==：按照轨迹轨迹路径，移动固定三维标签
**接口方法名**：==STU_TagMovePath==
>i无参数
>i 返回参数：
{
"method": "STU_DeleteAllTag",
"exception": null,
"data": "success"
}
---
## --- 查询场景标签：
----------*查询场景中的标签信息；*
### ==5-1-Point-3==：获取 固定三维标签 的屏幕坐标位置
**接口方法名**：==STU_GetTagPosition==
**参数说明：**
>i< id > 按多个标签id参数获取，未查询的的id标签，不返回对应数据
参数示例：
```
{
"id": [
"id_0",
"id_1",
"id_2",
"id_3",
"id_4",
"id_5"
]
}
```
>i 返回参数：
{
"method": "STU_GetTagPosition",
"exception": null,
"data": "success"
}
---
## --- 大规模标点配置：
----------*适用于大量(10万以上的点位数据)的点位数据标记；*
### ==5-1-Point-5==：添加大规模点位
**接口方法名**：==STU_UpdateBigDataPoint==
>i暂无参数 后续动态参数，开放点位大小和随机高度等参数，建议随机大小（0.3-0.8），建议随机高度（3-6）；
< test > 是否使用测试数据打点，1使用，其他整数不使用
< > type 和 id可为空，预留参数
< longitude > 经度；
< latitude > 纬度；
< height > 高度；
< scale > 大小；
**参数示例：**
```
{
"type": "",
"targetdata": [
{
"id": "",
"longitude": "118.77886000",
"latitude": "32.07960000",
"height": "3.1",
"scale": 0.3
}
]
}
```
>i 返回参数：
{
"method": "STU_UpdateBigDataPoint",
"exception": null,
"data": "success"
}
---
### ==5-1-Point-5==：清除 大规模点位功能
**接口方法名**：==STU_CleanBigDataPoint==
>i无参数 清除大范围点位数据
>i 返回参数：
{
"method": "STU_CleanBigDataPoint",
"exception": null,
"data": "success"
}
---