【HarmonyOS 6】地图操作系列-标记详解（Marker）

简介

标记（Marker）的作用是用来对地图指定位置进行标记标识，或者展示地图相关信息。Marker中封装了大量的触发事件，例如点击事件（on(‘markerClick’)）、拖拽事件（on(‘markerDrag’)），方便我们实现各种用户交互。这篇文章不会讲解怎样子申请权限和开通AGC地图权限等，如果有需要，可以查阅之前发布的相关文章。 对于讲述过程的代码是独立出来的，可能会存在不完整性，在文章的末尾会贴上所有的代码。

这篇文章主要讲解怎样子生成标记和标记的一些用法。

所需权限

初始代码

初始界面和相关的辅助类代码。

MarkerPage

import { MarkerViewModel } from '../ViewModels/MarkerViewModel'
import { MapComponent } from '@kit.MapKit'

@Entry
@ComponentV2
struct MarkerPage {
  @Local VM: MarkerViewModel = new MarkerViewModel()

  aboutToAppear(): void {
    this.VM.Init(this.getUIContext())
  }

  build() {
    Column() {
      MapComponent({
        mapOptions: this.VM.MapOption,
        mapCallback: this.VM.MapCallBack
      })
        .width("100%")
        .height("50%")
    }
    .height('100%')
    .width('100%')
  }
}

MarkerViewModel

import { map, mapCommon } from "@kit.MapKit"
import { AsyncCallback } from "@kit.BasicServicesKit"
import { geoLocationManager } from "@kit.LocationKit"
import { Permissions } from "@kit.AbilityKit"
import { PermissionUtils } from "../Utils/PermissionUtils"

@ObservedV2
export class MarkerViewModel {
  /**
   * 地图初始化参数设置
   */
  MapOption?: mapCommon.MapOptions
  /**
   * 地图回调方法
   */
  MapCallBack?: AsyncCallback<map.MapComponentController>
  /**
   * 地图控制器
   */
  MapController?: map.MapComponentController
  /**
   * 地图监听管理器
   */
  MapEventManager?: map.MapEventManager
  /**
   * 所需要得权限
   */
  MapPermissions: Permissions[] =
    [
      'ohos.permission.INTERNET',
      'ohos.permission.LOCATION',
      'ohos.permission.APPROXIMATELY_LOCATION'
    ]
  /**
   * 当前位置的维度
   */
  @Trace LocationLatitude: number = 39.9;
  /**
   * 当前位置的经度
   */
  @Trace LocationLongitude: number = 116.4;
  MyUIContext?: UIContext

  constructor() {
    this.UpdateLocation()
    this.MapOption = {
      //相机位置
      position: {
        target: {
          latitude: this.LocationLatitude,
          longitude: this.LocationLongitude
        },
        zoom: 15
      },
      //地图类型
      mapType: mapCommon.MapType.STANDARD,
      //地图最小图层,默认值为2
      minZoom: 2,
      //地图最大图层,默认值为20
      maxZoom: 20,
      //是否支持旋转手势
      rotateGesturesEnabled: true,
      //是否支持滑动手势
      scrollGesturesEnabled: true,
      //是否支持缩放手势
      zoomGesturesEnabled: true,
      //是否支持倾斜手势
      tiltGesturesEnabled: true,
      //是否展示缩放控件
      zoomControlsEnabled: true,
      //是否展示定位按钮
      myLocationControlsEnabled: true,
      //是否展示指南针控件
      compassControlsEnabled: false,
      //是否展示比例尺
      scaleControlsEnabled: true,
      //是否一直显示比例尺，只有比例尺启用时该参数才生效。
      alwaysShowScaleEnabled: true
    };
    this.MapCallBack = async (err, mapController) => {
      if (!err) {
        this.MapController = mapController;
        //启用我的位置图层
        mapController.setMyLocationEnabled(true);
        //设置我的位置跟随设备移动
        mapController.setMyLocationStyle({
          displayType: mapCommon.MyLocationDisplayType.LOCATE
        })
        //启用我的位置按钮
        mapController.setMyLocationControlsEnabled(true);
        //地图监听时间管理器
        this.MapEventManager = this.MapController.getEventManager();
      }
    }
  }

