# 高德地图路径规划功能使用指南

## 功能概述

本应用集成了高德地图的路径规划API，提供多种路线规划方式，包括驾车、步行、骑行和直线路径。

## 支持的路线类型

### 1. 驾车路线
- **特点**：基于实际道路网络的驾车路径
- **适用场景**：车辆支援、物资运输
- **优势**：考虑交通规则、道路限制、实时路况
- **要求**：需要网络连接

### 2. 步行路线
- **特点**：适合步行者的路径规划
- **适用场景**：人员徒步支援、侦察任务
- **优势**：避开机动车道，选择人行道
- **要求**：需要网络连接

### 3. 骑行路线
- **特点**：适合骑行的路径规划
- **适用场景**：快速机动支援
- **优势**：考虑自行车道，避开高速公路
- **要求**：需要网络连接

### 4. 直线路径（离线）
- **特点**：简单的直线连接
- **适用场景**：网络不可用时的备用方案
- **优势**：无需网络，计算快速
- **限制**：不考虑实际道路情况

## 使用方法

### 步骤1：创建部署支援任务
1. 在地图界面点击"部署支援"按钮
2. 在任务管理界面点击"新建任务"
3. 填写任务基本信息

### 步骤2：选择起点和终点
1. 选择目标敌人（终点）
2. 选择一个或多个驻扎点（起点）

### 步骤3：规划路线
1. 点击"规划路线"按钮
2. 在弹出的对话框中选择路线类型：
   - **驾车路线**：适合车辆支援
   - **步行路线**：适合人员徒步
   - **骑行路线**：适合快速机动
   - **直线路径**：离线备用方案

### 步骤4：查看路线预览
- 系统会在地图上显示规划的路线
- 显示路线数量统计
- 路线以蓝色线条显示

### 步骤5：保存任务
- 点击"保存任务"完成创建
- 路线数据会保存到本地数据库

## 技术实现

### API集成
```java
// 驾车路线规划
routePlanningService.planDriveRoute(start, end);

// 步行路线规划
routePlanningService.planWalkRoute(start, end);

// 骑行路线规划
routePlanningService.planRideRoute(start, end);
```

### 数据处理
- 路线坐标点转换为地图可显示的LatLng格式
- 距离和时间信息自动计算
- 支持多条路线同时规划

### 错误处理
- 网络异常时自动回退到直线路径
- 详细的错误信息提示
- 异常情况的友好处理

## 配置要求

### 网络权限
```xml
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```

### 高德地图API Key
确保在AndroidManifest.xml中配置了有效的API Key：
```xml
<meta-data
    android:name="com.amap.api.v2.apikey"
    android:value="your_api_key_here"/>
```

### SDK依赖
```gradle
implementation 'com.amap.api:search:9.5.0'
```

## 性能优化

### 路线缓存
- 规划的路线会保存到本地数据库
- 避免重复的网络请求
- 提高应用响应速度

### 批量规划
- 支持多条路线同时规划
- 异步处理，不阻塞UI
- 进度反馈和状态管理

### 内存管理
- 及时释放不需要的路线对象
- 避免内存泄漏
- 优化地图显示性能

## 注意事项

### 网络要求
1. **在线规划**：驾车、步行、骑行路线需要网络连接
2. **离线备用**：直线路径可在离线状态下使用
3. **网络质量**：网络不稳定可能影响规划成功率

### API限制
1. **请求频率**：注意高德地图API的请求频率限制
2. **配额管理**：合理使用API配额
3. **错误处理**：妥善处理API返回的错误

### 数据准确性
1. **坐标精度**：确保起点和终点的坐标准确性
2. **实时性**：路线规划基于当前地图数据
3. **路况变化**：实际路况可能与规划结果有差异

## 扩展功能

### 未来计划
1. **实时路况**：集成实时交通信息
2. **多路径选择**：提供多条可选路线
3. **路况预测**：基于历史数据的路况预测
4. **3D路线显示**：支持3D路线可视化

### 自定义配置
1. **路线偏好**：用户可设置路线偏好
2. **避让设置**：避开特定区域或道路
3. **时间窗口**：指定出发时间进行规划

## 故障排除

### 常见问题
1. **路线规划失败**
   - 检查网络连接
   - 验证API Key有效性
   - 确认坐标点有效性

2. **路线显示异常**
   - 检查地图初始化
   - 验证坐标转换
   - 确认权限设置

3. **性能问题**
   - 减少同时规划的路线数量
   - 检查内存使用情况
   - 优化数据库查询

### 调试方法
1. **日志查看**：查看应用日志获取详细错误信息
2. **网络测试**：测试网络连接和API访问
3. **坐标验证**：验证起点和终点坐标的正确性