# 三、路线
# （一）概述
路线数据包括路线要素[LineFeature]、路线集合[LineSet]两个数据类。
路线要素[LineFeature]是一种地图数据，可用来记录地图上的任意的路线。例如跑步路线，巡逻路线，行车路线...等等。如下图，一个路线要素对象可以表示一整条跑步路线：
路线集合[LineSet]用来分类存放、管理路线要素[LineFeature]。
# （二）路线集合[LineSet]
所有的路线数据，都存放在不同的路线集合之下。想要对路线进行操作，需要先获取路线集合。 路线集合[LineSet]的常用属性如下：
| 属性名 | 值类型 | 属性描述 |
|---|---|---|
| name | String | 路线集合名称 |
| remark | String | 备注 |
| symbol | PolylineSymbol | 线符号 |
常用方法如下：（get/set方法略）
| 方法名 | 返回类型 | 方法描述 |
|---|---|---|
| queryLines | void | 查询集合下的所有路线要素 |
| createLine | void | 创建路线 |
| updateLine | void | 更新路线信息 |
| deleteLine | void | 删除路线 |
# 1、获取路线集合
初始化成功后，可直接从Cellsys的organization对象中获取到组织下所有的路线集合。具体代码示例如下：
/*执行初始化成功后，可直接获取到路线集合*/
let lineSets = Cellsys.shared.organization.lineSets //lineSets可能为null
if (lineSets != nil ) {
let lineSet = lineSets.first
let name = lineSet.name //集合名称
let remark = lineSet.remark //集合备注信息
let polylineSymbol = lineSet.symbol//获取地图符号对象
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# （1）线符号[PolylineSymbol]
线符号决定了路线要素在地图上的具体参数，如：线颜色、线透明度、线宽度等。具体参数获取示例如下：
let color = polylineSymbol.fillColor //路线填充颜色
let colorValue = color.value //返回一个带#号的色值：如#3c3c3c
let width = polylineSymbol.width //路线宽度，单位px
let alpha = polylineSymbol.alpha //不透明度。取值范围0~1,1为不透明
1
2
3
4
2
3
4
有关线符号[PolylineSymbol]的详细介绍，可查看附-样式
# 2、新增路线集合
路线集合通过组织[Organization]对象创建。具体操作见代码示例
let lineSymbol = PolylineSymbol.new(width: 2, strokeType: StrokeType.SolidLine, fillColor: Color.new(ribbon: Ribbon.Blue, level: RibbonLevel.L4), alpha: 1)
organization.createLineSet(name: "新增线路集合", remark: "集合备注", lineSymbol: lineSymbol) { obj, errorMessage in
//成功
if (obj != nil) {
lineSet = obj?.data as? LineSet
}
//失败
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、修改路线集合
路线集合通过组织[Organization]对象修改。具体操作见代码示例
lineSet.remark = "修改线路集合"
organization.updateLineSet(lineSet: lineSet) { obj, errorMessage in
//成功
if (obj != nil) {
lineSet = obj?.data as? LineSet
}
//失败
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
# 4、删除路线集合
路线集合通过组织[Organization]对象来删除。具体操作见代码示例
organization.deleteLineSet(lineSet: lineSet!) { 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
# （三）路线要素[LineFeature]
路线要素是地图数据，一个路线要素对象可以表示一条地图路线。路线要素的常用属性表如下：
| 属性名 | 值类型 | 属性描述 |
|---|---|---|
| name | String | 路线集合名称 |
| remark | String | 备注 |
| symbol | PolylineSymbol | 线符号 |
| polyline | Polyline | 线坐标集合 |
| fenceInfo | FenceInfo | 围栏信息 |
路线要素的常用方法如下：（get/set方法略）
| 方法名 | 返回类型 | 方法描述 |
|---|---|---|
| - | - | - |
# 1、获取路线要素
路线集合[LineSet]提供了query方法来查询自身集合中的路线要素。具体操作见代码示例
lineSet.queryLines { obj, errorMessage in
//成功
if (obj != nil) {
/*分页信息-查询方法特有*/
let pageInfo = obj.pageInfo //查询接口特有的分页信息
let totalCount = pageInfo.totalCount //数据总数
let totalPage = pageInfo.totalPage //总页数
let pageNo = pageInfo.pageNo //当前页码(从1开始）
let pageSize = pageInfo.pageSize //每页查询数量（注意！不一定和当前查询的数据总量匹配）
/*获取查询结果*/
let lineFeatures = object.data;
if (lineFeatures != nil) {//查询结果可能为nil
for lineFeature in lineFeatures {
/*路线要素基础信息获取示例*/
let name = lineFeature.name//路线要素名称
let remark = lineFeature.remark //备注
let polylineSymbol = lineFeature.symbol //路线符号
let polyline = lineFeature.polyline //路线坐标
let fenceInfo = lineFeature.fenceInfo //电子围栏属性
}
}
}
//失败
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
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
# 2、新增路线要素
路线要素[LineFeature]通过路线集合[LineSet]对象创建。具体操作见代码示例
/*生成路线坐标*/
let geometry = ["type":"LineString","coordinates":[[113.436174765915,23.1632031849264],[113.43617987521,23.1622170910859],[113.43706378316,23.162237528264],[113.437293701413,23.1623550420377]]] as [String : Any]
let polyline = PolyLine.new(jsonGeometry: JSON(geometry)) as! PolyLine
lineSet.createLine(name: "线路名称", remark: "路线备注", polyline: polyline) { obj, errorMessage in
//成功
if (obj != nil) {
let lineFeature = obj?.data as? LineFeature
}
//失败
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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 3、修改路线要素
路线要素[LineFeature]通过路线集合[LineSet]对象修改。具体操作见代码示例
lineFeature.remark = "修改备注"
lineSet.updateLine(line: lineFeature) { 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
2
3
4
5
6
7
8
9
10
11
# 4、删除路线要素
路线要素[LineFeature]通过路线集合[LineSet]对象删除。具体操作见代码示例
lineSet.deleteLine(line: lineFeature) { 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