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

## 📍 如何查看作业轨迹

系统中有 **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  
**状态**: ✅ **功能可用**  
**建议**: 优先使用"实时位置"功能查看真实地图轨迹！
