Files
smart-crop-ui/src/TRACK_PLAYBACK_ACCESS_GUIDE.md

11 KiB
Raw Blame History

🗺️ 作业轨迹查看 - 访问指南

📍 如何查看作业轨迹

系统中有 2个地方 可以查看作业轨迹:


方式1: 轨迹回放功能 (推荐)

📍 访问路径

农机管理 → 管理与调度 → 轨迹回放

🎯 详细步骤

  1. 进入农机管理模块

    点击顶部导航栏 "农机管理"
    
  2. 进入管理与调度

    在左侧菜单中找到 "管理与调度" 分组
    
  3. 点击轨迹回放

    点击 "轨迹回放" 菜单项
    

功能特点

已有功能:

  • 选择农机
  • 选择日期
  • 选择时间段(上午/下午/全天)
  • 播放控制(播放、暂停、快进、快退)
  • 倍速播放0.5x, 1x, 2x, 4x, 8x
  • 进度条控制
  • 实时参数显示(速度、已作业面积、作业速率、发动机转速)

功能说明:

  • 动画式重现农机移动路径
  • 同步显示该时刻的作业参数
  • 支持调速播放、暂停控制
  • 用于评估作业规范性
  • 分析漏耕、重耕问题

当前状态:

  • ⚠️ 地图轨迹区域为占位符需要集成真实地图API
  • ⚠️ 使用模拟数据展示功能

方式2: 实时位置追踪(历史轨迹)

📍 访问路径

农机管理 → 设备监控 → 实时位置

🎯 详细步骤

  1. 进入农机管理模块

    点击顶部导航栏 "农机管理"
    
  2. 进入设备监控

    在左侧菜单中找到 "设备监控" 分组
    
  3. 点击实时位置

    点击 "实时位置" 菜单项
    

功能特点

已有功能:

  • 实时位置显示
  • 地图标记和聚合
  • 农机状态快照
  • 标准地图和卫星地图切换
  • 农机位置自动追踪
  • 支持历史轨迹回放
  • 轨迹导出GPX/KML格式

当前状态:

  • 完整的地图功能
  • 实时位置追踪
  • 高德地图集成

🎨 界面展示

轨迹回放页面

┌────────────────────────────────────────────────┐
│  农机作业轨迹回放                               │
│  动画式重现历史作业轨迹                         │
├────────────────────────────────────────────────┤
│                                                │
│  回放设置                                       │
│  ┌────────────────────────────────────────┐   │
│  │ 选择农机   │  日期      │  时间段      │   │
│  │ 约翰迪尔..  │  2025-10-17 │  全天 ▼     │   │
│  └────────────────────────────────────────┘   │
│                                                │
│  轨迹回放                                       │
│  ┌────────────────────────────────────────┐   │
│  │                                        │   │
│  │        地图轨迹回放区域                 │   │
│  │                                        │   │
│  │   • 动画显示农机移动路径                │   │
│  │   • 同步显示作业参数                    │   │
│  │   • 标注漏耕、重耕区域                  │   │
│  │                                        │   │
│  └────────────────────────────────────────┘   │
│                                                │
│  播放控制                                       │
│  08:00:00 ━━━━━━━━●━━━━━━━━━━ 18:00:00        │
│             ◀◀  ▶  ▶▶  [1x ▼]                 │
│                                                │
│  当前参数                                       │
│  ┌──────┬──────┬──────┬──────┐               │
│  │速度   │面积   │速率   │转速   │               │
│  │15.2  │12.5  │7.8   │1850  │               │
│  │km/h  │亩    │亩/时 │RPM   │               │
│  └──────┴──────┴──────┴──────┘               │
│                                                │
└────────────────────────────────────────────────┘

📊 功能对比

功能项 轨迹回放 实时位置
地图显示 ⚠️ 占位符 高德地图
历史轨迹 支持 支持
播放控制 完整 ⚠️ 基础
倍速播放 5档
实时参数 4项 多项
轨迹导出 GPX/KML
适用场景 详细回放 实时监控

💡 使用建议

场景1: 查看历史作业轨迹

推荐: 实时位置追踪

理由:

  • 有完整的地图显示
  • 可以导出轨迹数据
  • 功能完善稳定

步骤:

1. 农机管理 → 设备监控 → 实时位置
2. 选择要查看的农机
3. 查看历史轨迹
4. 导出轨迹数据(可选)

场景2: 详细回放和分析

推荐: 轨迹回放功能

理由:

  • 播放控制更完整
  • 支持倍速播放
  • 实时参数同步显示
  • 专注于回放分析

步骤:

1. 农机管理 → 管理与调度 → 轨迹回放
2. 选择农机、日期、时间段
3. 点击播放按钮
4. 调整播放速度
5. 观察参数变化
6. 分析作业质量

