该能力仅面向完成企业认证开发者开放,个人开发者不支持申请。
设备限制:信号路线功能仅适用于Phone、Tablet、PC/2in1和Wearable。
场景限制:
申请场景需与地图展示、路线规划、户外出行决策有明确关联,开发者申请该权益时,应基于Map Kit地图能力集成使用。常见的申请场景示例如下。
申请场景需与网络质量信息存在明确关联,如自驾路线推荐、徒步路线规划、户外救援保障等。
以下场景不支持申请:
信号路线功能主要由MapSignalParams、addSignalLine、MapSignalLine提供,更多接口及使用方法请参见接口文档。
| 接口名 | 描述 |
|---|---|
| MapSignalParams | 信号路线的属性。 |
| addSignalLine(params: mapCommon.MapSignalParams): Promise<MapSignalLine> | 新增信号路线。 |
| MapSignalLine | 信号路线管理对象。 |
使用信号路线功能需要先开通信号预测能力。
权限申请入口目前仅针对企业开发者开放,个人开发者不可见。
登录AppGallery Connect网站,选择“开发与服务”。

在项目列表中找到需要开通“信号预测能力”的应用。

进入“开放能力管理”页签,找到“地图服务”开关下的“信号预测能力”,点击“申请”。

确认您已满足开通信号预测能力的所有条件后,点击“下一步”。

填写申请原因。
申请原因填写模板:

系统将推送消息到互动中心,请等待审核。3个工作日内审核结果会通过站内消息的形式发送到互动中心,请注意查收。
审核通过后,勾选“地图服务”和“信号预测能力”以完成配置。

导入相关模块。
import { MapComponent, mapCommon, map } from '@kit.MapKit';
import { AsyncCallback } from '@kit.BasicServicesKit'; 绘制信号路线。
@Entry
@Component
struct MapSignalLineDemo {
// ...
private mapOptions?: mapCommon.MapOptions;
private mapController?: map.MapComponentController;
private callback?: AsyncCallback<map.MapComponentController>;
private mapSignalLine?: map.MapSignalLine;
aboutToAppear(): void {
this.mapOptions = {
position: {
target: {
latitude: 32.055583099352,
longitude: 118.540076398149
},
zoom: 14
}
};
this.callback = async (err, mapController) => {
if (!err) {
this.mapController = mapController;
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 },
{ longitude: 118.544343, latitude: 32.048765 }, { longitude: 118.544098, latitude: 32.048780 },
{ longitude: 118.538145, latitude: 32.048836 }, { longitude: 118.537896, latitude: 32.048846 },
{ longitude: 118.537654, latitude: 32.048818 }, { longitude: 118.537446, latitude: 32.048708 },
{ longitude: 118.532201, latitude: 32.049620 }, { longitude: 118.532076, latitude: 32.049583 },
{ longitude: 118.531726, latitude: 32.049490 }, { longitude: 118.531593, latitude: 32.049475 },
{ longitude: 118.531466, latitude: 32.049443 }, { longitude: 118.528349, latitude: 32.052531 },
{ longitude: 118.528298, latitude: 32.053657 }, { longitude: 118.528288, latitude: 32.053851 },
{ longitude: 118.527082, latitude: 32.054653 }, { longitude: 118.526755, latitude: 32.054781 },
{ longitude: 118.526755, latitude: 32.054857 }, { longitude: 118.526654, latitude: 32.055124 },
{ longitude: 118.529706, latitude: 32.057719 }, { longitude: 118.530101, latitude: 32.057906 },
{ longitude: 118.530211, latitude: 32.057911 }, { longitude: 118.532985, latitude: 32.058305 },
{ longitude: 118.538524, latitude: 32.057508 }, { longitude: 118.538571, latitude: 32.057418 },
{ longitude: 118.540255, latitude: 32.058049 }, { longitude: 118.540545, latitude: 32.058251 },
{ longitude: 118.540655, latitude: 32.058285 }, { longitude: 118.543645, latitude: 32.059025 },
{ longitude: 118.543763, latitude: 32.059010 }, { longitude: 118.545292, latitude: 32.059901 },
{ longitude: 118.545397, latitude: 32.059912 }, { longitude: 118.548790, latitude: 32.063339 },
{ longitude: 118.549064, latitude: 32.063531 }, { longitude: 118.550198, latitude: 32.064369 },
{ longitude: 118.552740, latitude: 32.059904 }, { longitude: 118.552866, latitude: 32.059620 },
{ longitude: 118.552929, latitude: 32.059516 }, { longitude: 118.553045, latitude: 32.059157 },
{ longitude: 118.553078, latitude: 32.059049 }, { longitude: 118.553186, latitude: 32.056241 },
{ longitude: 118.553204, latitude: 32.056126 }, { longitude: 118.553062, latitude: 32.053036 },
{ longitude: 118.553555, latitude: 32.051478 }, { longitude: 118.553626, latitude: 32.051203 },
{ longitude: 118.553650, latitude: 32.050680 }, { longitude: 118.553684, latitude: 32.050578 }];
// 添加信号线
try {
this.mapSignalLine = await this.mapController.addSignalLine(mapSignalParams);
} catch (e) {
console.error(`Failed to create the signalLine, code is:${e.code}, message is ${e.message}`);
}
} else {
// 地图初始化失败
console.error(`Failed to initialize the map, code is:${err.code}, message is ${err.message}`);
}
};
}
build() {
// ...
Stack() {
Column() {
MapComponent({ mapOptions: this.mapOptions, mapCallback: this.callback });
}.width('100%')
}.height('100%')
// ...
}
} 通过removeSignalLineCache,移除地图信号路线缓存,释放存储空间。
// 删除信号路线ID为signalId1的缓存
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 }];
// 首次添加信号路线会自动缓存该路线信息
try {
let mapSignalLine1 = await this.mapController.addSignalLine(mapSignalParams);
// 删除后,以相同signalId(points不传值)添加路线时,会触发缓存
mapSignalLine1.remove();
let mapSignalLine2 = await this.mapController.addSignalLine({signalId: mapSignalParams.signalId});
// 再次删除,且通过removeSignalLineCache,可以移除地图信号路线缓存。
mapSignalLine2.remove();
this.mapController?.removeSignalLineCache(mapSignalParams.signalId);
} catch (e) {
console.error(`Operation failed, code is:${e.code}, message is ${e.message}`);
}