  public async Init(uiContext: UIContext) {
    this.MyUIContext = uiContext;
    //识别权限是否赋予
    if (!PermissionUtils.CheckPermissions(this.MapPermissions)) {
      const perResult: boolean = await PermissionUtils.RequestPermissions(this.MapPermissions);
      if (!perResult) {
        console.error("用户未授权");
        return;
      }
    }
  }

  /**
   * 更新用户定位
   */
  public async UpdateLocation() {
    // 获取用户位置坐标
    try {
      let location: geoLocationManager.Location = await geoLocationManager.getCurrentLocation();
      const convertPoint = map.convertCoordinateSync(mapCommon.CoordinateType.WGS84,
        mapCommon.CoordinateType.GCJ02, {
          longitude: location.longitude,
          latitude: location.latitude
        });
      this.LocationLongitude = convertPoint.longitude;
      this.LocationLatitude = convertPoint.latitude;
    } catch (error) {
      console.error("更新用户坐标出错");
    }
  }
}

PermissionUtils

import { abilityAccessCtrl, bundleManager, common, Permissions } from '@kit.AbilityKit';

/**
 *权限封装类
 */
export class PermissionUtils {
  /**
   * 检查权限是否授权(完全授权)
   * @param permissionsArr 权限集合
   * @returns true：已经全部授权；false：没有全部授权
   */
  public static CheckPermissions(permissionsArr: Permissions[]): boolean {
    const atManager = abilityAccessCtrl.createAtManager();
    //获取bundle信息
    const bundleInfo =
      bundleManager.getBundleInfoForSelfSync(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION);
    // 拿到当前应用的tokenID 标识
    const tokenID = bundleInfo.appInfo.accessTokenId
    //校验应用是否被授予权限
    let result: boolean = true;
    permissionsArr.forEach((x: Permissions, index: number) => {
      if (!(atManager.checkAccessTokenSync(tokenID, x) === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED)) {
        result = false;
        return;
      }
    })
    return result;
  }

  /**
   * 申请授权（首次弹窗申请）
   * @param permissionList 权限集合
   * @returns true：权限完全加载；false：有权限没有加载
   */
  public static async RequestPermissions(permissionList: Permissions[]): Promise<boolean> {
    // 程序访问控制管理
    const atManager = abilityAccessCtrl.createAtManager();
    // 拉起弹框请求用户授权
    const grantStatus = await atManager.requestPermissionsFromUser(getContext(), permissionList)
    // 获取请求权限的结果
    const isAuth = grantStatus.authResults.every(v => v === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED)
    // 返回 Promise 授权结果
    return isAuth ? Promise.resolve(true) : Promise.reject(false)
  }

  /**
   * 打开系统设置的权限管理页面
   */
  public static OpenPermissionSettingsPage() {
    // 获取上下文
    const context = getContext() as common.UIAbilityContext
    // 获取包信息
    const bundleInfo = bundleManager.getBundleInfoForSelfSync(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION)
    // 打开系统设置页
    context.startAbility({
      bundleName: 'com.huawei.hmos.settings',
      abilityName: 'com.huawei.hmos.settings.MainAbility',
      uri: 'application_info_entry',
      parameters: {
        // 按照包名打开对应设置页
        pushParams: bundleInfo.name
      }
    })
  }
}

页面

根据上面的初始化方法，应该展示出如下页面：

如果没有展示当前页面的，需要排查项目的签名等配置是否正确，权限是否已经开启。

Maker

常用方法

获取标记属性方法

设置标记属性方法

