HarmonyOS NEXT 地图服务中‘我的位置’功能全解析

news2024/11/15 23:55:29

1 前言

“我的位置”功能在表象上或许给人以简单之感，但从专业角度深入剖析，其蕴含着极为可观的信息量与巨大潜力。此功能绝非仅仅局限于作为一个单纯显示用户当前所处地点的标识，而确切地说是连接用户与周边世界、实现个性化服务的关键纽带。无论是在日常出行导航领域，还是社交互动方面；无论是便捷的生活服务范畴，还是丰富的旅游体验场景，“我的位置”在各个领域的应用程序中均发挥着至关重要的专业作用。其背后所涉及的技术原理、丰富的应用场景以及对用户生活产生的深远影响，均值得专业人士进行深入探讨与研究。

2 不同类型应用中的使用场景

2.1 导航类应用

  • 精准路线规划：用户输入目的地，应用以 “我的位置” 为依据生成最优路线并实时导航，随用户位置变化更新路线，确保高效准确抵达。例如，以为商务人士在陌生城市出差，通过导航应用的”我的位置“功能，快速找到前往会议地点的最佳路线，避免因不熟悉路况而导致迟到。
  • 高效周边搜索：借助 “我的位置” 提供周边兴趣点搜索，如加油站、餐厅、酒店等，用户可根据需求检索并查看评价和距离信息。比如，一位自驾游爱好者在旅途中，通过导航应用搜索附近的加油站和特色餐厅，为行程提供便利。
  • 实时交通信息呈现：结合实时交通信息，以 “我的位置” 为基点推荐最佳路线，遇拥堵自动规划避堵路线。例如，在上下班高峰期，上班族可以通过导航应用选择最顺畅的路线，减少通勤时间。

2.2 社交类应用

  • 便捷位置分享：用户可通过 “我的位置” 分享位置给好友，也能查看好友位置，方便聚会约会安排。例如，一群朋友计划聚会，通过社交应用的位置分享功能，大家可以快速确定集合地点，提高聚会的效率。
  • 附近的人推荐：比如，一位新到一个城市的年轻人，通过社交应用的“附近的人”功能，认识了一些志同道合的朋友，丰富了自己的社交生活。
  • 个性化活动推荐：比如，一位音乐爱好者通过社交应用得知附近有一场自己喜欢乐队的演唱会，于是购买了门票，享受了一场精彩的音乐盛宴。

2.3 生活服务类应用

  • 外卖精准配送：“我的位置” 确定送餐地址，用户可实时查看外卖小哥位置掌握配送进度。例如，一位忙碌的上班族在办公室点外卖，通过外卖应用的 “我的位置” 功能，确保外卖能够及时送到自己手中，不影响工作进度。
  • 打车高效服务：确定上车地点，方便司机找到用户，用户也能查看司机位置了解行驶进度。比如，一位在机场的旅客，通过打车应用的 “我的位置” 功能，快速叫到车，顺利到达目的地。
  • 快递智能查询：用于查询快递配送进度和当前位置，用户可随时了解快递是否送达附近以便收件。例如，一位网购爱好者通过快递应用的 “我的位置” 功能，实时跟踪自己的包裹，合理安排收件时间。

2.4 旅游类应用

  • 个性化景点推荐：根据 “我的位置” 推荐附近景点和旅游线路，用户依兴趣选择参观丰富旅游体验。例如，一位游客在一个陌生的城市旅游，通过旅游应用的 “我的位置” 功能，发现了一些小众但非常有特色的景点，为旅行增添了不少乐趣。
  • 智能导游服务：依据 “我的位置” 提供实时导游讲解和景点介绍，让用户深入了解历史文化背景知识。比如，一位历史爱好者在参观古迹时，通过旅游应用的智能导游功能，了解到了古迹的详细历史和文化内涵，加深了对历史的认识。
  • 定制旅游攻略：根据 “我的位置” 为用户提供个性化旅游攻略，用户可依时间和兴趣制定专属计划。例如，一位自由行游客通过旅游应用的 “我的位置” 功能，制定了一份适合自己的旅游攻略，充分享受了旅行的乐趣。

当然，“我的位置” 这项功能的应用绝不仅仅局限于上文所提及的那些场景。实际上，它在更多的领域中同样能够发挥出至关重要的作用。比如在救援行动中，当人们遭遇紧急情况时，准确的 “我的位置” 信息可以迅速传递给救援人员，使得救援行动能够更加高效地展开。无论是在山区的迷路救援、海上的遇险救助，还是城市中的突发事件应对，“我的位置” 都能成为连接受困者与救援力量的关键纽带，为生命的救援争取宝贵的时间。它如同黑暗中的一盏明灯，为处于困境中的人们指引着希望的方向，让救援行动更加精准、及时、有效。

