前言

在鸿蒙（HarmonyOS）应用开发中，获取用户位置信息是许多场景下的基本需求，如地图导航、周边服务推荐、运动轨迹记录等。本文将全面介绍鸿蒙系统中定位权限的获取流程，包括权限类型、动态申请、位置服务使用以及最佳实践，帮助开发者正确处理定位相关功能开发。

一、鸿蒙定位权限概述

1.1 定位权限类型

鸿蒙系统将定位权限分为两大类：

// 精准定位权限（GPS级别精度）
const ACCURATE_LOCATION = "ohos.permission.LOCATION"

// 模糊定位权限（基站/WiFi级别精度）
const APPROXIMATE_LOCATION = "ohos.permission.APPROXIMATELY_LOCATION"

1.2 权限级别说明
| 权限类型 | 精度范围 | 适用场景 | 电量消耗 |
|-----------|---------------|------------------------|----------|
| 精准定位 | 5-50米 | 导航、运动轨迹 | 高 |
| 模糊定位 | 100-3000米 | 天气服务、广告推荐 | 低 |

二、权限声明配置

2.1 在config.json中声明权限

首先需要在应用的配置文件中声明需要的权限：

{
  "module": {
    "reqPermissions": [
      {
        "name": "ohos.permission.LOCATION",
        "reason": "用于提供精准导航服务",
        "usedScene": {
          "ability": [
            "com.example.MainAbility"
          ],
          "when": "always"
        }
      },
      {
        "name": "ohos.permission.APPROXIMATELY_LOCATION",
        "reason": "用于显示周边服务"
      }
    ]
  }
}

2.2 可选权限与必选权限

// 必选权限（应用核心功能必需）
{
  "name": "ohos.permission.LOCATION",
  "reason": "导航应用核心功能需要",
  "usedScene": {
    "ability": ["com.example.NavigationAbility"],
    "when": "always"
  }
}

// 可选权限（增强功能使用）
{
  "name": "ohos.permission.LOCATION_IN_BACKGROUND",
  "reason": "后台持续定位用于运动记录",
  "usedScene": {
    "ability": ["com.example.FitnessAbility"],
    "when": "always"
  }
}

三、动态权限申请

3.1 检查权限状态

在申请权限前应先检查当前权限状态：

import abilityAccessCtrl from '@ohos.abilityAccessCtrl'

async function checkPermission(permission: string): Promise<boolean> {
  try {
    const atManager = abilityAccessCtrl.createAtManager()
    const grantStatus = await atManager.checkAccessToken(
      abilityAccessCtrl.AccessTokenID.INVALID_TOKEN,
      permission
    )
    return grantStatus === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED
  } catch (err) {
    console.error(`检查权限失败: ${err.code}, ${err.message}`)
    return false
  }
}

3.2 请求权限

import abilityAccessCtrl from '@ohos.abilityAccessCtrl'
import promptAction from '@ohos.promptAction'

async function requestPermission(context: common.Context, permission: string): Promise<boolean> {
  const atManager = abilityAccessCtrl.createAtManager()
  
  try {
    // 先检查是否已有权限
    const hasPermission = await checkPermission(permission)
    if (hasPermission) {
      return true
    }
    
    // 请求权限
    await atManager.requestPermissionsFromUser(context, [permission])
    
    // 再次检查
    return await checkPermission(permission)
  } catch (err) {
    promptAction.showToast({
      message: `权限请求失败: ${err.message}`,
      duration: 3000
    })
    return false
  }
}

3.3 完整权限申请流程示例

@Component
struct LocationPermissionExample {
  @State hasLocationPermission: boolean = false
  private context = getContext(this)
  
  async aboutToAppear() {
    this.hasLocationPermission = await checkPermission(ACCURATE_LOCATION)
  }
  
  build() {
    Column() {
      if (this.hasLocationPermission) {
        Text('已获得定位权限')
          .fontSize(20)
      } else {
        Button('申请定位权限')
          .onClick(async () => {
            const granted = await requestPermission(this.context, ACCURATE_LOCATION)
            this.hasLocationPermission = granted
            if (!granted) {
              promptAction.showDialog({
                title: '权限被拒绝',
                message: '请在设置中手动开启定位权限',
                buttons: [{ text: '确定' }]
              })
            }
          })
      }
    }
    .width('100%')
    .height('100%')
  }
}

四、使用定位服务

4.1 获取系统位置服务

import geoLocationManager from '@ohos.geoLocationManager'

async function getLocation(): Promise<geoLocationManager.Location> {
  try {
    return await geoLocationManager.getCurrentLocation({
      priority: geoLocationManager.LocationRequestPriority.FIRST_FIX,
      scenario: geoLocationManager.LocationRequestScenario.NAVIGATION
    })
  } catch (err) {
    console.error(`获取位置失败: ${err.code}, ${err.message}`)
    throw err
  }
}

4.2 持续定位监听

class LocationService {
  private static instance: LocationService | null = null
  private locationCallback: (location: geoLocationManager.Location) => void = () => {}
  