方法	输入参数类型	备注
setAlpha	number	设置标记的透明度属性。
setClickable	boolean	设置标记是否可以点击
setDraggable	boolean	设置标记是否可以长按拖拽。
setFlat	boolean	设置标记是否平贴地图。
setIcon	string | image.PixelMap | Resource	设置标记的图标。 图片格式支持jpg、jpeg、png、gif、webp、svg。 资源相对路径格式：图标存放在resources/rawfile，icon参数传入rawfile文件夹下的相对路径。 toDataURL格式（如data:image/png;base64,<图片的Base64字节编码值>）
setMarkerAnchor	anchorU: number, anchorV: number	设置标记的锚点位置。 锚点是标记图标接触地图平面的点，图标的左顶点为（0, 0）点，右顶点为（1, 0）点，左底点为（0, 1）点，右底点为（1, 1）点.
setPosition	mapCommon.LatLng	设置标记的位置坐标。
setRotation	number	设置标记的旋转角度，即标记围绕标记锚点顺时针旋转的角度，旋转轴垂直于标记。 默认旋转角度为0，默认位置为北对齐。
setTitle	string	设置信息窗的标题。
setSnippet	string	设置信息窗口的子标题。
setInfoWindowAnchor	anchorU: number, anchorV: number	设置信息窗的锚点位置,取值范围：[0, 1]，坐标轴和锚点位置一样。
setInfoWindowVisible	boolean	设置信息窗是否可见。 true:可见; flase:不可见
setAnimation	Animation	设置标记的动画
startAnimation		启动标记的动画。
clearAnimation		清除标记的动画。
setAltitude	number	设置海拔高度。
setAnnotationVisible	boolean	设置标记是否显示文本。
setIconBuilder	CustomBuilder	设置生成标记图标的自定义组件。

创建Maker

通过map.MapComponentController的addMarker方法，并传入MarkerOptions对象为参数，在地图上添加一个标记。

标记（Marker）参数（MarkerOptions）

添加一个标记（Marker）代码

 /**
   * 在当前位置添加一个标记
   * @param point
   */
  public async CreateLocationMarker() {
    if (this.MapController) {
      // Marker初始化参数
      let markerOptions: mapCommon.MarkerOptions = {
        //定位点
        position: {
          latitude: this.LocationLatitude,
          longitude: this.LocationLongitude
        }
      };
      try {
        let marker: map.Marker = await this.MapController.addMarker(markerOptions);
      } catch (error) {
        console.error(error)
      }
    }
  }

创建一个自定义样式的标记

需求：

使用sceneMap.chooseLocation选择地点

自定义LocationUtil类和SelectLocationPoint方法，弹出页面并提供位置搜索按钮，方便搜索想要的位置。

public static async SelectLocationPoint(uiContext: common.UIAbilityContext,
    originLocationPoint: mapCommon.LatLng): Promise<mapCommon.LatLng | undefined> {
    try {
      let locationChoosingOptions: sceneMap.LocationChoosingOptions = {
        // 地图中心点坐标
        location: originLocationPoint,
        language: 'zh_cn',
        // 展示搜索控件
        searchEnabled: true,
        // 展示附近Poi
        showNearbyPoi: true
      };
      // 拉起地点选取页
      let result: sceneMap.LocationChoosingResult =
        await sceneMap.chooseLocation(uiContext, locationChoosingOptions);
      if (result) {
        return result.location;
      }
      return undefined;
    } catch (e) {
      console.error(`地点选择错误，错误代码：${e}`);
      return undefined;
    }
  }

自定义标记Builder方法

自定一张照片和下标，这里的内容可以自定义哈。但是存在一个问题，值引用时，修改数值时UI无法刷新，需要时间去研究引用的方式，但是我们的标点并不多，每次更新可以直接删除对应的标点重新创建。如果有解决方案的小伙伴也欢迎留言交流哈。

aboutToAppear(): void {
    this.VM.Init(this.getUIContext(), () => {
      this.MyMarkerBuilder(this.VM.MarkerList.length);
    })
  }


@Builder
  MyMarkerBuilder(index: number) {
    RelativeContainer() {
      Image($r('app.media.app_icon'))
        .width(30)
        .height(30)
        .syncLoad(true)
      Text(`${index}`)
        .fontSize(10)
        .width(15)
        .textAlign(TextAlign.Center)
        .height(15)
        .backgroundColor($r('app.color.Main_Color'))
        .borderRadius(7.5)
        .alignRules({
          bottom: { anchor: "__container__", align: VerticalAlign.Bottom },
          right: { anchor: "__container__", align: HorizontalAlign.End }
        })
    }
    .width(30)
    .height(30)
  }

