当前位置： 首页 > news >正文

鸿蒙技术干货8：地理位置获取全解析

news 2026/6/29 18:53:15

承接上一篇的通知服务，今天咱们进入系列第二篇 —— 地理位置服务（geoLocationManager）。地理位置是位置提醒 APP 的核心依赖，无论是获取用户当前位置，还是判断是否到达目标区域，都离不开它。这篇咱们从权限配置、定位初始化、经纬度获取到定位模式优化，一步步拆解实战代码，让你快速掌握鸿蒙地理位置服务的核心用法！

一、地理位置服务核心认知

1. 核心应用场景

  • 位置提醒（如到达目的地、离开指定区域）
  • 周边服务推荐（如附近的餐厅、加油站）
  • 轨迹记录（如运动轨迹、出行路线）
  • 定位导航（如步行、驾车导航）

2. 核心模块与权限要求

  • 核心模块：@ohos.geolocation（geoLocationManager）
  • 必备权限：
    • 模糊定位：ohos.permission.APPROXIMATELY_LOCATION（基础必备）
    • 精确定位：ohos.permission.LOCATION（可选，需搭配模糊定位）
    • 后台定位：ohos.permission.LOCATION_IN_BACKGROUND（后台持续定位需声明）
  • 定位模式：高精度（GNSS + 网络）、低功耗（仅网络）、设备仅（仅 GNSS）

二、地理位置开发四步走：权限 - 初始化 - 定位 - 解析

1. 权限配置与申请（合规核心）

先在module.json5中声明权限：

{ "module": { "requestPermissions": [ { "name": "ohos.permission.APPROXIMATELY_LOCATION", "reason": "用于获取大致位置，提供位置提醒服务", "usedScene": { "abilities": ["MainAbility"], "when": "inuse" } }, { "name": "ohos.permission.LOCATION", "reason": "用于获取精准位置，提升提醒准确性", "usedScene": { "abilities": ["MainAbility"], "when": "inuse" } } ] } }

动态申请权限代码（复用系列第一篇的权限申请逻辑扩展）：

import abilityAccessCtrl from '@ohos.abilityAccessCtrl'; import common from '@ohos.app.ability.common'; // 定位权限组 const LOCATION_PERMISSIONS = [ 'ohos.permission.APPROXIMATELY_LOCATION', 'ohos.permission.LOCATION' ]; /** * 检查并申请定位权限 */ export async function requestLocationPermission(context: common.UIAbilityContext): Promise<boolean> { const atManager = abilityAccessCtrl.createAtManager(); try { // 检查权限状态 const authResults = await atManager.checkAccessToken( abilityAccessCtrl.createTokenID(), LOCATION_PERMISSIONS ); // 筛选未授权权限 const needReqPerms = LOCATION_PERMISSIONS.filter( (perm, index) => authResults[index] !== abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED ); if (needReqPerms.length === 0) { console.log('定位权限已全部授予'); return true; } // 动态申请权限 const reqResult = await atManager.requestPermissionsFromUser(context, needReqPerms); const allGranted = reqResult.authResults.every(status => status === 0); console.log(`定位权限申请结果：${allGranted ? '成功' : '失败'}`); return allGranted; } catch (err) { console.error(`定位权限处理异常：${JSON.stringify(err)}`); return false; } }

2. 定位初始化与配置

import geoLocationManager from '@ohos.geolocation'; // 全局存储定位订阅ID（用于取消定位） let locationSubscriptionId: number | null = null; /** * 初始化定位配置 * @returns 定位请求配置 */ export function initLocationConfig(): geoLocationManager.LocationRequest { // 配置定位参数 const locationRequest = { priority: geoLocationManager.LocationRequestPriority.HIGH_ACCURACY, // 高精度模式 interval: 5000, // 定位间隔（5秒一次，可根据需求调整） distance: 10, // 位置变化超过10米才触发回调（减少功耗） scenario: geoLocationManager.LocationScenario.NAVIGATION // 导航场景（适合位置跟踪） }; console.log('定位配置初始化完成'); return locationRequest; }

3. 获取实时经纬度（核心功能）

支持两种定位方式：单次定位（获取当前位置）和持续定位（实时跟踪位置）：