3 前期准备

3.1 配置Client ID

实际应用开发中，当你打算使用地图服务（Map Kit）时，首先需要在AppGallery Connect平台上创建相应的应用。在创建完成后，要准确地获取“项目设置 > 常规 > 应用”的Client ID，这里需要特别注意的是，一定不能获取项目的Client ID，两者有着明确的区分。获取正确的Client ID之后，接下来要在工程entry模块的module.json5文件中进行特定的操作。具体而言，就是要在这个文件中新增metadata，将其配置为name属性设置为client_id，value属性为获取到的Client ID值。

在这里插入图片描述

{
  "module": {
    ...
    "metadata": [
      {
        "name": "client_id",
        "value": "xxxxxx"
      }
    ]
  }
}

3.2 开通地图服务

当完成Client ID的配置工作后，接下来还需要在AppGallery Connect平台该应用的“项目设置 > API管理”板块中打开地图服务开关。

在这里插入图片描述

3.3 添加公钥指纹

除了满足以上两个条件，还需要为应用添加公钥指纹，才能够确保地图服务（Map Kit）在应用中正常使用和发挥其强大的功能。

  • 在DevEco Studio中使用自动签名，对应用进行签名。

在这里插入图片描述

  • 在AppGallery Connect平台“项目设置 > 常规 > 应用”下的SHA256证书/公钥指纹中添加公钥指纹，勾选证书名称为auto_debug_xxxx的证书。

在这里插入图片描述

在这里插入图片描述

4 开发步骤

目前有两种方式可用于在地图上显示我的位置。推荐采用安全控件LocationButton方式，此方式能够临时获取精准定位权限，无需进行权限弹框授权确认。另一种方式则是申请授权方式，该方式需要动态向用申请设备位置信息ohos.permission.LOCATION和设备模糊位置信息ohos.permission.APPROXIMATELY_LOCATION两个权限。

4.1 使用安全控件方式

安全控件是一种可融入应用页面，实现用户点击自动授权，而无需弹窗授权。相较于动态申请权限方式，安全控件可基于场景化授权，简化开发者和用户的操作，优点如下：

  • 用户可掌握授权时机，授权范围最小化。
  • 授权场景可匹配用户真实意图。
  • 减少弹窗打扰。
  • 开发者不必向应用市场申请权限，简化操作。

位置控件（LocationButton）是目前系统提供的安全控件之一，该控件对应精准定位特权。应用集成位置控件后，用户点击该控件，无论应用是否申请过或者被授予精准定位权限，都会在本次前台期间获得精准定位的授权，可以调用位置服务获取精准定位。

使用LocationButton可使用默认创建带有图标、文本、背景的位置按钮，也可以通过创建指定LicationButtonOptions元素的位置按钮。

// 默认创建带有图标、文本、背景的位置按钮
LocationButton()

// 创建包含指定元素的位置按钮
LocationButton(option: LocationButtonOptions)

/**
 * 指定元素的位置按钮
 */
declare interface LocationButtonOptions {
    /**
     * 设置位置按钮的图标风格。
     * 不传入该参数表示没有图标，icon和text至少存在一个。
     * LocationIconStyle.FULL_FILLED	填充样式图标
     * LocationIconStyle.LINES	线条样式图标
     */
    icon?: LocationIconStyle;
    /**
     * 设置位置按钮的文本描述。
     * 不传入该参数表示没有文字描述，icon和text至少存在一个。
     * LocationDescription.CURRENT_LOCATION	当前位置
     * LocationDescription.ADD_LOCATION	添加位置
     * LocationDescription.SELECT_LOCATION	选择位置
     * LocationDescription.SHARE_LOCATION	共享位置
     * LocationDescription.SEND_LOCATION	发送位置
     * LocationDescription.LOCATING	定位
     * LocationDescription.LOCATION 位置
     * LocationDescription.SEND_CURRENT_LOCATION	发送实时位置
     * LocationDescription.RELOCATION	重定位
     * LocationDescription.PUNCH_IN	大卡定位
     * LocationDescription.CURRENT_POSITION	所在位置
     */
    text?: LocationDescription;
    /**
     * 设置位置按钮的背景样式。
     * 不传入该参数，系统默认提供Capsule类型按钮。
     * ButtonType.Capsule	胶囊型按钮
     * ButtonType.Circle	圆形按钮
     * ButtonType.Normal	普通按钮
     */
    buttonType?: ButtonType;
}