MarkerViewModel.ets

通过CustomBuilder对象的方式传递，并修改选择地点生成标记的方法

  /**
   * 标记builder
   */
  @Trace MarkerBuilder?: CustomBuilder
  
    /**
   * 标记集合
   */
  @Trace MarkerList: map.Marker[] = []
  
  public async Init(uiContext: UIContext, markerBuilder: CustomBuilder) {
    this.MyUIContext = uiContext;
    this.MarkerBuilder = markerBuilder;
    //识别权限是否赋予
    if (!PermissionUtils.CheckPermissions(this.MapPermissions)) {
      const perResult: boolean = await PermissionUtils.RequestPermissions(this.MapPermissions);
      if (!perResult) {
        console.error("用户未授权");
        return;
      }
    }
  }
  
  /**
   * 选择地点，并生成标记
   */
  public async SelectedLocationCreateMarker() {
    if (this.MyUIContext && this.MapController) {
      let selectResult =
        await LocationUtil.SelectLocationPoint(this.MyUIContext.getHostContext() as common.UIAbilityContext, {
          latitude: this.LocationLatitude,
          longitude: this.LocationLongitude
        })
      if (selectResult) {
        // Marker初始化参数
        let markerOptions: mapCommon.MarkerOptions = {
          //定位点
          position: selectResult,
          iconBuilder: this.MarkerBuilder
        };
        try {
          let marker: map.Marker = await this.MapController.addMarker(markerOptions);
          this.MarkerList.push(marker);
        } catch (error) {
          console.error(error)
        }
      }
    }
  }

点击标记，地图的视图聚焦到标记

代码实现

使用map.MapEventManager对象监听标记点击事件，建议可以在一开始的时候直接注入监听

this.MapEventManager.on("markerClick", (marker: map.Marker) => {
          this.MarkerClickCallBack(marker);
        });
        
        
  /**
   * 标记点击事件
   * @param marker
   */
  public async MarkerClickCallBack(marker: map.Marker) {
    let locationPoint: mapCommon.LatLng = marker.getPosition();
    this.MoveCamera(locationPoint.latitude, locationPoint.longitude);
  }

  /**
   * 移动视图相机
   * @param latitude 维度
   * @param longitude 经度
   */
  public async MoveCamera(latitude: number, longitude: number) {
    if (this.MapController) {
      //将视图移动到标点位置
      let nwPosition = map.newCameraPosition({
        target: {
          latitude: latitude,
          longitude: longitude
        },
        zoom: 18
      })
      // 以动画方式移动地图相机
      this.MapController.animateCamera(nwPosition, 1000);
    }
  }

效果展示

自定义标记完整代码

MarkerPage.ets

import { MarkerViewModel } from '../ViewModels/MarkerViewModel'
import { MapComponent } from '@kit.MapKit'

@Entry
@ComponentV2
struct MarkerPage {
  @Local VM: MarkerViewModel = new MarkerViewModel()

  aboutToAppear(): void {
    this.VM.Init(this.getUIContext(), () => {
      this.MyMarkerBuilder(this.VM.MarkerList.length);
    })
  }

  build() {
    Column({ space: 10 }) {
      MapComponent({
        mapOptions: this.VM.MapOption,
        mapCallback: this.VM.MapCallBack
      })
        .width("100%")
        .height("50%")
      Button("创建一个标记")
        .onClick((event: ClickEvent) => {
          this.VM.CreateLocationMarker()
        })
      Button("选择地点创建标记")
        .onClick((event: ClickEvent) => {
          this.VM.SelectedLocationCreateMarker()
        })
    }
    .height('100%')
    .width('100%')
  }