typescript

运行

import geoLocationManager from '@ohos.geolocation'; /** * 单次定位：获取当前经纬度 */ export async function getSingleLocation(): Promise<{ latitude: number; longitude: number } | null> { try { const location = await geoLocationManager.getCurrentLocation(); const { latitude, longitude } = location; console.log(`单次定位成功：纬度=${latitude}，经度=${longitude}`); return { latitude, longitude }; } catch (err) { console.error(`单次定位失败：${JSON.stringify(err)}`); return null; } } /** * 持续定位：实时监听位置变化 * @param callback 位置变化回调函数 */ export function startContinuousLocation( callback: (location: { latitude: number; longitude: number }) => void ) { const locationRequest = initLocationConfig(); // 订阅位置变化 locationSubscriptionId = geoLocationManager.on('locationChange', locationRequest, (location) => { const { latitude, longitude } = location; console.log(`持续定位更新：纬度=${latitude}，经度=${longitude}`); callback({ latitude, longitude }); }); console.log('持续定位已启动，订阅ID：', locationSubscriptionId); } /** * 停止持续定位（释放资源） */ export function stopContinuousLocation() { if (locationSubscriptionId !== null) { geoLocationManager.off('locationChange', locationSubscriptionId); locationSubscriptionId = null; console.log('持续定位已停止'); } }

4. 位置数据解析与距离计算

位置提醒需要判断 “是否到达目标区域”，核心是计算当前位置与目标位置的直线距离：

typescript

运行

/** * 计算两点之间的直线距离（单位：米） * @param lat1 起点纬度 * @param lng1 起点经度 * @param lat2 终点纬度 * @param lng2 终点经度 * @returns 直线距离 */ export function calculateDistance( lat1: number, lng1: number, lat2: number, lng2: number ): number { const R = 6371000; // 地球半径（米） const radLat1 = Math.PI * lat1 / 180; const radLat2 = Math.PI * lat2 / 180; const deltaLat = radLat2 - radLat1; const deltaLng = Math.PI * (lng2 - lng1) / 180; const a = Math.sin(deltaLat / 2) * Math.sin(deltaLat / 2) + Math.cos(radLat1) * Math.cos(radLat2) * Math.sin(deltaLng / 2) * Math.sin(deltaLng / 2); const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a)); return R * c; // 距离（米） } /** * 判断是否到达目标区域 * @param currentLoc 当前位置 * @param targetLoc 目标位置 * @param radius 提醒半径（米） * @returns 是否到达 */ export function isReachTargetArea( currentLoc: { latitude: number; longitude: number }, targetLoc: { latitude: number; longitude: number }, radius: number = 100 ): boolean { const distance = calculateDistance( currentLoc.latitude, currentLoc.longitude, targetLoc.latitude, targetLoc.longitude ); return distance <= radius; }

三、实战：定位功能整合演示

typescript

运行

@Entry @Component struct LocationDemoPage { private context = getContext(this) as common.UIAbilityContext; @State currentLocation: string = '未获取位置'; @State targetLocation: { latitude: number; longitude: number } = { latitude: 39.9042, // 北京天安门纬度 longitude: 116.4074 // 北京天安门经度 }; build() { Column({ space: 30 }) .width('100%') .height('100%') .padding(30) .backgroundColor('#f5f5f5') { Text('地理位置服务演示') .fontSize(32) .fontWeight(FontWeight.Bold) Text(`当前位置：${this.currentLocation}`) .fontSize(20) .width('100%') .textAlign(TextAlign.Center) Button('申请定位权限') .type(ButtonType.Capsule) .width(250) .height(60) .backgroundColor('#2f54eb') .onClick(async () => { const granted = await requestLocationPermission(this.context); Toast.show({ message: granted ? '定位权限申请成功' : '定位权限申请失败' }); }) Button('获取当前位置') .type(ButtonType.Capsule) .width(250) .height(60) .backgroundColor('#2f54eb') .onClick(async () => { const location = await getSingleLocation(); if (location) { this.currentLocation = `纬度：${location.latitude.toFixed(6)}，经度：${location.longitude.toFixed(6)}`; // 判断是否到达目标区域 const reach = isReachTargetArea(location, this.targetLocation); if (reach) { Toast.show({ message: '已到达目标区域！' }); } } else { this.currentLocation = '位置获取失败'; } }) Button('启动持续定位') .type(ButtonType.Capsule) .width(250) .height(60) .backgroundColor('#2f54eb') .onClick(() => { startContinuousLocation((location) => { this.currentLocation = `纬度：${location.latitude.toFixed(6)}，经度：${location.longitude.toFixed(6)}`; // 到达目标区域触发提醒（后续整合通知） if (isReachTargetArea(location, this.targetLocation)) { Toast.show({ message: '已到达目标区域，即将发送通知！' }); stopContinuousLocation(); // 到达后停止定位，减少功耗 } }); }) Button('停止持续定位') .type(ButtonType.Capsule) .width(250) .height(60) .backgroundColor('#ff4d4f') .onClick(() => { stopContinuousLocation(); }) } } }

四、实战踩坑指南

1. 定位失败的常见原因

  • ❶ 权限缺失：必须同时声明模糊定位权限，精确定位不能单独申请；
  • ❷ 定位模式不匹配：室内场景使用 “高精度模式”（GNSS + 网络），纯 GNSS 在室内可能无信号；
  • ❸ 设备定位开关关闭：需引导用户开启系统定位功能（代码可检测定位开关状态）；
  • ❹ 后台定位权限未开启：持续定位需申请LOCATION_IN_BACKGROUND并引导用户手动开启。

2. 功耗优化技巧

  • ❶ 合理设置定位间隔：非实时导航场景建议间隔≥3 秒，距离阈值≥10 米；
  • ❷ 到达目标后停止定位：避免不必要的持续定位消耗电量；
  • ❸ 适配电池状态：低电量时切换为 “低功耗模式”（仅网络定位）。

加入班级，学习鸿蒙开发

http://www.cnnetsun.cn/news/8666.html

相关文章：

  • 为啥网站跳转重定向是307 而不是 301 呢？
  • Zabbix监控模板实战指南：从零构建企业级监控体系
  • RulersGuides.js：网页设计中的Photoshop式标尺与辅助线终极指南
  • 如何快速掌握MagicEdit：高保真视频编辑的终极指南
  • 基于STM32的辅助病床智慧监护系统设计（有完整资料）
  • AI音频分离技术深度解析：Ultimate Vocal Remover的多轨处理革命
  • 5大理由告诉你为什么Bookworm是Linux用户必备的电子书阅读器
  • UDP通信
  • 如何快速制作专业有声书：abogen开源工具的完整指南
  • Matlab 基于光流场的交通流量分析与应用
  • 如何运用Transformer架构实现高效图像生成
  • 阿里自研Wan2.2-T2V-A14B模型深度解析：文本到视频的革命性突破
  • MySQL从入门到精通系列保姆级教程，带你嗨翻天
  • 5个移动端推荐引擎性能瓶颈及突破方案
  • 复杂网络与模糊逻辑粒子群优化毕业论文【附代码】
  • 【毕业设计】基于springboot高校工作室管理系统高等教育机构的工作室管理(源码+文档+远程调试，全bao定制等)
  • uni-app插件市场深度ROI分析：如何用组件化降低70%开发成本
  • 5、汇编语言中的数学与位操作
  • 靠谱的PC耐力板公司有哪些
  • 深入解析C#方法：从基础到高级应用
  • 基于微信小程序的校园食堂点餐订餐系统（毕业设计项目源码+文档）
  • XGW-9000系列高端新能源电站边缘网关产品需求文档（PRD）
  • 多模态Agent的Docker服务编排全解析（架构师不愿透露的5大核心技巧）
  • 网络安全培训全攻略：零基础能学会吗？前景如何？
  • 仓颉stdx模块终极配置指南：从零开始快速上手
  • 使用开源模型微调，构建专属的测试用例生成机器人
  • COMSOL模拟等离子共振结构超材料：多波段高吸收率文献复现案例
  • 深度解析：5大实战技巧教你精准拆解量化策略的因子归因
  • 终极电商后台管理系统：mall-admin-web完整使用指南
  • 【量子模拟器开发新突破】：VSCode扩展实战指南，提升开发效率90%