LocationButton组件不支持通用属性，仅支持安全控件通用属性，如设置安全控件上图标尺寸iconSize()；设置安全控件上图标和文字分布的方向layoutDirection()；设置绝对定位，设置安全控件的左上角相对于父容器左上角的便宜位置position()；设置安全控件相对于自身布局位置的坐标偏移offset()等，具体可参见安全控件通用属性。

LocationButton组件不支持通用事件，仅支持onClick(event: (event: ClickEvent, result: LocationButtonOnClickResult) => void)事件。

/**
 * 位置权限的授权结果
 */
declare enum LocationButtonOnClickResult {
    /**
     * 位置按钮点击后授权成功。
     */
    SUCCESS = 0,
    /**
     * 位置按钮点击后位置权限授权失败。
     */
    TEMPORARY_AUTHORIZATION_FAILED = 1
}

使用安全控件LocationButton可以在点击安全控件后，开启“我的位置”功能。

LocationButton()
  .onClick((event: ClickEvent, result: LocationButtonOnClickResult) => {
    console.log(`[LearningMapKit]位置权限的授权结果：${result}`);
    this.myLocationBtnStatus = true;
    // 启用我的位置图层
    this.mapController?.setMyLocationEnabled(true);
    // 启用我的位置按钮
    this.mapController?.setMyLocationControlsEnabled(true);
  })

在这里插入图片描述

4.2 使用用户授权方式

使用用户授权方式，需要先申请ohos.permission.LOCATION和ohos.permission.APPROXIMATELY_LOCATION

权限。

步骤一：声明权限

{
  "module": {
    ...
    "requestPermissions": [
      { "name": "ohos.permission.INTERNET" },
      {
        "name": "ohos.permission.LOCATION",	// 允许应用在前台运行时获取位置信息
        "reason": "$string:location_permission",	// 在/resources/base/element/string.json中定义
        "usedScene": {
          "abilities": ["EntryAbility"],
          "when": "inuse"
        }
      },
      {
        "name": "ohos.permission.APPROXIMATELY_LOCATION",	// 允许应用获取设备模糊位置信息
        "reason": "$string:location_permission",
        "usedScene": {
          "abilities": ["EntryAbility"],
          "when": "inuse"
        }
      }
    ]
  }
}

步骤二：动态申请权限

我在《HarmonyOS 应用程序访问控制探究》一文中对权限控制进行了详尽的阐述。你可以参考该篇文章来实现向用户动态申请权限的操作。授权后，还需要调用MapComponentController地图操作类的setMyLocationEnabled()方法启用我的位置图层，以及setMyLocationControlsEnabled()方法启用我的位置按钮。

// 校验是否被授予定位权限
let flag: boolean = false;
for (const permission of this.locationPermissions) {
  flag = false;
  const grantStatus: abilityAccessCtrl.GrantStatus = PermissionUtil.checkPermissionGrant(permission);
  if (grantStatus === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
    // 启用我的位置图层
    this.mapController?.setMyLocationEnabled(true);
    // 启用我的位置按钮
    this.mapController?.setMyLocationControlsEnabled(true);
    flag = true;
  }
}
if (!flag) {  // 未授权，则弹出授权提示弹窗
  const authResults: number[] = await PermissionUtil.reqPermissionFromUser(this.locationPermissions);
  for (let i = 0; i < authResults.length; i++) {
    if (authResults[i] === 0) {
      // 启用我的位置图层
      this.mapController?.setMyLocationEnabled(true);
    }
  }
}

在这里插入图片描述

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/2071928.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

operlayers-初始化地图-天地图初始化地图

operlayers-初始化地图-天地图初始化地图

今天分享一篇初始化operlayers的文章&#xff0c;算上一篇笔记吧&#xff0c;以后再有项目时直接看笔记回省好多事&#xff0c;也帮网上的兄弟们避避雷。 前言 这个项目是vue3operlayers开发的一个有关地名地址的小插件&#xff0c;具体服务就不展示了。 之所以用天地图来加…
阅读更多...
CMake构建学习笔记3-libpng库的构建

CMake构建学习笔记3-libpng库的构建