  @Builder
  MyMarkerBuilder(index: number) {
    RelativeContainer() {
      Image($r('app.media.app_icon'))
        .width(30)
        .height(30)
        .syncLoad(true)
      Text(`${index}`)
        .fontSize(10)
        .width(15)
        .textAlign(TextAlign.Center)
        .height(15)
        .backgroundColor($r('app.color.Main_Color'))
        .borderRadius(7.5)
        .alignRules({
          bottom: { anchor: "__container__", align: VerticalAlign.Bottom },
          right: { anchor: "__container__", align: HorizontalAlign.End }
        })
    }
    .width(30)
    .height(30)
  }
}

MarkerViewModel.ets

import { map, mapCommon } from "@kit.MapKit"
import { AsyncCallback } from "@kit.BasicServicesKit"
import { geoLocationManager } from "@kit.LocationKit"
import { common, Permissions } from "@kit.AbilityKit"
import { PermissionUtils } from "../Utils/PermissionUtils"
import { LocationUtil } from "../Utils/LocationUtil"

@ObservedV2
export class MarkerViewModel {
  /**
   * 地图初始化参数设置
   */
  MapOption?: mapCommon.MapOptions
  /**
   * 地图回调方法
   */
  MapCallBack?: AsyncCallback<map.MapComponentController>
  /**
   * 地图控制器
   */
  MapController?: map.MapComponentController
  /**
   * 地图监听管理器
   */
  MapEventManager?: map.MapEventManager
  /**
   * 所需要得权限
   */
  MapPermissions: Permissions[] =
    [
      'ohos.permission.INTERNET',
      'ohos.permission.LOCATION',
      'ohos.permission.APPROXIMATELY_LOCATION'
    ]
  /**
   * 当前位置的维度
   */
  @Trace LocationLatitude: number = 39.9;
  /**
   * 当前位置的经度
   */
  @Trace LocationLongitude: number = 116.4;
  MyUIContext?: UIContext
  /**
   * 标记builder
   */
  @Trace MarkerBuilder?: CustomBuilder
  /**
   * 标记集合
   */
  @Trace MarkerList: map.Marker[] = []

  constructor() {
    this.UpdateLocation()
    this.MapOption = {
      //相机位置
      position: {
        target: {
          latitude: this.LocationLatitude,
          longitude: this.LocationLongitude
        },
        zoom: 15
      },
      //地图类型
      mapType: mapCommon.MapType.STANDARD,
      //地图最小图层,默认值为2
      minZoom: 2,
      //地图最大图层,默认值为20
      maxZoom: 20,
      //是否支持旋转手势
      rotateGesturesEnabled: true,
      //是否支持滑动手势
      scrollGesturesEnabled: true,
      //是否支持缩放手势
      zoomGesturesEnabled: true,
      //是否支持倾斜手势
      tiltGesturesEnabled: true,
      //是否展示缩放控件
      zoomControlsEnabled: true,
      //是否展示定位按钮
      myLocationControlsEnabled: true,
      //是否展示指南针控件
      compassControlsEnabled: false,
      //是否展示比例尺
      scaleControlsEnabled: true,
      //是否一直显示比例尺，只有比例尺启用时该参数才生效。
      alwaysShowScaleEnabled: true
    };
    this.MapCallBack = async (err, mapController) => {
      if (!err) {
        this.MapController = mapController;
        //启用我的位置图层
        mapController.setMyLocationEnabled(true);
        //设置我的位置跟随设备移动
        mapController.setMyLocationStyle({
          displayType: mapCommon.MyLocationDisplayType.LOCATE
        })
        //启用我的位置按钮
        mapController.setMyLocationControlsEnabled(true);
        //地图监听时间管理器
        this.MapEventManager = this.MapController.getEventManager();
        this.MapEventManager.on("markerClick", (marker: map.Marker) => {
          this.MarkerClickCallBack(marker);
        });
      }
    }
  }

  public async Init(uiContext: UIContext, markerBuilder: CustomBuilder) {
    this.MyUIContext = uiContext;
    this.MarkerBuilder = markerBuilder;
    //识别权限是否赋予
    if (!PermissionUtils.CheckPermissions(this.MapPermissions)) {
      const perResult: boolean = await PermissionUtils.RequestPermissions(this.MapPermissions);
      if (!perResult) {
        console.error("用户未授权");
        return;
      }
    }

  }

