文档开发者中心
我的
|

HarmonyOS 6

华为鸿蒙开发高级篇08-地图与位置服务实战:骑行轨迹记录

华为鸿蒙开发高级篇08-地图与位置服务实战:骑行轨迹记录 App

高级系列第 8 篇 · 案例:骑行轨迹记录 App——地图显示、实时定位、轨迹绘制(polyline)、暂停/继续与后台续传。 目标:跑通鸿蒙地图 + 定位两条链路:地图组件加载与标记/轨迹绘制;位置服务申请、持续定位、权限与生命周期处理,并沉淀"轨迹记录器"核心代码。

cke_147.png

一、案例背景

骑行、跑步、物流轨迹类应用的核心是:地图展示 + 高频定位采样 + 轨迹画线。难点不在单个 API,而在三者的协作:定位频率与功耗的平衡、轨迹数据的内存管理、页面退出/后台时定位是否继续。

二、前置准备

2.1 权限

收起
自动换行
深色代码主题
复制
{
  "requestPermissions": [
    { "name": "ohos.permission.LOCATION" },                  // 精确位置
    { "name": "ohos.permission.APPROXIMATELY_LOCATION" },    // 近似位置
    { "name": "ohos.permission.LOCATION_IN_BACKGROUND" }     // 后台定位(如需后台续传)
  ]
}

运行时申请(与第 7 篇权限流程一致,用 abilityAccessCtrl),注意:先申请近似定位,再申请精确定位,用户拒绝时降级到近似定位。

2.2 地图

  • 鸿蒙地图能力通常通过地图 SDK(如华为 Map Kit / 第三方)接入,需在 AGC 开通服务并配置 API Key。
  • 工程内需配置证书指纹与 Key(具体以所接地图 SDK 文档为准);地图组件一般以 MapComponent(或自定义组件包装)形式加载。

cke_148.png

三、实际开发代码:轨迹记录 App

3.1 轨迹数据模型

收起
自动换行
深色代码主题
复制
// model/TrackModels.ets
export interface LatLng {
  lat: number
  lng: number
}

export interface TrackPoint extends LatLng {
  timestamp: number   // 采样时间(毫秒)
  altitude: number    // 海拔(米)
}

export class TrackSession {
  points: TrackPoint[] = []
  paused: boolean = false
  startTime: number = 0
  pauseAccum: number = 0   // 累计暂停时长(毫秒)

  get duration(): number {
    if (this.startTime === 0) return 0
    return Date.now() - this.startTime - this.pauseAccum
  }

  get distanceMeters(): number {
    // 逐段累加两两间距离(Haversine 近似即可)
    let sum = 0
    for (let i = 1; i < this.points.length; i++) {
      sum += haversine(this.points[i - 1], this.points[i])
    }
    return sum
  }
}

// 两点球面距离(米)
export function haversine(a: LatLng, b: LatLng): number {
  const R = 6371000
  const dLat = toRad(b.lat - a.lat)
  const dLng = toRad(b.lng - a.lng)
  const s = Math.sin(dLat / 2) ** 2
    + Math.cos(toRad(a.lat)) * Math.cos(toRad(b.lat)) * Math.sin(dLng / 2) ** 2
  return 2 * R * Math.asin(Math.sqrt(s))
}

function toRad(deg: number): number {
  return (deg * Math.PI) / 180
}

3.2 定位服务封装

收起
自动换行
深色代码主题
复制
// service/LocationService.ets
import { geoLocationManager } from '@kit.LocationKit'
import { BusinessError } from '@kit.BasicServicesKit'
import { LatLng, TrackPoint } from '../model/TrackModels'

export class LocationService {
  private locationChange: geoLocationManager.LocationCallback | undefined
  private lastPoint: TrackPoint | undefined
  onPoint: (p: TrackPoint) => void = () => {}

