openharmony 鸿蒙 start-navigation-apps

2025-06-12 浏览 (1)

拉起导航类应用（startAbilityByType）

本章节介绍如何拉起导航类应用扩展面板。

导航类应用扩展面板参数说明

startAbilityByType接口中type字段为navigation，支持路线规划、导航、位置搜索三种意图场景，对应的wantParam参数如下：

说明： 本文中的经纬度均采用GCJ-02坐标系统。

  • 路线规划场景

    参数名类型必填说明
    sceneTypenumber否意图场景，表明本次请求对应的操作意图。默认为1，路线规划场景填1或不填。
    originNamestring否起点名称。
    originLatitudenumber否起点纬度。
    originLongitudenumber否起点经度。
    originPoiIdsRecord<number, string>否起点POI ID列表，当前仅支持传入花瓣地图和高德地图的POI ID。
    destinationNamestring否终点名称。
    destinationLatitudenumber是终点纬度。
    destinationLongitudenumber是终点经度。
    destinationPoiIdsRecord<number, string>否终点POI ID列表，当前仅支持传入花瓣地图和高德地图的POI ID。
    vehicleTypenumber否交通出行工具，取值：0-驾车，1-步行，2-骑行，3-公交。

  • 导航场景

    参数名类型必填说明
    sceneTypenumber是意图场景，表明本次请求对应的操作意图。导航场景填2。
    destinationNamestring否终点名称。
    destinationLatitudenumber是终点纬度。
    destinationLongitudenumber是终点经度。
    destinationPoiIdsRecord<number, string>否终点POI ID列表，当前仅支持传入花瓣地图和高德地图的POI ID。

  • 位置搜索场景

    参数名类型必填说明
    sceneTypenumber是意图场景，表明本次请求对应的操作意图。位置搜索场景填3。
    destinationNamestring是地点名称。

拉起方开发步骤

  1. 导入相关模块。

    import { common } from '@kit.AbilityKit';

  2. 构造接口参数并调用startAbilityByType接口。

    终点POI ID列表（destinationPoiIds）和起点POI ID列表（originPoiIds）需开发者自行从各地图系统中获取，并按照对应关系传参。

    @Entry
@Component
struct Index {
@State hideAbility: string = 'hideAbility'

	build() {
		Row() {
			Column() {
				Text(this.hideAbility)
					.fontSize(30)
					.fontWeight(FontWeight.Bold)
					.onClick(() => {
						let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
						let wantParam: Record<string, Object> = {
							'sceneType': 1,
							'destinationLatitude': 32.060844,
							'destinationLongitude': 118.78315,
							'destinationName': 'xx市xx路xx号',
							'destinationPoiIds': {
								1: '1111', // key为1代表花瓣地图，value需为花瓣地图POI
								2: '2222'   // key为2代表高德地图，value需为高德地图POI
							} as Record<number, string>,
							'originName': 'xx市xx公园',
							'originLatitude': 31.060844,
							'originLongitude': 120.78315,
							'originPoiIds': {
								1: '3333', // key为1代表花瓣地图，value需为花瓣地图POI
								2: '4444'   // key为2代表高德地图，value需为高德地图POI
							} as Record<number, string>,
							'vehicleType': 0
						};
						let abilityStartCallback: common.AbilityStartCallback = {
							onError: (code: number, name: string, message: string) => {
								console.log(`onError code ${code} name: ${name} message: ${message}`);
							},
							onResult: (result) => {
								console.log(`onResult result: ${JSON.stringify(result)}`);
							}
						}

						context.startAbilityByType("navigation", wantParam, abilityStartCallback,
							(err) => {
								if (err) {
									console.error(`startAbilityByType fail, err: ${JSON.stringify(err)}`);
								} else {
									console.log(`success`);
								}
							});
					});
			}
			.width('100%')
		}
		.height('100%')
	}
}

    效果示例图：

    效果示例图