  /**
   * 更新用户定位
   */
  public async UpdateLocation() {
    // 获取用户位置坐标
    try {
      let location: geoLocationManager.Location = await geoLocationManager.getCurrentLocation();
      const convertPoint = map.convertCoordinateSync(mapCommon.CoordinateType.WGS84,
        mapCommon.CoordinateType.GCJ02, {
          longitude: location.longitude,
          latitude: location.latitude
        });
      this.LocationLongitude = convertPoint.longitude;
      this.LocationLatitude = convertPoint.latitude;
    } catch (error) {
      console.error("更新用户坐标出错");
    }
  }

  /**
   * 在当前位置添加一个标记
   * @param point
   */
  public async CreateLocationMarker() {
    if (this.MapController) {
      // Marker初始化参数
      let markerOptions: mapCommon.MarkerOptions = {
        //定位点
        position: {
          latitude: this.LocationLatitude,
          longitude: this.LocationLongitude
        },
        clickable: true
      };
      try {
        let marker: map.Marker = await this.MapController.addMarker(markerOptions);
      } catch (error) {
        console.error(error)
      }
    }
  }

  /**
   * 选择地点，并生成标记
   */
  public async SelectedLocationCreateMarker() {
    if (this.MyUIContext && this.MapController) {
      let selectResult =
        await LocationUtil.SelectLocationPoint(this.MyUIContext.getHostContext() as common.UIAbilityContext, {
          latitude: this.LocationLatitude,
          longitude: this.LocationLongitude
        })
      if (selectResult) {
        // Marker初始化参数
        let markerOptions: mapCommon.MarkerOptions = {
          //定位点
          position: selectResult,
          iconBuilder: this.MarkerBuilder,
          clickable: true
        };
        try {
          let marker: map.Marker = await this.MapController.addMarker(markerOptions);
          this.MarkerList.push(marker);
        } catch (error) {
          console.error(error)
        }
      }
    }
  }

  /**
   * 移动视图相机
   * @param latitude 维度
   * @param longitude 经度
   */
  public async MoveCamera(latitude: number, longitude: number) {
    if (this.MapController) {
      //将视图移动到标点位置
      let nwPosition = map.newCameraPosition({
        target: {
          latitude: latitude,
          longitude: longitude
        },
        zoom: 18
      })
      // 以动画方式移动地图相机
      this.MapController.animateCamera(nwPosition, 1000);
    }
  }

  /**
   * 标记点击事件
   * @param marker
   */
  public async MarkerClickCallBack(marker: map.Marker) {
    let locationPoint: mapCommon.LatLng = marker.getPosition();
    this.MoveCamera(locationPoint.latitude, locationPoint.longitude);
  }
}

PermissionUtils.ets

import { abilityAccessCtrl, bundleManager, common, Permissions } from '@kit.AbilityKit';

/**
 *权限封装类
 */
export class PermissionUtils {
  /**
   * 检查权限是否授权(完全授权)
   * @param permissionsArr 权限集合
   * @returns true：已经全部授权；false：没有全部授权
   */
  public static CheckPermissions(permissionsArr: Permissions[]): boolean {
    const atManager = abilityAccessCtrl.createAtManager();
    //获取bundle信息
    const bundleInfo =
      bundleManager.getBundleInfoForSelfSync(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION);
    // 拿到当前应用的tokenID 标识
    const tokenID = bundleInfo.appInfo.accessTokenId
    //校验应用是否被授予权限
    let result: boolean = true;
    permissionsArr.forEach((x: Permissions, index: number) => {
      if (!(atManager.checkAccessTokenSync(tokenID, x) === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED)) {
        result = false;
        return;
      }
    })
    return result;
  }

