# com-luck-MapRoutePlanning

**Repository Path**: lwhou/com-luck-MapRoutePlanning

## Basic Information

- **Project Name**: com-luck-MapRoutePlanning
- **Description**: 地图线路规划
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-09
- **Last Updated**: 2025-10-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 地图路线规划模块

## 功能说明

本模块提供多种地图服务商的路线规划后端接口，目前支持百度地图和高德地图，支持驾车、步行、骑行三种路线类型，并支持多种路线偏好设置。

## 目录结构

```
map/
├── controller/                    # 控制器层
│   ├── baidu_map_controller.py   # 百度地图路由控制器
│   └── gaode_map_controller.py   # 高德地图路由控制器
├── model/                        # 数据模型层
├── service/                      # 服务层
│   ├── baidu/                   # 百度地图实现
│   │   └── baidu_map_service.py
│   └── gaode/                   # 高德地图实现（占位符）
│       └── gaode_map_service.py
└── README.md
```

## 接口说明

### 百度地图路线规划接口

- **URL**: `/map/baidu/route`
- **方法**: POST
- **请求头**: `Content-Type: application/json`
- **请求参数**:

```json
{
  "origin": "纬度,经度",        // 起点坐标
  "destination": "纬度,经度",   // 终点坐标
  "route_type": "driving",     // 路线类型: driving(驾车)、walking(步行)、riding(骑行)
  "preference": "0"            // 路线偏好: 0(默认)、2(距离最短)等
}
```

### 高德地图路线规划接口

- **URL**: `/map/gaode/route`
- **方法**: POST
- **请求头**: `Content-Type: application/json`
- **请求参数**:

```json
{
  "origin": "纬度,经度",        // 起点坐标
  "destination": "纬度,经度",   // 终点坐标
  "route_type": "driving",     // 路线类型: driving(驾车)、walking(步行)、riding(骑行)
  "preference": "0"            // 路线偏好: 0(默认)、2(距离最短)等
}
```

- **响应示例**:

```json
{
  "code": 0,
  "msg": "操作成功",
  "data": {
    // 地图API返回的完整数据
  }
}
```

## 配置说明

在 `LuckConfig.json` 配置文件中添加地图AK:

```json
{
  "baidu_map_ak": "YOUR_BAIDU_MAP_AK_REPLACE_WITH_YOUR_OWN",
  "gaode_map_ak": "YOUR_GAODE_MAP_AK_REPLACE_WITH_YOUR_OWN"
}
```

**重要提示**: 
1. 请将 `YOUR_BAIDU_MAP_AK_REPLACE_WITH_YOUR_OWN` 替换为您自己的百度地图AK
2. 请将 `YOUR_GAODE_MAP_AK_REPLACE_WITH_YOUR_OWN` 替换为您自己的高德地图AK
3. 百度地图AK需要在百度地图开放平台申请，并确保开启了相关服务

## 路线偏好参数说明

### 百度地图

| 值 | 说明 |
|---|---|
| 0 | 默认 |
| 2 | 距离最短（只返回一条路线，不考虑限行和路况，距离最短且稳定，用于估价场景） |
| 3 | 不走高速 |
| 4 | 高速优先 |
| 5 | 躲避拥堵 |
| 6 | 少收费 |
| 7 | 躲避拥堵 & 高速优先 |
| 8 | 躲避拥堵 & 不走高速 |
| 9 | 躲避拥堵 & 少收费 |
| 10 | 躲避拥堵 & 不走高速 & 少收费 |
| 11 | 不走高速 & 少收费 |
| 12 | 距离优先（考虑限行和路况，距离相对短且不一定稳定） |
| 13 | 时间优先 |

## 使用示例

### 前端调用示例

```javascript
// 使用百度地图
fetch('http://127.0.0.1:5012/map/baidu/route', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    origin: "39.908860,116.397390",
    destination: "39.999151,116.275350",
    route_type: "driving",
    preference: "0"
  })
})
.then(response => response.json())
.then(data => {
  // 处理返回的路线数据
});

// 使用高德地图（实现后）
fetch('http://127.0.0.1:5012/map/gaode/route', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    origin: "39.908860,116.397390",
    destination: "39.999151,116.275350",
    route_type: "driving",
    preference: "0"
  })
})
.then(response => response.json())
.then(data => {
  // 处理返回的路线数据
});
```