libpng是一个用于读取、写入 PNG (Portable Network Graphics) 文件格式的开源软件库&#xff0c;有了上一篇笔记作为基础&#xff0c;构建起来也非常简单。还是在源代码的根目录中创建一个build文件夹&#xff0c;执行如下关键指令&#xff1a; # 配置CMake cmake .. -G &q…
阅读更多...
86.游戏改造-UI修正暴力分析

86.游戏改造-UI修正暴力分析

免责声明&#xff1a;内容仅供学习参考&#xff0c;请合法利用知识&#xff0c;禁止进行违法犯罪活动&#xff01; 内容参考于&#xff1a;易道云信息技术研究院 上一个内容&#xff1a;85.游戏改造-修改UI分辨率&#xff0c;面向对象方式 85.游戏改造-修改UI分辨率&#xff…
阅读更多...
【Material-UI】深入了解Radio Group中的useRadioGroup Hook

【Material-UI】深入了解Radio Group中的useRadioGroup Hook

文章目录 一、什么是useRadioGroup&#xff1f;1.1 Hook的返回值 二、useRadioGroup的基本用法2.1 代码示例2.2 代码解析 三、useRadioGroup的应用场景3.1 动态样式调整3.2 高级交互逻辑 四、使用useRadioGroup的最佳实践4.1 保持代码简洁4.2 结合主题定制4.3 注意无障碍设计 五…
阅读更多...
通过Python绘制不同数据类型适合的可视化图表

通过Python绘制不同数据类型适合的可视化图表

在数据可视化中&#xff0c;对于描述数值变量与数值变量之间的关系常见的有散点图和热力图&#xff0c;以及描述数值变量与分类变量之间的关系常见的有条形图&#xff0c;饼图和折线图&#xff0c;可以通过使用Python的matplotlib和seaborn库来绘制图表进行可视化表达&#xff…
阅读更多...
基于R语言进行AMMI分析2

基于R语言进行AMMI分析2

接续上文【基于R语言进行AMMI分析1】 1、AMMI()函数的结果解读 # 加载agricolae包 library(agricolae) # 加载数据 data(plrv) # 查看数据 head(plrv) model<-with(plrv,AMMI(Locality,Genotype,Rep,Yield,PCTRUE)) # 查看方差分析结果 model$ANOVA # 查看主成分的方差分析…
阅读更多...
AIGC综合应用-黑神话悟空cos写真制作方法（案例拆解）

AIGC综合应用-黑神话悟空cos写真制作方法（案例拆解）

​ 想要体验一下穿越到黑神话悟空的世界中&#xff0c;亲自上阵来一场cos写真拍摄&#xff1f; 其实&#xff0c;通过AI&#xff0c;这个愿望轻松实现&#xff01; 不需要复杂的设备和高超的技术&#xff0c;只要两步就能搞定&#xff1a;生成底图和换脸。 以下就带你一步步…
阅读更多...
Redis计数器：数字的秘密

Redis计数器：数字的秘密

文章目录 Redis计数器incr 指令用户计数统计用户统计信息查询缓存一致性 小结 技术派项目源码地址 : Gitee :技术派 - https://gitee.com/itwanger/paicodingGithub :技术派 - https://github.com/itwanger/paicoding 用户的相关统计信息 文章数&#xff0c;文章总阅读数&am…
阅读更多...
网络互联基础

网络互联基础

1. 集线器 与集线器相连的所有主机组成一个简单局域网LAN&#xff0c;都属于同一个冲突域&#xff0c;且属于同一个广播域。 2. 交换机 交换机连接的每个网段都是独立的冲突域&#xff0c;即交换机每个端口都是独立的冲突域。默认情况下&#xff0c;交换机对冲突域进行分割。…
阅读更多...
一道xss题目--intigriti-0422-XSS-Challenge-Write-up

一道xss题目--intigriti-0422-XSS-Challenge-Write-up

目录 进入挑战 js代码 代码分析 构造payload ​编辑 结果 进入挑战 Intigriti April Challenge题目地址 打开题目后&#xff0c;找到对应页面的js代码&#xff0c;寻找一下我们用户可控的点 js代码 <!DOCTYPE html> <html lang"en"><head> …
阅读更多...
阵列信号处理2_阵列信号最优处理常用准则（CSDN_20240825）

阵列信号处理2_阵列信号最优处理常用准则（CSDN_20240825）

目录 最小均方误差&#xff08;Minimum Square Error&#xff0c;MSE&#xff09;准则 最大信噪比&#xff08;Maximum Signal Noise Ratio&#xff0c;MSNR&#xff09;准则 极大似然&#xff08;Maximum Likehood, ML&#xff09;准则 最小方差无损响应&#xff08;Minim…
阅读更多...
移动应用平台，企业移动门户就选WorkPlus

