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

414 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🗺️ 作业轨迹查看 - 访问指南
## 📍 如何查看作业轨迹
系统中有 **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`
**核心功能**:
```typescript
- 播放控制: isPlaying, setIsPlaying
- 播放速度: 0.5x, 1x, 2x, 4x, 8x
- 进度控制: progress slider
- 参数显示: 速度、面积、速率、转速
```
**当前状态**:
- ⚠️ 地图区域为占位符
- ✅ 播放控制完整
- ✅ UI界面完整
---
### 实时位置组件
**文件位置**: `/components/machinery/monitoring/RealtimeLocation.tsx`
**核心功能**:
```typescript
- 高德地图集成
- 实时位置显示
- 历史轨迹回放
- 轨迹导出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
**状态**: ✅ **功能可用**
**建议**: 优先使用"实时位置"功能查看真实地图轨迹!