  static getInstance(): LocationService {
    if (!LocationService.instance) {
      LocationService.instance = new LocationService()
    }
    return LocationService.instance
  }
  
  startListening(callback: (location: geoLocationManager.Location) => void) {
    this.locationCallback = callback
    
    geoLocationManager.on('locationChange', {
      priority: geoLocationManager.LocationRequestPriority.FIRST_FIX,
      scenario: geoLocationManager.LocationRequestScenario.NAVIGATION,
      timeInterval: 5000,
      distanceInterval: 10
    }, this.locationCallback)
  }
  
  stopListening() {
    geoLocationManager.off('locationChange', this.locationCallback)
  }
}

4.3 定位参数详解

interface LocationRequest {
  priority: LocationRequestPriority // 定位优先级
  scenario: LocationRequestScenario // 使用场景
  timeInterval?: number // 时间间隔(ms)
  distanceInterval?: number // 距离间隔(m)
  maxAccuracy?: number // 最大精度(m)
}

enum LocationRequestPriority {
  UNSET = 0x200,
  ACCURACY = 0x201,    // 高精度模式
  FIRST_FIX = 0x202,   // 快速定位
  LOW_POWER = 0x203    // 低功耗模式
}

enum LocationRequestScenario {
  UNSET = 0x300,
  NAVIGATION = 0x301,  // 导航场景
  TRAJECTORY = 0x302,  // 运动轨迹
  CAR_HAILING = 0x303, // 打车场景
  DAILY_LIFE = 0x304   // 日常生活
}

五、最佳实践与优化

5.1 权限申请时机优化

// 不好的实践：应用启动立即申请
aboutToAppear() {
  requestPermission(this.context, ACCURATE_LOCATION)
}

// 好的实践：上下文触发时申请
build() {
  Column() {
    Button('开始导航')
      .onClick(async () => {
        if (!await checkPermission(ACCURATE_LOCATION)) {
          const granted = await requestPermission(this.context, ACCURATE_LOCATION)
          if (!granted) return
        }
        // 开始导航逻辑
      })
  }
}

5.2 后台定位处理

// 申请后台定位权限
const BACKGROUND_LOCATION = "ohos.permission.LOCATION_IN_BACKGROUND"

// 后台服务中保持定位
class BackgroundLocationService {
  private locationCallbackId: number = 0
  
  start() {
    this.locationCallbackId = geoLocationManager.on('locationChange', {
      priority: LocationRequestPriority.LOW_POWER,
      scenario: LocationRequestScenario.TRAJECTORY,
      timeInterval: 10000
    }, (location) => {
      // 处理位置更新
    })
  }
  
  stop() {
    geoLocationManager.off('locationChange', this.locationCallbackId)
  }
}

5.3 定位失败处理

async function getLocationWithRetry(retryCount: number = 3): Promise<Location> {
  for (let i = 0; i < retryCount; i++) {
    try {
      return await getLocation()
    } catch (err) {
      if (i === retryCount - 1) throw err
      await new Promise(resolve => setTimeout(resolve, 1000))
    }
  }
  throw new Error('定位获取失败')
}

六、常见问题解决方案

6.1 权限被拒绝后的引导

function showPermissionGuide(context: common.Context) {
  promptAction.showDialog({
    title: '需要定位权限',
    message: '此功能需要定位权限才能正常工作',
    buttons: [
      {
        text: '取消',
        color: '#999999'
      },
      {
        text: '去设置',
        color: '#0A59F7',
        action: () => {
          try {
            abilityAccessCtrl.openSettings()
          } catch (err) {
            console.error('打开设置失败:', err)
          }
        }
      }
    ]
  })
}

6.2 不同设备兼容性处理

async function getBestAvailableLocation(): Promise<Location> {
  try {
    // 先尝试获取精准定位
    if (await checkPermission(ACCURATE_LOCATION)) {
      return await geoLocationManager.getCurrentLocation({
        priority: LocationRequestPriority.ACCURACY
      })
    }
    
    // 回退到模糊定位
    if (await checkPermission(APPROXIMATE_LOCATION)) {
      return await geoLocationManager.getCurrentLocation({
        priority: LocationRequestPriority.LOW_POWER
      })
    }
    
    throw new Error('无可用定位权限')
  } catch (err) {
    // 最终回退到IP定位或其他方式
    return getLastKnownLocation() || getIPLocation()
  }
}

结语

鸿蒙系统提供了完善的定位权限管理和位置服务API，开发者需要遵循"最小权限"原则，只在必要时申请相应精度的定位权限。在实际开发中，应当：

1. 明确说明权限使用目的
2. 提供优雅的权限拒绝处理
3. 根据场景选择合适的定位精度
4. 注意后台定位的电量消耗问题
5. 处理好各种异常情况
   通过本文介绍的方法和最佳实践，开发者可以构建出既尊重用户隐私又功能完善的定位相关应用。随着鸿蒙系统的持续更新，建议开发者定期查阅最新官方文档，获取API变更和新增功能信息。