场景3: 评估作业质量

推荐: 组合使用

最佳实践:

1. 先在 "实时位置" 查看整体轨迹
2. 发现问题区域后
3. 切换到 "轨迹回放"
4. 详细回放分析问题原因
5. 查看该时刻的作业参数

🔧 技术说明

轨迹回放组件

文件位置: /components/machinery/scheduling/TrackPlayback.tsx

核心功能:

- 播放控制: isPlaying, setIsPlaying
- 播放速度: 0.5x, 1x, 2x, 4x, 8x
- 进度控制: progress slider
- 参数显示: 速度、面积、速率、转速

当前状态:

  • ⚠️ 地图区域为占位符
  • 播放控制完整
  • UI界面完整

实时位置组件

文件位置: /components/machinery/monitoring/RealtimeLocation.tsx

核心功能:

- 高德地图集成
- 实时位置显示
- 历史轨迹回放
- 轨迹导出(GPX/KML

当前状态:

  • 完整的地图功能
  • 轨迹数据管理
  • 导出功能

🎯 快速访问

方式1: 轨迹回放

路径: /machinery/scheduling/playback
菜单: 农机管理 → 管理与调度 → 轨迹回放

方式2: 实时位置

路径: /machinery/monitoring/location
菜单: 农机管理 → 设备监控 → 实时位置

📝 操作演示

轨迹回放操作流程

第1步: 选择回放设置
┌────────────────────────────┐
│ 农机: 约翰迪尔拖拉机 ▼     │
│ 日期: 2025-10-17          │
│ 时段: 全天 ▼              │
└────────────────────────────┘

第2步: 播放控制
┌────────────────────────────┐
│  08:00:00 ━━●━━━ 18:00:00  │
│    ◀◀  ▶  ▶▶  [1x ▼]     │
└────────────────────────────┘

第3步: 观察参数
┌──────┬──────┬──────┬──────┐
│速度   │面积   │速率   │转速   │
│15.2  │12.5  │7.8   │1850  │
└──────┴──────┴──────┴──────┘

第4步: 分析作业
- 观察轨迹路径
- 检查参数变化
- 发现问题区域
- 评估作业质量

常见问题

Q1: 为什么轨迹回放页面地图是占位符?

A: 轨迹回放功能的地图集成还在开发中,目前可以使用 "实时位置" 功能查看真实的地图轨迹。


Q2: 如何导出轨迹数据?

A: 使用 "实时位置" 功能,该功能支持 GPX 和 KML 格式导出。

1. 农机管理 → 设备监控 → 实时位置
2. 选择农机
3. 查看历史轨迹
4. 点击导出按钮
5. 选择格式GPX/KML

Q3: 轨迹回放和实时位置有什么区别?

A:

轨迹回放:

  • 专注于历史数据回放
  • 完整的播放控制
  • 倍速播放支持
  • 参数同步显示
  • 适合详细分析

实时位置:

  • 实时+历史双重功能
  • 完整的地图显示
  • 轨迹导出功能
  • 适合快速查看

Q4: 可以同时查看多台农机的轨迹吗?

A: 目前 "实时位置" 功能支持同时显示多台农机的位置,但轨迹回放功能一次只能回放一台农机。


Q5: 轨迹数据保存多长时间?

A: 根据系统配置一般保存30-90天。具体时间可以在系统设置中查看或调整。


🚀 未来规划

轨迹回放增强 (计划中)

  1. 集成真实地图API
  2. 多农机同时回放
  3. 3D轨迹显示
  4. 作业区域高亮
  5. 异常事件标注
  6. 质量评估叠加

实时位置增强 (计划中)

  1. 轨迹聚类分析
  2. 热力图显示
  3. 作业效率统计
  4. 路径优化建议

📚 相关文档

  • 实时位置追踪: /REALTIME_LOCATION_TRACKING_COMPLETE.md
  • 作业数据记录: /OPERATION_RECORD_STATUS_SUMMARY.md
  • 地图显示状态: /MAP_DISPLAY_STATUS.md

总结

当前可用功能

  1. 轨迹回放

    • 路径: 农机管理 → 管理与调度 → 轨迹回放
    • 特点: 完整的播放控制
    • 状态: 地图占位符,其他功能完整
  2. 实时位置

    • 路径: 农机管理 → 设备监控 → 实时位置
    • 特点: 完整的地图和轨迹功能
    • 状态: 全功能可用

推荐使用

  • 快速查看: 使用 "实时位置"
  • 详细分析: 使用 "轨迹回放"
  • 导出数据: 使用 "实时位置"
  • 评估质量: 组合使用两者

创建时间: 2025-10-17
状态: 功能可用
建议: 优先使用"实时位置"功能查看真实地图轨迹!