  // 开始持续定位:按场景选择定位优先级
  start() {
    // 场景:骑行高频定位(按实际需求选 1~5 秒间隔)
    const request: geoLocationManager.LocationRequest = {
      priority: geoLocationManager.LocationRequestPriority.PRECISION,   // 精确优先
      scenario: geoLocationManager.LocationRequestScenario.SPORT,       // 运动场景
      maxAccuracy: 10,
      timeInterval: 2,      // 采样间隔(秒)

要点:

  • timeInterval + distanceInterval 双条件采样,兼顾平滑与省电。
  • 场景 SPORT 会适配运动轨迹的定位参数(以 SDK 支持为准,不支持则用通用场景)。
  • 停止时 off 移除回调,避免泄漏。

3.3 轨迹绘制:地图 polyline

地图组件的具体 API 随 SDK 而异,这里给出通用思路(以类 MapKit 接口示意,按所接 SDK 调整):

收起
自动换行
深色代码主题
复制
// components/TrackMap.ets
import { MapComponent, MapLatLng, MapPolylineOptions } from '地图SDK声明'   // 按实际 SDK 引入

@Component
export struct TrackMap {
  // 轨迹点(父组件传入,实时更新)
  @Prop points: TrackPoint[] = []

  build() {
    // 地图组件:以真实 SDK 的组件/控制器为准
    MapComponent()
      .onMapReady((map: MapController) => {
        // 1) 绘制轨迹线
        if (this.points.length > 1) {
          const polyline: MapPolylineOptions = {
            points: this.points.map((p) => ({ lat: p.lat, lng: p.lng }) as MapLatLng),
            color: '#007DFF',
            width: 6
          }
          map.addPolyline(polyline)
        }
        // 2) 视野跟随最后一点(骑行场景)
        const last = this.points[this.points.length - 1]
        if (last) {
          map.moveCamera({ target: { lat: last.lat, lng: last.lng }, zoom: 17 })
        }
      })
  }
}

说明:地图 SDK 的组件名、控制器方法与 polyline 选项各不相同,以上为结构示意;集成时以所选 SDK 的类型声明为准,并将 MapComponent/MapController 替换为实际 API。

3.4 页面:记录器(开始/暂停/继续/结束)

收起
自动换行
深色代码主题
复制
// pages/RidePage.ets
import { LocationService } from '../service/LocationService'
import { TrackSession, TrackPoint } from '../model/TrackModels'
import { TrackMap } from '../components/TrackMap'

@Entry
@Component
struct RidePage {
  private locSvc: LocationService = new LocationService()
  private session: TrackSession = new TrackSession()
  @State points: TrackPoint[] = []
  @State running: boolean = false
  @State paused: boolean = false
  @State distanceText: string = '0.00 km'
  @State durationText: string = '00:00'
  private timer: number = -1

  aboutToAppear() {
    this.locSvc.onPoint = (p: TrackPoint) => {
      if (this.paused) return            // 暂停时不采样
      this.session.points.push(p)
      this.points = [...this.session.points]   // 触发地图重绘(新数组引用)
    }
  }

  private start() {
    this.session = new TrackSession()
    this.session.startTime = Date.now()
    this.locSvc.start()
    this.running = true
    this.paused = false
    // 定时刷新统计栏
    this.timer = setInterval(() => {
      this.distanceText = (this.session.distanceMeters / 1000).toFixed(2) + ' km'
      this.durationText = this.fmt(this.session.duration)
    }, 1000) as unknown as number
  }

  private togglePause() {
    this.paused = !this.paused
    if (this.paused) {
      this.session.pauseAccum = Date.now() - this.session.startTime - this.session.pauseAccum
    } else {
      // 恢复:重置暂停起点(简化处理:用恢复时间校正)
      this.session.pauseAccum = 0
    }
  }

  private finish() {
  

说明:后台任务配置涉及通知、弹窗与权限的多项约束,以官方文档为准,本文只给入口思路。

四、优化与踩坑

问题 处理
轨迹点太密 用 distanceInterval 采样;绘制前按阈值抽稀(道格拉斯-普克)
地图重绘全量刷新卡顿 只 addPolyline 增量段,或限制轨迹点数上限
后台定位被系统回收 使用持续任务 + 申请后台定位权限
定位精度漂移 开启 maxAccuracy 约束;必要时做滤波(卡尔曼/均值平滑)
权限被拒后无提示 引导到设置页;先申请近似定位降级可用
模拟器无定位/地图 真机验证;模拟器可用模拟定位源

五、小结与延伸

  • 轨迹 App 三件套:定位服务(采样)+ 地图组件(polyline 绘制)+ 会话管理(开始/暂停/结束 + 距离时长统计)。
  • 案例沉淀:LocationService(可复用的定位封装)、TrackSession(轨迹会话与距离计算)、RidePage(记录器页面),可直接扩展为跑步/物流轨迹应用。
  • 延伸:轨迹保存与回放(接第 6 篇 RDB)、多段轨迹与骑行统计(爬升/均速)、离线地图、与第 8 篇分布式结合做家人位置共享。

下一篇预告:安全加固与发布运维——密钥管理、混淆加固与崩溃监控(登录态安全存储案例)。

点赞
收藏
1
回复
分享
举报
浏览100 发布于2026-09-10 05:14上海
全部评论
最多点赞
最新发布
最早发布
暂无评论
暂无评论
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

目录 收起
华为鸿蒙开发高级篇08-地图与位置服务实战:骑行轨迹记录 App
一、案例背景
二、前置准备
2.1 权限
2.2 地图
三、实际开发代码:轨迹记录 App
3.1 轨迹数据模型
3.2 定位服务封装
3.3 轨迹绘制:地图 polyline
3.4 页面:记录器(开始/暂停/继续/结束)
四、优化与踩坑
五、小结与延伸
了解社区公约,与您携手共创和谐专业的开发者社区。