目标方开发步骤

  1. 在module.json5中配置uris，步骤如下：

    1. 设置linkFeature属性以声明当前应用支持的特性功能，从而系统可以从设备已安装应用中找到当前支持该特性的应用，取值范围如下： |取值 |含义 | |--------------|----------------------------| |Navigation |声明应用支持导航功能 | |RoutePlan |声明应用支持路线规划功能 | |PlaceSearch |声明应用支持位置搜索功能 |
    2. 设置scheme、host、port、path/pathStartWith属性，与Want中URI相匹配，以便区分不同功能。
    {
  "abilities": [
      {
      "skills": [
          {
          "uris": [
              {
              "scheme": "maps", // 这里仅示意，应用需确保这里声明的的uri能被外部正常拉起
              "host": "navigation",
              "path": "",
              "linkFeature": "Navigation" // 声明应用支持导航功能
              },
              {
              "scheme": "maps", // 这里仅示意，应用需确保这里声明的的uri能被外部正常拉起
              "host": "routePlan",
              "path": "",
              "linkFeature": "RoutePlan" // 声明应用支持路线规划功能
              },
              {
              "scheme": "maps", // 这里仅示意，应用需确保这里声明的的uri能被外部正常拉起
              "host": "search",
              "path": "",
              "linkFeature": "PlaceSearch" // 声明应用支持位置搜索功能
              }
          ]
          }
      ]
      }
  ]
}

  2. 解析参数并做对应处理。

    UIAbility.onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void

    在参数want.uri中会携带目标方配置的linkFeature对应的uri。

    在参数want.parameters中会携带Caller方传入的参数，不同场景参数如下所示。

    • 路线规划场景

      参数名类型必填说明
      originNamestring否起点名称。
      originLatitudenumber否起点纬度。
      originLongitudenumber否起点经度。
      originPoiIdstring否起点POI ID，当前仅支持花瓣地图和高德地图获取此参数。
      destinationNamestring否终点名称。
      destinationLatitudenumber是终点纬度。
      destinationLongitudenumber是终点经度。
      destinationPoiIdstring否终点POI ID，当前仅支持花瓣地图和高德地图获取此参数。
      vehicleTypenumber否交通出行工具，取值：0-驾车，1-步行，2-骑行，3-公交。

    • 导航场景

      参数名类型必填说明
      destinationNamestring否终点名称。
      destinationLatitudenumber是终点纬度。
      destinationLongitudenumber是终点经度。
      destinationPoiIdstring否终点POI ID，当前仅支持花瓣地图和高德地图获取此参数。

    • 位置搜索场景

      参数名类型必填说明
      destinationNamestring是地点名称。

    应用可根据linkFeature中定义的特性功能，比如路线规划、导航和位置搜索，结合接收到的uri和参数开发不同的样式页面。

完整示例：

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';

const TAG = 'EntryAbility'

export default class EntryAbility extends UIAbility {
    windowStage: window.WindowStage|null = null;

    uri?: string;
    destinationLatitude?: number;
    destinationLongitude?: number;
    destinationName?: string;
    originName?: string;
    originLatitude?: number;
    originLongitude?: number;
    vehicleType?: number;
    destinationPoiId?: string;
    originPoiId?: string;

    onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
        hilog.info(0x0000, TAG, `onCreate, want=${JSON.stringify(want)}`);
        super.onCreate(want, launchParam);
        this.parseWant(want);
    }

    onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {
        hilog.info(0x0000, TAG, `onNewWant, want=${JSON.stringify(want)}`);
        super.onNewWant(want, launchParam);
        this.parseWant(want);
        if (!this.windowStage) {
            hilog.error(0x0000, TAG, 'windowStage is null');
            this.context.terminateSelf();
            return;
        }
        this.loadPage(this.windowStage);
    }

    private parseWant(want: Want): void {
        this.uri = want.uri as string|undefined;
        this.destinationLatitude = want.parameters?.destinationLatitude as number|undefined;
        this.destinationLongitude = want.parameters?.destinationLongitude as number|undefined;
        this.destinationName = want.parameters?.destinationName as string|undefined;
        this.originName = want.parameters?.originName as string|undefined;
        this.originLatitude = want.parameters?.originLatitude as number|undefined;
        this.originLongitude = want.parameters?.originLongitude as number|undefined;
        this.vehicleType = want.parameters?.vehicleType as number|undefined;
        this.destinationPoiId = want.parameters?.destinationPoiId as string|undefined;
        this.originPoiId = want.parameters?.originPoiId as string|undefined;
    }

    private loadPage(windowStage: window.WindowStage): void {
        hilog.info(0x0000, TAG, `loadPage, uri=${this.uri}`);
        if (this.uri === 'maps://navigation') {
            // 构建导航场景参数
            const storage: LocalStorage = new LocalStorage({
                "destinationLatitude": this.destinationLatitude,
                "destinationLongitude": this.destinationLongitude,
                "destinationPoiId": this.destinationPoiId
            } as Record<string, Object>);
            // 拉起导航页面
            windowStage.loadContent('pages/NavigationPage', storage)
        } else if (this.uri === 'maps://routePlan') {
            // 构建路径规划场景参数
            const storage: LocalStorage = new LocalStorage({
                "destinationLatitude": this.destinationLatitude,
                "destinationLongitude": this.destinationLongitude,
                "destinationName": this.destinationName,
                "originName": this.originName,
                "originLatitude": this.originLatitude,
                "originLongitude": this.originLongitude,
                "vehicleType": this.vehicleType,
                "destinationPoiId": this.destinationPoiId,
                "originPoiId": this.originPoiId
            } as Record<string, Object>);
            // 拉起路径规划页面
            windowStage.loadContent('pages/RoutePlanPage', storage)
        }  else if (this.uri === 'maps://search') {
            // 构建位置搜索场景参数
            const storage: LocalStorage = new LocalStorage({
                "destinationName": this.destinationName
            } as Record<string, Object>);
            // 拉起位置搜索页面
            windowStage.loadContent('pages/PlaceSearchPage', storage)
        } else {
            // 默认拉起首页
            windowStage.loadContent('pages/Index', (err) => {
                if (err.code) {
                    hilog.error(0x0000, TAG, 'Failed to load the content. Cause: %{public}s',
                        JSON.stringify(err) ?? '');
                    return;
                }
                hilog.info(0x0000, TAG, 'Succeeded in loading the content.');
            });
        }
    }

    onDestroy(): void {
        hilog.info(0x0000, TAG, `onDestroy`);
    }

    onWindowStageCreate(windowStage: window.WindowStage): void {
        hilog.info(0x0000, TAG, `onWindowStageCreate`);
        this.windowStage = windowStage;
        this.loadPage(this.windowStage);
    }

    onWindowStageDestroy(): void {
        hilog.info(0x0000, TAG, '%{public}s', 'Ability onWindowStageDestroy');
    }

    onForeground(): void {
        hilog.info(0x0000, TAG, '%{public}s', 'Ability onForeground');
    }

    onBackground(): void {
        hilog.info(0x0000, TAG, '%{public}s', 'Ability onBackground');
    }
}

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Ability Kit（程序框架服务）

harmony 鸿蒙获取应用异常退出原因

harmony 鸿蒙UIAbility备份恢复

harmony 鸿蒙使用显式Want启动应用组件

harmony 鸿蒙Ability Kit简介

harmony 鸿蒙AbilityStage组件容器

harmony 鸿蒙访问DataAbility

harmony 鸿蒙FA模型访问Stage模型DataShareExtensionAbility

harmony 鸿蒙常见action与entities（不推荐使用）

harmony 鸿蒙API切换概述

  • 所属分类： 后端技术
  • 本文标签： 鸿蒙 软件
  • 版权声明： 本文链接 https://seaxiang.com/blog/F2c2E2