# 二、标记
# （一）定义
标记要素是一种地图数据，可用来标记地图上的任意位置点。例如标记人员位置，设备位置，活动集合点...等等。
# （二）标记集合
所有的标记数据，都存放在不同的标记集合之下。想要对标记进行操作，需要先获取标记集合。 标记集合的常用属性如下：
| 属性名 | 值类型 | 属性描述 |
|---|---|---|
| name | String | 标记集合名称 |
| remark | String | 备注 |
| icon | Icon | 图标 |
| pointSymbol | PointSymbol | 点符号 |
常用方法如下：（get/set方法略）
| 方法名 | 返回类型 | 方法描述 |
|---|---|---|
| queryMarkers | void | 查询集合下的所有标记要素 |
| queryMarkerByName | void | 在该集合下的根据名称查找标记要素 |
| createMarker | void | 创建标记 |
| updateMarker | void | 更新标记信息 |
| deleteMarker | void | 删除标记 |
# 1、获取标记集合
初始化成功后，可直接从Cellsys的organization对象中获取到组织下所有的标记集合。
/*执行初始化成功后，可直接获取到标记集合*/
let markerSets = Cellsys.shared.organization!.markerSets
if (markerSets != nil) {//无数据时为null，因此要判空
for markerSet in markerSets {
let name = markerSet.name //集合名称
let remark = markerSet.remark //集合备注信息
let icon = markerSet.icon//获取图标对象
let pointSymbol = markerSet.symbol//获取地图符号对象
}
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
# （1）图标[Icon]
图标[Icon]是数据在普通界面上的展示。标记要素[MarkerFeature]的图标由其所属的标记集合[MarkerSet]图标决定。
有关图标类[Icon]的详细介绍，可查看附-样式
# （2）点符号[PointSymbol]
点符号[PointSymbol]则是数据在地图上的点状展示。标记要素[MarkerFeature]的点符号由其所属的标记集合[MarkerSet]的点符号决定。
有关点符号[PointSymbol]的详细介绍，可查看附-样式
# 2、新增标记集合
标记集合通过组织[Organization]对象创建。具体操作见代码示例
/*创建方法1：不传icon,默认图标*/
let organization = Cellsys.shared.organization!
organization.createMarkerSet(name: "集合名称", remark: "集合描述") { obj, errorMessage in
//成功
if (obj != nil) {
let markerSet = obj?.data as? MarkerSet
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
/*创建方法2：传icon，自定义图标。
从图标库获取图标以创建带自定义图标的标记集合。*/
organization.createMarkerSet(name: "集合名称", remark: "集合描述", icon: icon) { obj, errorMessage in
//成功
if (obj != nil) {
let markerSet = obj?.data as? MarkerSet
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
有关图标的获取方法见附-样式。
# 3、修改标记集合
标记集合通过组织[Organization]对象来修改。具体操作见代码示例
markerSet.name = "修改名称"
markerSet.remark = "修改备注"
markerSet.icon = icon //修改图标与点样式
organization.updateMarkerSet(markerSet: markerSet!) { obj, errorMessage in
//成功
if (obj != nil) {
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
CoreSDK要求标记集合的点符号[PointSymbol]和图标[Icon]要求使用相同的图标。因此，icon属性的修改也会同事修改pointSymbol属性。
# 4、删除标记集合
标记集合通过组织[Organization]对象来删除。具体操作见代码示例
organization.deleteMarkerSet(markerSet: markerSet!) { obj, errorMessage in
//成功
if (obj != nil) {
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
# （三）标记要素
标记要素是数据，每一个标记要素对象都代表一个标记。标记要素的常用属性表如下：
| 属性名 | 值类型 | 属性描述 |
|---|---|---|
| name | String | 标记集合名称 |
| remark | String | 备注 |
| icon | Icon | 图标 |
| pointSymbol | PointSymbol | 点符号 |
| mapPoint | MapPoint | 点坐标 |
| fenceInfo | FenceInfo | 围栏信息 |
标记要素的常用方法如下：（get/set方法略）
| 方法名 | 返回类型 | 方法描述 |
|---|
# 1、获取标记
标记集合[MarkerSet]提供了query方法来查询自身集合中的标记要素。具体操作见代码示例
/*查询集合中的所有标记要素*/
markerSet.queryMarkers { obj, errorMessage in
//成功
if (obj != nil) {
/*PageInfo类为页码信息类*/
let pageInfo = obj!.pageInfo //页码信息
let currentPage = pageInfo?.pageNo //当前的页码
let pageSize = pageInfo?.pageSize //每页数量
let totalPage = pageInfo?.totalPage //总页数
let totalCount = pageInfo?.totalCount //数据总量
let markers = obj?.data as? [MarkerFeature]
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
/*根据名称查询集合中的标记数据*/
markerSet.queryMarkerByName(likeName: "搜索名称") { obj, errorMessage in
//成功
if (obj != nil) {
let markers = obj?.data as? [MarkerFeature]
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# （1）点坐标[MapPoint]
点坐标[MapPoint]是一种坐标数据类，一个对象代表一个点坐标。其常用属性表如下：
| 属性名 | 值类型 | 属性描述 |
|---|---|---|
| latitude | double | 纬度 |
| longitude | double | 经度 |
| coordinateSystem | CoordinateSystem | 坐标系 |
| geometryType | GeometryType | 父类属性...用来标识坐标数据类型（点、线、面） |
常用方法如下：（get/set方法略）
| 方法名 | 返回类型 | 方法描述 |
|---|---|---|
| toGeoJson | JSONObject | 将点坐标转成geoJson |
点坐标相关使用示例如下：
/*点坐标使用示例*/
let latitude = mapPoint.latitude //纬度
let longitude = mapPoint.longitude //经度
let coordinateSystem = mapPoint.coordinateSystem //坐标系
switch (coordinateSystem) {
case .AMap:
//高德地图坐标系
break;
case .BaiduMap:
//百度地图坐标系
break;
case .WGS84:
//WGS84坐标系
break;
}
let jsonObject = mapPoint.toGeoJson() //将点坐标转成geoJson
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# （2）围栏信息[FenceInfo]
在CoreSDK中，电子围栏是一种消息提醒装置。通过对标记要素、路线要素、区域要素设置围栏信息来生成电子围栏。经过一系列的配置后，电子围栏可通过人员的位置变化来实现人员进出围栏的消息提醒。以一张区域围栏的效果图为例：
标记要素可作为电子围栏存在。点状围栏可配置触发条件（进入围栏、离开围栏），半径（米），缓冲距离（米）等属性。其具体属性表如下：
| 属性名 | 值类型 | 属性描述 |
|---|---|---|
| triggerType | FenceTriggerType | 围栏触发类型（进入、离开） |
| radius | int | 围栏半径（米） |
| bufferDistance | double | 缓冲距离（米） |
常用方法如下：
| 方法名 | 返回类型 | 方法描述 |
|---|---|---|
| isEnable | boolean | 围栏是否启用 |
| disableFence | void | 关闭围栏 |
| enableFence | void | 启用围栏 |
| getTriggerType | FenceTriggerType | 获取围栏触发类型 |
具体使用示例如下：
/*围栏信息详情获取示例*/
let radius = fenceInfo.radius //点状围栏半径。单位：米
let bufferDistance = fenceInfo.bufferDistance //缓冲距离。单位：米
let fenceTriggerType = fenceInfo.triggerType //获取围栏触发类型
switch (fenceTriggerType) {
case .In://进入提醒
break;
case .Out://离开提醒
break;
case .Default://默认（停用围栏）
break;
}
let isEnable = fenceInfo.enable //电子围栏是否启动
if (isEnable) {
//围栏已启用
} else {
//围栏已停用
}
/*围栏信息改动示例*/
fenceInfo.enableFence(triggerType: FenceTriggerType.In) //启动电子围栏（进入提醒）
fenceInfo.enableFence(triggerType: FenceTriggerType.Out) //启动电子围栏（离开提醒）
fenceInfo.disableFence()//关闭电子围栏
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 2、新增标记
标记要素[MarkerFeature]通过标记集合[MarkerSet]对象创建。具体操作见代码示例
markerSet.createMarker(name: "新增标记", remark: "备注信息", mapPoint: MapPoint.new(latitude: 23.246300, longitude: 113.411300), callback: { obj, errorMessage in
//成功
if (obj != nil) {
//创建markerFeature成功
let markerFeature = obj?.data as? MarkerFeature
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
})
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
# 3、修改标记
标记要素[MarkerFeature]通过标记集合[MarkerSet]对象修改。具体操作见代码示例
markerFeature.remark = "修改备注信息"
//设置围栏
let fenceInfo = markerFeature.fenceInfo ?? FenceInfo()
fenceInfo.radius = 10 //围栏半径
fenceInfo.enableFence(triggerType: FenceTriggerType.In)
markerSet.updateMarker(marker: markerFeature, callback: { obj, errorMessage in
//成功
if (obj != nil) {
//更新markerFeature信息成功
//修改成功后，直接使用原来的对象即可。
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 4、删除标记
标记要素[MarkerFeature]通过标记集合[MarkerSet]对象删除。具体操作见代码示例
markerSet.deleteMarker(marker: markerFeature, callback: { obj, errorMessage in
//成功
if (obj != nil) {
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
})
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10