  /**
   * 申请授权（首次弹窗申请）
   * @param permissionList 权限集合
   * @returns true：权限完全加载；false：有权限没有加载
   */
  public static async RequestPermissions(permissionList: Permissions[]): Promise<boolean> {
    // 程序访问控制管理
    const atManager = abilityAccessCtrl.createAtManager();
    // 拉起弹框请求用户授权
    const grantStatus = await atManager.requestPermissionsFromUser(getContext(), permissionList)
    // 获取请求权限的结果
    const isAuth = grantStatus.authResults.every(v => v === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED)
    // 返回 Promise 授权结果
    return isAuth ? Promise.resolve(true) : Promise.reject(false)
  }

  /**
   * 打开系统设置的权限管理页面
   */
  public static OpenPermissionSettingsPage() {
    // 获取上下文
    const context = getContext() as common.UIAbilityContext
    // 获取包信息
    const bundleInfo = bundleManager.getBundleInfoForSelfSync(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION)
    // 打开系统设置页
    context.startAbility({
      bundleName: 'com.huawei.hmos.settings',
      abilityName: 'com.huawei.hmos.settings.MainAbility',
      uri: 'application_info_entry',
      parameters: {
        // 按照包名打开对应设置页
        pushParams: bundleInfo.name
      }
    })
  }
}

LocationUtil.ets

import { common, Permissions } from "@kit.AbilityKit";
import { geoLocationManager } from "@kit.LocationKit";
import { map, mapCommon, sceneMap } from "@kit.MapKit";

export class LocationUtil {
  /**
   * 当前位置的维度
   */
  public static LocationLatitude: number = 39.9;
  /**
   * 当前位置的经度
   */
  public static LocationLongitude: number = 116.4;
  /**
   * 所需要得权限
   */
  public static MapPermissions: Permissions[] =
    [
      'ohos.permission.INTERNET',
      'ohos.permission.LOCATION',
      'ohos.permission.APPROXIMATELY_LOCATION'
    ]

  /**
   * 更新用户定位
   */
  public static async UpdateLocation() {
    // 获取用户位置坐标
    let location: geoLocationManager.Location = await geoLocationManager.getCurrentLocation();
    const convertPoint = map.convertCoordinateSync(mapCommon.CoordinateType.WGS84,
      mapCommon.CoordinateType.GCJ02, {
        longitude: location.longitude,
        latitude: location.latitude
      });
    LocationUtil.LocationLongitude = convertPoint.longitude
    LocationUtil.LocationLatitude = convertPoint.latitude;
  }

  /**
   * 选择地图
   * @param uiContext
   * @returns
   */
  public static async SelectLocation(uiContext: common.UIAbilityContext): Promise<sceneMap.LocationChoosingResult | undefined> {
    try {
      await LocationUtil.UpdateLocation();
      let locationChoosingOptions: sceneMap.LocationChoosingOptions = {
        // 地图中心点坐标
        location: { latitude: LocationUtil.LocationLatitude, longitude: LocationUtil.LocationLongitude },
        language: 'zh_cn',
        // 展示搜索控件
        searchEnabled: true,
        // 展示附近Poi
        showNearbyPoi: true
      };
      // 拉起地点选取页
      let result: sceneMap.LocationChoosingResult =
        await sceneMap.chooseLocation(uiContext, locationChoosingOptions);
      return result;
    } catch (e) {
      console.info(e)
      return undefined;
    }

  }

  public static async SelectLocationPoint(uiContext: common.UIAbilityContext,
    originLocationPoint: mapCommon.LatLng): Promise<mapCommon.LatLng | undefined> {
    try {
      let locationChoosingOptions: sceneMap.LocationChoosingOptions = {
        // 地图中心点坐标
        location: originLocationPoint,
        language: 'zh_cn',
        // 展示搜索控件
        searchEnabled: true,
        // 展示附近Poi
        showNearbyPoi: true
      };
      // 拉起地点选取页
      let result: sceneMap.LocationChoosingResult =
        await sceneMap.chooseLocation(uiContext, locationChoosingOptions);
      if (result) {
        return result.location;
      }
      return undefined;
    } catch (e) {
      console.error(`地点选择错误，错误代码：${e}`);
      return undefined;
    }
  }
}