目录

Interface (MapSignalLine)

导入模块

import { map, mapCommon } from '@kit.MapKit';

MapSignalLine

信号路线管理对象，继承BaseOverlay。在调用map.MapComponentController类的addSignalLine方法时会返回该类型的实例。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 26.0.0

示例：

let mapSignalParams: mapCommon.MapSignalParams = {
  signalId: 'signalId1'
};
mapSignalParams.points =
  [{ longitude: 118.553695, latitude: 32.050789 },
    { longitude: 118.553738, latitude: 32.050884 },
    { longitude: 118.548506, latitude: 32.048543 },
    { longitude: 118.548413, latitude: 32.048374 },
    { longitude: 118.547185, latitude: 32.048252 },
    { longitude: 118.546939, latitude: 32.048296 }]
// 添加信号路线
let mapSignalLine1 = await mapController.addSignalLine(mapSignalParams);

[h2]setColors

setColors(colors: number[]): void

设置信号路线的颜色。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 26.0.0

参数：

参数名 类型 必填 说明
colors number[] 是 信号路线的颜色，三个颜色分别对应弱、中、强信号，数组长度必须为3，ARGB格式，例如：[0xFF000000, 0xFFFFDF42, 0xFF42B0FF]。异常值不处理。

示例：

// 设置信号路线的颜色
signalLine.setColors([0xFF000000, 0xFFFFDF42, 0xFF42B0FF]);

[h2]getColors

getColors(): number[]

获取信号路线的颜色。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 26.0.0

返回值：

类型 说明
number[] 信号路线的颜色。

示例：

// 获取信号路线颜色
let colors: number[] = signalLine.getColors()

[h2]setWidth

setWidth(width: number): void

设置信号路线的宽度。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 26.0.0

参数：

参数名 类型 必填 说明
width number 是 信号路线的宽度，单位：px，有效范围为：[0, 512]。异常值不处理。

示例：

// 设置线宽为20
signalLine.setWidth(20);

[h2]getWidth

getWidth(): number

获取信号路线的宽度。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 26.0.0

返回值：

类型 说明
number 信号路线的宽度。

示例：

// 获取信号路线宽度
let width: number = signalLine.getWidth()