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

自学记录：学习HarmonyOS Location Kit构建智能定位服务

article 2025/1/5 6:24:46

作为一个对新技术充满好奇心的开发者，每当更新API时，实际上既紧张，又兴奋。紧张是怕之前学习的不用了，白费了。兴奋是有新的东西肯定是更好，又可以给自己能力添砖加瓦了。

所以，我选择了HarmonyOS Next作为挑战的对象，特别是其最新发布的5.0.1（API 13）版本。在这次旅程中，我决定深入研究Location Kit，这是一套功能强大的定位服务API，支持从GNSS定位到网络定位、地理围栏等多种定位方式。

在学习和实践过程中，我遇到过挫折，也有过兴奋的时刻。最终，我成功开发了一款智能定位应用，这篇文章将从我的视角，结合代码和开发过程，详细讲解我是如何一步步实现这些功能的。希望通过我的分享，能帮助其他开发者快速上手这套工具，同时也点燃你对HarmonyOS开发的热情。

第一步：权限管理——定位服务的第一道关卡

场景分析：权限的重要性

任何涉及到定位的应用都离不开权限管理，这是保护用户隐私的第一道防线。HarmonyOS 提供了两种主要的定位权限：

ohos.permission.LOCATION：精确定位权限，通常用于导航或运动轨迹记录。
ohos.permission.APPROXIMATELY_LOCATION：模糊定位权限，用于日常应用（如天气预报）。

没有这两种权限，定位功能无法正常使用。在实际开发中，我不仅需要申请权限，还要考虑如何引导用户理解为什么需要这些权限。

代码实现：权限申请与管理

import { abilityAccessCtrl } from '@ohos.application';

async function requestLocationPermissions() {
    const permissions = [
        'ohos.permission.LOCATION',
        'ohos.permission.APPROXIMATELY_LOCATION',
    ];

    try {
        const atManager = abilityAccessCtrl.createAtManager();
        const result = await atManager.requestPermissionsFromUser(permissions);
        console.info('权限申请结果:', result);
        return result.every(permission => permission === 0);
    } catch (err) {
        console.error('权限申请失败:', err);
        return false;
    }
}

在调试这段代码时，我发现一个问题：如果用户拒绝了权限，应用会直接报错。为此，我在界面设计上增加了逻辑，当权限被拒绝时，弹窗提醒用户并解释功能的重要性。

思考与实践：让用户信任

权限申请不仅仅是技术问题，它更是一个与用户建立信任的过程。在实际应用中，我设计了这样的引导文案：

“我们需要您的位置权限，以提供精准的导航服务。如果您拒绝，应用可能无法正常使用定位功能。”

这种直接而友好的说明，能够极大提升用户的接受度。

第二步：获取当前位置——应用的基础能力

场景分析：从坐标出发

一个定位应用最基本的功能就是获取用户当前位置，这对导航、外卖、打车等场景都至关重要。在HarmonyOS Location Kit中，我们可以通过getCurrentLocation方法轻松获取用户的经纬度。

代码实现：实时获取当前位置

import { geoLocationManager } from '@kit.LocationKit';

async function fetchCurrentLocation() {
    try {
        const location = await geoLocationManager.getCurrentLocation({
            priority: geoLocationManager.LocationRequestPriority.ACCURACY,
            scenario: geoLocationManager.LocationRequestScenario.NAVIGATION,
        });
        console.info('当前位置:', JSON.stringify(location));
        return location;
    } catch (err) {
        console.error('获取当前位置失败:', err);
    }
}

在实践过程中，我注意到priority和scenario两个参数的设置非常重要：

priority：决定定位精度。如果设置为ACCURACY，系统会优先选择GNSS定位；如果设置为LOW_POWER，则使用网络定位。
scenario：指定使用场景。例如，NAVIGATION适用于导航，DAILY_LIFE_SERVICE则适用于低功耗的场景。

思考：从代码到用户体验

我在测试时发现，当手机没有开启“定位服务”开关时，调用这段代码会直接抛出异常。因此，我在调用前增加了一个检查：

if (!geoLocationManager.isLocationEnabled()) {
    console.warn('定位服务未开启');
    return;
}

这一点看似简单，却能有效提升用户体验。

第三步：逆地理编码——从坐标到地址

场景分析：让数据更友好

经纬度对开发者很有意义，但对普通用户来说却过于晦涩。逆地理编码（Reverse Geocoding）就是将这些“冷冰冰的数字”转换为用户可读的地址描述，比如“上海市浦东新区陆家嘴金融中心”。

代码实现：逆地理编码

async function reverseGeocode(latitude: number, longitude: number) {
    try {
        const addresses = await geoLocationManager.getAddressesFromLocation({
            latitude,
            longitude,
            maxItems: 1,
        });
        console.info('地址信息:', JSON.stringify(addresses[0]));
        return addresses[0]?.placeName || '未知地址';
    } catch (err) {
        console.error('逆地理编码失败:', err);
    }
}

这段代码中，maxItems 参数控制了返回的地址数量。默认值为1，但我们可以根据需求设置更多结果，比如同时获取中文和英文描述。

思考：更多的数据层次

HarmonyOS 的逆地理编码结果包含了丰富的层次信息，包括：

placeName：详细地址
administrativeArea：省/州
locality：市
subLocality：区/县

通过这些字段，我们可以灵活地展示不同层级的地址，满足多样化需求。

第四步：地理围栏——让定位更智能

场景分析：基于位置的自动化

一个典型的场景是，当用户进入某个区域时触发特定的行为，比如推送通知、记录到访时间等。这种需求可以通过地理围栏来实现。

代码实现：添加地理围栏

async function addGeofence(latitude: number, longitude: number, radius: number) {
    const geofence = {
        latitude,
        longitude,
        radius,
        expiration: 3600000, // 1小时
    };

    try {
        const fenceId = await geoLocationManager.addGnssGeofence({
            geofence,
            monitorTransitionEvents: [
                geoLocationManager.GeofenceTransitionEvent.GEOFENCE_TRANSITION_EVENT_ENTER,
                geoLocationManager.GeofenceTransitionEvent.GEOFENCE_TRANSITION_EVENT_EXIT,
            ],
            geofenceTransitionCallback: (err, transition) => {
                if (err) {
                    console.error('围栏事件触发失败:', err);
                } else {
                    console.info('围栏事件触发:', JSON.stringify(transition));
                }
            },
        });
        console.info('地理围栏添加成功, ID:', fenceId);
    } catch (err) {
        console.error('添加地理围栏失败:', err);
    }
}

第五步：整合与实战——开发智能定位助手

通过以上功能，我最终开发了一款名为“智能定位助手”的应用，它可以：

获取用户实时位置。
将坐标转换为地址。
在用户进入或离开指定区域时触发提醒。

完整UI代码实现

@Entry
@Component
struct LocationAssistant {
    @State location: string = '未获取位置';
    @State address: string = '未解析地址';
    @State status: string = '无地理围栏触发';

    build() {
        Column() {
            Text(this.location).fontSize(18).margin(10);

            Button('获取当前位置')
                .onClick(async () => {
                    const loc = await fetchCurrentLocation();
                    this.location = `纬度: ${loc.latitude}, 经度: ${loc.longitude}`;
                });

            Button('逆地理编码')
                .onClick(async () => {
                    const loc = await fetchCurrentLocation();
                    const addr = await reverseGeocode(loc.latitude, loc.longitude);
                    this.address = addr;
                });

            Button('添加地理围栏')
                .onClick(async () => {
                    await addGeofence(31.2304, 121.4737, 100);
                });

            Text(this.status).fontSize(18).margin(10);
        }
    }
}