鸿蒙Next定位开发，返回经纬度数据

精选原创

jiashaoying 2024-12-24 10:28:46 ©著作权

文章标签 回调函数定位服务 HarmonyOS 文章分类 Android 移动开发

©著作权归作者所有：来自51CTO博客作者jiashaoying的原创作品，请联系作者获取转载授权，否则将追究法律责任

在鸿蒙Next（HarmonyOS Next）中使用ArkTS语言开发定位服务，你需要遵循一系列步骤来配置和实现位置服务。以下是一个详细的指南，展示如何在鸿蒙Next应用中使用ArkTS开发定位服务。

/**
 * @Title HFLocationHandler
 * @Description 定位处理类，用于获取设备位置信息
 * @Author [Your Name]
 * @Create [Creation Date]
 * @Copyright [Your Company]
 */

import { tztZFDevicePermission } from 'tztzfui';
import { geoLocationManager } from '@kit.LocationKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { tztZFDataMapBase } from 'tztzfnetwork';

type hfLocationCallback = (result: tztZFDataMapBase<string, string>) => void;

export class HFLocationHandler {
  private locationValueMap = new tztZFDataMapBase<string, string>();
  private request: geoLocationManager.SingleLocationRequest = {
    // 选择定位优先级：精度或速度
    locatingPriority: geoLocationManager.LocatingPriority.PRIORITY_LOCATING_SPEED,
    locatingTimeoutMs: 10000, // 定位超时时间，单位毫秒
  };

  /**
   * 获取设备位置信息
   * @param callback - 定位结果回调函数
   */
  obtainLocation(callback: hfLocationCallback) {
    if (this.checkLocationPermission()) {
      // 如果已有定位权限，直接请求定位
      this.requestLocation(callback);
    } else {
      // 如果没有定位权限，请求用户授权
      tztZFDevicePermission.reqPermissionsFromUser(getContext(),
        ['ohos.permission.APPROXIMATELY_LOCATION', 'ohos.permission.LOCATION'], () => {
          // 授权后请求定位
          this.requestLocation(callback);
        });
    }
  }

  /**
   * 请求设备当前位置
   * @param callback - 定位结果回调函数
   */
  private requestLocation(callback: hfLocationCallback) {
    try {
      // 获取当前位置
      geoLocationManager.getCurrentLocation(this.request).then((result) => {
        // 根据定位方式决定是否采用结果，此处仅示例，具体逻辑可能需要根据实际情况调整
        if (['北斗', 'WLAN', 'WIFI', '基站'].includes(result.provider)) {
          // 如果定位方式符合要求，则记录经纬度
          this.locationValueMap.setStr('latitude', result.latitude.toString());
          this.locationValueMap.setStr('longitude', result.longitude.toString());
          callback(this.locationValueMap);
        }
      })
        .catch((error: BusinessError) => {
          // 处理定位错误
          console.error('定位失败:', error);
        });
    } catch (err) {
      // 处理其他错误
      console.error('请求定位时发生错误:', err);
    }
  }

  /**
   * 检查定位权限
   * @returns 是否拥有定位权限
   */
  private checkLocationPermission(): boolean {
    return tztZFDevicePermission.checkPermission("ohos.permission.APPROXIMATELY_LOCATION") &&
      tztZFDevicePermission.checkPermission('ohos.permission.LOCATION');
  }
}

// 导出默认实例
export default new HFLocationHandler();

添加权限

在使用定位服务之前，需要在 config.json 文件中声明相应的权限。

修改 `config.json`

打开项目的 config.json 文件，并添加定位权限：

{
    "module": {
        "reqPermissions": [
            {
                "name": "ohos.permission.LOCATION"
            },
            {
                "name": "ohos.permission.APPROXIMATE_LOCATION"
            }
        ]
    }
}

请求运行时权限

在代码中请求运行时权限，以确保用户同意授予定位权限。

完整示例

以下是完整的示例代码，展示了如何在鸿蒙Next应用中使用ArkTS开发定位服务。

import featureAbility from '@ohos.ability.featureAbility';
import permissionManager from '@ohos.security.permissionManager';
import location from '@ohos.location';

// 请求运行时权限
async function requestLocationPermission() {
    const permissions = ['ohos.permission.LOCATION', 'ohos.permission.APPROXIMATE_LOCATION'];
    for (const permission of permissions) {
        try {
            const result = await permissionManager.requestPermissionsFromUser(featureAbility.getContext(), [permission]);
            if (result[0].grantStatus === permissionManager.GrantStatus.PERMISSION_GRANTED) {
                console.log(`${permission} granted`);
            } else {
                console.log(`${permission} denied`);
            }
        } catch (error) {
            console.error(`Failed to request ${permission}: ${error.message}`);
        }
    }
}

// 获取定位信息
async function getLocation() {
    try {
        // 创建 LocationRequest 对象
        const locationRequest: location.LocationRequest = {
            priority: location.Priority.HIGH_ACCURACY,
            interval: 5000, // 更新间隔时间（毫秒）
            distanceInterval: 0 // 距离变化阈值（米）
        };

        // 创建回调函数
        const callback = {
            onLocationChange(loc: location.Location) {
                console.log('Latitude:', loc.latitude);
                console.log('Longitude:', loc.longitude);
            },
            onError(error: any) {
                console.error('Location error:', error);
            }
        };

        // 订阅位置更新
        await location.subscribe(locationRequest, callback);
        console.log('Location subscription started');
    } catch (error) {
        console.error('Failed to get location:', error.message);
    }
}

// 请求权限后获取定位信息
requestLocationPermission().then(() => {
    getLocation();
});