移动应用平台，企业移动门户就选WorkPlus

随着移动设备的普及和移动办公的兴起&#xff0c;企业需要一个高效可靠的移动应用平台来加强内部沟通、协作和信息管理。在众多的移动应用平台中&#xff0c;WorkPlus作为一款专为企业打造的移动门户&#xff0c;凭借其稳定性、功能丰富和易用性成为了企业移动门户的首选。 一、…
阅读更多...
【LVGL-下拉列表部件 lv_dropdown】

【LVGL-下拉列表部件 lv_dropdown】

LVGL-下拉列表部件 lv_dropdown ■ LVGL-下拉列表部件 lv_dropdown■ 下拉列表部件的组成■ 添加选项■ 获取当前选中的选项■ 设置列表展开方向■ 设置下拉列表图标■ 设置列表常显文本■ 打开、开闭下拉列表■ 下拉列表部件的 API 函数 ■ LVGL-下拉列表部件 lv_dropdown ■ …
阅读更多...
STM32学习记录-05 -3-TIM输入捕获

STM32学习记录-05 -3-TIM输入捕获

1 输入捕获简介 IC&#xff08;Input Capture&#xff09;输入捕获 输入捕获模式下&#xff0c;当通道输入引脚出现指定电平跳变时&#xff0c;当前CNT的值将被锁存到CCR中&#xff0c;可用于测量PWM波形的频率、占空比、脉冲间隔、电平持续时间等参数 每个高级定时器和通用…
阅读更多...
FME批处理：WorkspaceRunner转换器

FME批处理：WorkspaceRunner转换器

1、创建一个待处理工程 注意&#xff1a; Reader设置&#xff1a; Writer设置&#xff1a; 2、创建另外一个**批处理工程**&#xff0c;加入workspaceRunner并设置参数 workspaceRunner设置 directory and file pathnames设置
阅读更多...
认知杂谈23

认知杂谈23

今天分享 有人说的一段争议性的话 I I 《忙碌不停&#xff0c;成长迷失》 现代生活啊&#xff0c;就跟一场一直转个不停的旋转木马似的。你每天都被各种小事儿缠得死死的&#xff0c;从大清早一睁开眼&#xff0c;一直到晚上要睡觉了&#xff0c;几乎就找不到一点能停下来喘…
阅读更多...
BC156 牛牛的数组匹配（c语言）

BC156 牛牛的数组匹配（c语言）

1./描述 //牛牛刚学会数组不久&#xff0c;他拿到两个数组 a 和 b&#xff0c;询问 b 的哪一段连续子数组之和与数组 a 之和最接近。 //如果有多个子数组之和同样接近&#xff0c;输出起始点最靠左的数组。 //输入描述&#xff1a; //第一行输入两个正整数 n 和 m &#xff0c;…
阅读更多...
NLP从零开始------12. 关于前十一章补充（英文分词）

NLP从零开始------12. 关于前十一章补充（英文分词）

相较于基础篇章&#xff0c;这一部分相较于基础篇减少了很多算法推导&#xff0c;多了很多代码实现。 1.英文词规范化 英文词规范化一般分为标准化缩写,大小写相互转化&#xff0c;动词目态转化等。 1.1 大小写折叠 大小写折叠( casefolding) 是将所有的英文大写字母转化成小…
阅读更多...
开发高质量PDF应用的不二选择：PdfiumViewer库详细解析

开发高质量PDF应用的不二选择：PdfiumViewer库详细解析

1. PdfiumViewer库简介 PdfiumViewer是一款基于谷歌开源PDF渲染引擎PDFium的.NET库&#xff0c;主要用于在Windows应用程序中显示和处理PDF文档。PdfiumViewer提供了多种API和控件&#xff0c;使得开发者可以轻松地将PDF文档嵌入到其应用程序中。同时&#xff0c;PdfiumViewer…
阅读更多...
利用 OCR 和强大的 GPT-4o 迷你模型对收据进行信息提取

利用 OCR 和强大的 GPT-4o 迷你模型对收据进行信息提取

在本文中&#xff0c;我将向您展示如何从收据中提取信息&#xff0c;并提供收据的简单图像。首先&#xff0c;我们将利用 OCR 从收据中提取信息。然后&#xff0c;此信息将发送到 GPT-4o 迷你模型进行信息提取。我在这个项目中的目标是开发一个应用程序&#xff0c;只需拍摄收据…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023