本技能提供汽车燃油价格与新能源充电站的全方位查询、对比、推荐服务,帮助用户做出最优的出行能源决策。
| 功能模块 | 支持内容 | 数据来源 |
|---------|---------|---------|
| 油价查询 | 92#、95#、98#汽油,0#/-10#/-20#/-35#柴油 | 国家发改委 + 多源API聚合 |
| 油价对比 | 跨省份、跨城市价格差异分析 | 全国31省市实时数据 |
| 油价趋势 | 历史价格走势图 + 涨跌预测 | 近12个月历史数据 |
| 充电站查询 | 国家电网、特来电、星星充电等主流平台 | 多平台数据聚合 |
| 充电价格 | 电费 + 服务费分项展示,尖峰平谷电价 | 各运营商实时报价 |
| 位置匹配 | 基于用户位置的最近站推荐 | 高德/百度地图POI |
| 路线规划 | 沿途加油/充电点优化推荐 | 导航路线算法 |
| 成本计算 | 燃油车 vs 电动车出行费用对比 | 综合能耗模型 |
```bash
python scripts/fuel_price.py --action query --fuel_type <类型> --province <省份> --city <城市>
```
参数说明:
--action: query(查询) / compare(对比) / trend(趋势) / predict(预测)
--fuel_type: 92 / 95 / 98 / diesel0 / diesel_10 / diesel_20 / diesel_35
--province: 省份名称(可选,默认全国概览)
单地查询示例:
```
📊 [城市] 今日油价报告 (更新时间: YYYY-MM-DD HH:mm)
┌────────────┬──────────┬──────────┬─────────┐
│ 油品型号 │ 元/升 │ 较昨日 │ 较上周 │
├────────────┼──────────┼──────────┼─────────┤
│ 92号汽油 │ 7.52 │ ▲ 0.05 │ ▲ 0.15 │
│ 95号汽油 │ 8.01 │ ▲ 0.06 │ ▲ 0.18 │
│ 98号汽油 │ 9.31 │ ▲ 0.07 │ ▲ 0.21 │
│ 0号柴油 │ 7.14 │ ▲ 0.05 │ ▲ 0.16 │
└────────────┴──────────┴──────────┴─────────┘
💡 下次调价日: YYYY-MM-DD (预计涨/跌约X元)
```
多地区对比示例:
```
🗺️ [油品] 全国TOP10 低价省份 (YYYY-MM-DD)
排名 | 省份 | 价格(元/升) | 与均价差 | 推荐指数
────────────────────────────────────────────────
1 | 陕西 | 7.23 │ -0.29 | ⭐⭐⭐⭐⭐
2 | 新疆 | 7.25 │ -0.27 | ⭐⭐⭐⭐⭐
...
```
```bash
python scripts/charging_station.py \
--action search \
--location "<经度,纬度>" or "<地址>" \
--radius <公里数> \
--type
--operator
```
参数说明:
--action: search(搜索) / compare(比价) / route(沿途) / detail(详情)
--location: 经纬度坐标或地址文本
--radius: 搜索半径(km),默认5km
--type: dc(直流快充) / ac(交流慢充) / all
--operator: 运营商ID(见下表)
| ID | 运营商 | 说明 |
|----|--------|------|
| 1 | 国家电网(e充电) | 覆盖最广,高速服务区主力 |
| 2 | 特来电(TELD) | 数量最多,商场停车场密集 |
| 3 | 星星充电 | 社区覆盖好 |
| 4 | 蔚来(NIO) | 蔚来车主专属+超充 |
| 5 | 特斯拉(Tesla) | 特斯拉专用 |
| 6 | 小鹏 | 小鹏车主专属 |
| 7 | 云快充 | 第三方聚合平台 |
| 8 | 南方电网 | 南方区域主力 |
| 0 | 全部 | 不限运营商 |
附近充电站列表:
```
🔋 附近充电站 (
┌──────┬─────────────┬──────┬────────┬────────┬──────────┬────────┐
│ 排名 │ 站点名称 │距离 │ 价格 │ 空闲桩 │ 运营商 │ 评分 │
├──────┼─────────────┼──────┼────────┼────────┼──────────┼────────┤
│ 1 │ XX充电站 │ 0.8k │ 1.2元/度│ 8/12 │ 特来电 │ 4.8 │
│ 2 │ XX充电站 │ 1.2k │ 0.98元/度│ 15/20 │ 电网 │ 4.9 │
└──────┴─────────────┴──────┴────────┴────────┴──────────┴────────┘
💰 价格说明: 电费 X.XX元/度 + 服务费 X.XX元/度 = 总价 X.XX元/度
📱 导航: 复制地址打开地图导航
```
价格明细展开:
```
📋 [站点名称] 详细价格信息
┌─────────────┬──────────┬──────────┬──────────┐
│ 时段 │ 电费(元/度)│ 服务费 │ 合计 │
├─────────────┼──────────┼──────────┼──────────┤
│ 尖峰(XX-XX) │ 1.25 │ 0.40 │ 1.65 │
│ 峰时(XX-XX) │ 1.00 │ 0.40 │ 1.40 │
│ 平时(XX-XX) │ 0.65 │ 0.40 │ 1.05 │
│ 谷时(XX-XX) │ 0.35 │ 0.40 │ 0.75 │
└─────────────┴──────────┴──────────┴──────────┘
✅ 最佳充电时段: 谷时 XX:00-XX:00 (仅0.75元/度)
```
```bash
python scripts/route_planner.py \
--start "<起点>" \
--end "<终点>" \
--vehicle_type
--range_km <续航里程> \
--prefer
```
> 🆕 腾讯地图升级: 配置 TENCENT_MAP_CONFIG["key"] 后,路线规划将自动:
> - 使用真实驾车距离(非直线估算)
> - 沿线搜索真实充电站/加油站/服务区
> - 返回预计时间、过路费等详细信息
>
> 腾讯地图独立测试命令:
> ```bash
> python scripts/tencent_maps.py --health-check # 健康检查
> python scripts/tencent_maps.py --search-charging -l "116.39,39.92" # 搜充电站
> python scripts/tencent_maps.py --route --from "北京" --to "武汉" # 规划路线
> python scripts/tencent_maps.py --along-route --from "北京" --to "武汉" # 沿线搜索
> ```
```
🗺️ 补能路线规划: [起点] → [终点] (全程 XXX km)
🚗 车辆: [车型] | 续航: XXXkm | 当前电量/油量: XX%
┌────┬─────────────────┬────────┬────────┬──────────┬─────────┐
│ # │ 推荐站点 │ 途经点 │ 累计km │ 预计费用 │ 备注 │
├────┼─────────────────┼────────┼────────┼──────────┼─────────┤
│ 1 │ XX加油站/充电站 │ XX服务区│ 180 │ ¥XXX │ 必停 │
│ 2 │ XX加油站/充电站 │ XX出口 │ 380 │ ¥XXX │ 可选 │
└────┴─────────────────┴────────┴────────┴──────────┴─────────┘
💰 总计补能费用: 约 ¥XXX
⏱️ 预计补能耗时: 约 X小时X分钟
📊 方案对比:
┌──────────┬──────────┬──────────┬──────────┐
│ 方案 │ 费用 │ 时间 │ 便利性 │
├──────────┼──────────┼──────────┼──────────┤
│ 最省钱 │ ¥XXX │ Xh Xm │ ★★★☆☆ │
│ 最快捷 │ ¥XXX │ Xh Xm │ ★★★★☆ │
│ 最均衡 │ ¥XXX │ Xh Xm │ ★★★★★ │
└──────────┴──────────┴──────────┴──────────┘
```
```bash
python scripts/cost_calculator.py \
--fuel_car "<油耗L/100km>" \
--ev_car "<电耗kWh/100km>" \
--annual_km <年里程> \
--years <年限> \
--province <省份>
```
```
💵 油电成本全面对比 (年行驶 XX,000km · [省份]油价)
┌─────────────────────┬──────────────┬──────────────┐
│ 对比项 │ 燃油车 │ 电动汽车 │
├─────────────────────┼──────────────┼──────────────┤
│ 百公里能耗 │ X.X L汽油 │ XX kWh电 │
│ 单次补能费用 │ ¥XXX (满油) │ ¥XX (满电) │
│ 百公里费用 │ ¥XX.XX │ ¥XX.XX │
│ 年燃料费用 │ ¥XX,XXX │ ¥X,XXX │
├─────────────┬───────┴──────────────┴──────────────┤
│ 年节省金额 │ 💚 省 ¥XX,XXX │
│ N年总节省 │ 💚 省 ¥XX,XXX │
└─────────────┴────────────────────────────────────┘
📈 盈亏平衡分析:
• 电动车溢价: ¥XX,XXX (相比同级燃油车)
• 回本周期: 约 X.X 年 (X万公里)
• 第N年起净赚!
⚠️ 其他考虑因素:
```
| 数据源 | 用途 | 优势 | Key 申请 |
|--------|------|------|----------|
| 🗺️ 腾讯地图 | 路线规划、地点搜索、沿线搜索、地理编码 | 沿线 POI 搜索独有优势 | lbs.qq.com/console |
| 高德地图 | 周边搜索 POI | 覆盖广 | console.amap.com |
| 百度地图 | 备用 POI 数据 | 补充数据源 | lbsyun.baidu.com |
> 💡 推荐配置腾讯地图 Key:它提供独有的「沿途搜索」能力,可沿驾车路线自动查找充电站/加油站/服务区,非常适合长途出行补能规划!
编辑 scripts/config.py 存储API密钥:
# ==================== 地图API配置 ====================
TENCENT_MAP_CONFIG = {
"key": "你的腾讯位置服务Key", # ⭐ 推荐!支持路线规划+沿线搜索
# 申请地址: https://lbs.qq.com/console/key/manage
}
AMAP_CONFIG = {
"key": "你的高德地图API Key",
# 申请地址: https://console.amap.com/dev/key/app
}
环境变量方式:
export TENCENT_MAP_KEY="你的Key" # 覆盖配置文件
| API | 端点 | 功能 | 应用场景 |
|-----|------|------|----------|
| 地点搜索 | /ws/place/v1/search | 周边/城市内 POI 搜索 | 找附近充电站 |
| 驾车路线规划 | /ws/direction/v1/driving/ | 两点间真实驾车路径 | 精准距离/时间/费用 |
| ⭐ 沿途搜索 | /ws/place/v1/searchalongroute | 沿路线搜索 POI | 长途补能规划核心! |
| 关键词提示 | /ws/place/v1/suggestion | 输入框自动补全 | 地址联想 |
| 地理编码 | /ws/geocoder/v1/ | 地址↔坐标转换 | 文本定位 |
| 逆地址解析 | /ws/geocoder/v1/ | 坐标→地址描述 | 定位展示 |
| 距离矩阵 | /ws/distance/v1/matrix | 批量距离计算 | 多点对比 |
},
"charging": {
"amap_poi_url": "https://restapi.amap.com/v3/place/around",
"teld_api": "",
"star_charge_api": ""
}
}
## 油品知识参考
详细油品规格、适用车型、季节选择等信息请参阅 `references/fuel_knowledge.md`。
## 充电知识参考
充电标准、充电速度、运营商特点等信息请参阅 `references/charging_knowledge.md`。
## 使用建议
1. **首次使用**: 先运行一次无参数查询,确认API连接正常
2. **位置服务**: 允许位置权限可获得更精准的附近站点推荐
3. **价格时效**: 油价每日7点更新,充电价格实时变动
4. **数据免责**: 价格仅供参考,实际以现场为准
共 1 个版本