<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 > 标签内的数据等信息；
==新增==：三维标签按钮，点击回调 ==callback_ClickEvent==事件 数据增加（id_屏幕X_屏幕Y）
==新增==：单次调用完接口，返回参数中增加 超出 台州市数据范围外的点位数据；
**< type > 标签类型：打不同类型的标签，字符串参数；
### -----------1.类型参数标签：-----------
|tag_1|tag_2|tag_3|tag_4|tag_5|
|-|-|-|-|-|
||||||
---
|tag_6|tag_7|tag_8|tag_9|tag_10|tag_11|
|-|-|-|-|-|-|
|||||||
---
|tag_12|tag_13|tag_14|tag_15|tag_16|
|-|-|-|-|-|
||||||
---
|tag_17|tag_18|tag_19|tag_20|tag_21|tag_22|
|-|-|-|-|-|-|
|||||||
---
|tag_23|tag_24|tag_25|tag_26|tag_27|tag_28|tag_29|tag_30|tag_31|
|-|-|-|-|-|-|-|-|-|
||||||||||
---
|tag_32|tag_33|tag_34|tag_35|tag_36|tag_37|tag_38|tag_39|tag_40|
|-|-|-|-|-|-|-|-|-|-|
||||||||||
**参数示例：**
```
{
"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-3==：获取 固定三维标签 的屏幕坐标位置
- **接口方法名**：==STU_GetTagPosition==
**参数说明：**
>i< id > 按多个标签id参数获取，未查询的的id标签，不返回对应数据；
==注意1==：屏幕外的标签也查询后返回数据，超出屏幕外的数据需要自行判断剔除；
==注意2==：data数据是序列化的格式，需要Base64的可以提要求，拓展接口功能；
参数示例：
```
{
"data": [
"id_0",
"id_1",
"id_2",
"id_3",
"id_4",
"id_5"
]
}
```
>i 返回参数：
{
"method": "STU_GetTagPosition",
"exception": null,
"data": "查询到的结果数据"
}
---
## --- 大规模标点配置：
----------*适用于大量(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"
}
---