鸿蒙定位开发最全指南：权限、接口、实战案例一步到位

最新推荐文章于 2025-07-24 19:23:16 发布

原创最新推荐文章于 2025-07-24 19:23:16 发布 · 1.1k 阅读

24 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #华为

实战源码同时被 2 个专栏收录

44 篇文章

订阅专栏

HarmonyOS

26 篇文章

订阅专栏

网罗开发 （小红书、快手、视频号同名）

大家好，我是展菲，目前在上市企业从事人工智能项目研发管理工作，平时热衷于分享各种编程领域的软硬技能知识以及前沿技术，包括iOS、前端、Harmony OS、Java、Python等方向。在移动端开发、鸿蒙开发、物联网、嵌入式、云原生、开源等领域有深厚造诣。

图书作者：《ESP32-C3 物联网工程开发实战》
图书作者：《SwiftUI 入门，进阶与实战》
超级个体：COC上海社区主理人
特约讲师：大学讲师，谷歌亚马逊分享嘉宾
科技博主：华为HDE/HDG

我的博客内容涵盖广泛，主要分享技术教程、Bug解决方案、开发工具使用、前沿科技资讯、产品评测与使用体验。我特别关注云服务产品评测、AI 产品对比、开发板性能测试以及技术报告，同时也会提供产品优缺点分析、横向对比，并分享技术沙龙与行业大会的参会体验。我的目标是为读者提供有深度、有实用价值的技术洞察与分析。

展菲：您的前沿技术领航员
👋 大家好，我是展菲！
📱 全网搜索“展菲”，即可纵览我在各大平台的知识足迹。
📣 公众号“Swift社区”，每周定时推送干货满满的技术长文，从新兴框架的剖析到运维实战的复盘，助您技术进阶之路畅通无阻。
💬 微信端添加好友“fzhanfei”，与我直接交流，不管是项目瓶颈的求助，还是行业趋势的探讨，随时畅所欲言。
📅 最新动态：2025 年 3 月 17 日
快来加入技术社区，一起挖掘技术的无限潜能，携手迈向数字化新征程！

摘要

在如今移动设备无处不在的环境下，位置信息已经成为各种智能应用不可或缺的一部分。导航、天气、社交、打车、外卖……几乎每一个生活场景都少不了定位服务的支持。而在鸿蒙系统中，我们也能轻松实现精准的位置获取，并通过高效的API接口为应用赋能。

引言

随着 HarmonyOS NEXT 的不断发展，越来越多的开发者开始关注鸿蒙系统原生能力的接入。其中，位置服务（Location Service）是使用频率极高的一项功能。无论是智能穿戴、车载系统，还是日常 App 开发，位置获取都起着重要作用。

本篇文章将手把手教你如何在鸿蒙系统中实现位置服务，从权限申请到位置更新的全过程，并结合真实场景提供完整代码演示。

位置服务开发基础流程

申请权限

在鸿蒙系统中，访问设备的位置信息属于敏感权限，因此需要在 config.json 中先声明所需权限。

示例代码（config.json 权限配置）：

{
  "module": {
    "abilities": [
      {
        "skills": [
          {
            "entities": [
              "entity.system.location"
            ]
          }
        ],
        "permissions": [
          "ohos.permission.LOCATION",
          "ohos.permission.LOCATION_IN_BACKGROUND"
        ]
      }
    ]
  }
}

其中：

ohos.permission.LOCATION：获取前台位置信息
ohos.permission.LOCATION_IN_BACKGROUND：允许后台获取位置信息（慎用）

动态申请权限

声明权限之后，我们还要在代码中主动检查并请求这些权限。

示例代码：

import bundleManager from '@ohos.bundle.bundleManager';
import requestPermission from '@ohos.security.permission';

async function checkLocationPermission() {
  const permission = 'ohos.permission.LOCATION';

  const granted = await requestPermission.requestPermissionsFromUser(
    getContext(), [permission]
  );

  if (granted[0].granted) {
    console.info('用户已授予定位权限');
  } else {
    console.error('用户拒绝了定位权限');
  }
}

获取位置信息

创建 LocationRequest

我们使用 @ohos.location 模块中的 Locator 来创建位置请求。

示例代码：

import location from '@ohos.location';

const locator = location.getLocator(getContext());

const requestInfo: location.RequestInfo = {
  priority: location.LocationRequestPriority.HIGH_ACCURACY,
  scenario: location.LocationRequestScenario.NAVIGATION,
  timeInterval: 5000, // 每5秒更新一次
  maxAccuracy: 50,    // 最大精度（单位：米）
};

注册监听器并获取实时位置信息

示例代码：

function startLocationTracking() {
  locator.requestLocationUpdates(requestInfo, locationCallback);
}

const locationCallback: location.LocatorCallback = {
  onLocationReport(locationData) {
    console.info(`当前位置: 纬度 ${locationData.latitude}, 经度 ${locationData.longitude}`);
  },
  onError(errorCode) {
    console.error('定位失败，错误码：' + errorCode);
  }
};

停止定位

在页面销毁或定位不再需要时及时关闭，节省电量。

function stopLocationTracking() {
  locator.stopLocationUpdates(locationCallback);
}

应用场景实战

导航类App定位（如跑步记录、导航类）

const runningRequest: location.RequestInfo = {
  priority: location.LocationRequestPriority.HIGH_ACCURACY,
  scenario: location.LocationRequestScenario.SPORT,
  timeInterval: 1000,
  maxAccuracy: 10,
};

locator.requestLocationUpdates(runningRequest, {
  onLocationReport(loc) {
    console.info(`[跑步记录] 位置更新: ${loc.latitude}, ${loc.longitude}`);
  },
  onError(err) {
    console.error('[跑步记录] 定位失败');
  }
});

适合用于实时更新轨迹的应用，比如跑步、骑行、行车记录等。

天气类App定位（如获取用户当前位置天气）

locator.getCurrentLocation((err, loc) => {
  if (!err && loc) {
    console.info(`天气定位成功，当前位置：${loc.latitude}, ${loc.longitude}`);
    // 发起天气API请求...
  } else {
    console.error('天气定位失败');
  }
});