→
×
RoadbookMaker - 帮助
项目介绍
RoadbookMaker是一个基于网页的地图标记和路线规划工具，允许用户在地图上添加标记点、连接路线，并导出分享您的行程规划。
项目地址: GitHub - chenxuan520/roadbook
🎬 视频介绍
核心优势
🚀 零门槛使用
- 无需API Key: 完全免费，不需要任何地图服务商的API密钥
- 无需科学上网: 国内网络环境可直接访问，无需翻墙
- 无需注册登录: 打开即用，没有任何账户体系和登录步骤
- 完全离线可用: 数据本地存储，断网也能正常使用
📱 极致体验
- 高效的键盘工作流: 提供丰富的快捷键（如 A/C/D/F）与撤销（Ctrl+Z）功能，实现行云流水般的操作体验。
- 一键系统集成: 集成携程购票、多种地图导航（百度、高德、腾讯、Google）
- 开源免费: 代码完全开源，可自由使用和修改
🏠 自托管优势
- Docker一键部署: 支持Docker快速部署，操作简单
- 完全自托管: 数据完全掌握在自己手中，隐私安全有保障
- 在线模式强大: 自托管在线版功能完整，支持云端同步和分享
- 部署零依赖: 不需要复杂的环境配置，一条命令即可运行
基本功能
- 添加标记点 - 在地图上点击或使用快捷键 A 添加标记点
- 连接标记点 - 使用快捷键 C 连接两个标记点
- 删除元素 - 选中元素后使用快捷键 D/Backspace/Del 删除标记点或连接线
- 自动调整视窗 - 使用快捷键 F 自动调整视窗以显示所有元素
- 拖拽移动 - 点击并拖拽标记点来调整位置
- 编辑详情 - 点击标记点可查看和编辑详细信息
- 查看帮助 - 使用快捷键 H / ? 打开帮助面板
- 搜索框聚焦 - 使用快捷键 / 聚焦到搜索框
- 退出添加状态 - 在添加标记点模式下按 ESC 键退出添加状态
- 导入导出 - 保存和加载路书数据
交通方式
支持多种交通方式连接标记点：
- 🚗 汽车 - 自驾出行，红色连接线
- 🚄 火车 - 铁路交通，蓝色连接线
- 🚇 地铁 - 城市轨道交通，紫色连接线
- ✈️ 飞机 - 航空出行，绿色连接线
- 🚌 公交 - 公共汽车，棕色连接线
- 🚢 游轮 - 水上航行，青色连接线
- 🚶 步行 - 步行路线，橙色连接线
快捷键
| A | 添加标记点模式 |
| C | 打开连接标记点界面 |
| D/Backspace/Del | 删除选中的标记点或连接线 |
| F | 自动调整视窗以显示所有元素 |
| H / ? | 显示帮助面板 |
| / | 聚焦到搜索框 |
| Ctrl + Z | 撤销上一步操作 |
| ESC | 退出添加标记点模式 |
详细使用说明
🗺️ 地图操作
- 地图源切换：支持7种地图源，包括OpenStreetMap、高德地图、Google地图、ESRI影像图、腾讯地图等
- 缩放和移动：鼠标滚轮缩放，拖拽移动地图
- 自动定位：首次使用会自动获取您的位置（需要授权）
- 视窗调整：按 F 键自动调整视窗显示所有标记点
📍 标记点管理
- 添加标记点：点击"添加标记点"按钮或按 A 键，然后在地图上点击
- 编辑标记点：点击标记点打开详情面板，可修改标题、图标、时间、坐标等
- 拖拽移动：直接拖拽标记点到新位置，连接线会自动更新
- 删除标记点：选中标记点后按 D 键或点击删除按钮
- 右键菜单：右键点击标记点可显示上下文菜单
- 多时间点支持：每个标记点可设置多个时间点，支持按日期分组显示
- 自定义图标：支持数字、emoji、自定义图标和颜色
🔗 连接线功能
- 创建连接：点击"连接标记点"按钮或按 C 键
- 选择方式：在弹出的对话框中选择起始点和目标点
- 交通方式：支持汽车、火车、地铁、飞机、公交、游轮、步行等多种方式
- 连接线样式：每种交通方式有独特的颜色和图标
- 详细信息：点击连接线可编辑标注、耗时、时间等信息
- 导航集成：支持生成百度、高德、腾讯导航链接
🔍 搜索功能
- 智能搜索：在搜索框输入地点名称，支持实时搜索
- 多搜索源：支持Photon、Nominatim、Overpass、高德地图、天地图等
- 搜索方式：可手动选择搜索源或使用自动分配
- 结果展示：搜索结果以下拉列表形式展示，点击可定位
- 点击图标聚焦：点击搜索后在地图上出现的临时图标，可将视图聚焦到该点。
📅 日期和时间管理
- 时间规划：为每个标记点设置具体时间点
- 多时间支持：单个标记点可设置多个时间点
- 日期分组：标记点按日期自动分组显示
- 日期筛选：支持按日期范围筛选显示标记点
- 日期备注：可为特定日期添加备注说明
- 时间线视图：在侧边栏按时间顺序显示所有标记点
💾 数据管理
- 本地存储：自动保存到浏览器本地存储，刷新不丢失
- JSON导入/导出：支持完整数据的导入导出，便于备份
- HTML导出：生成独立HTML文件，包含完整地图和数据
- ICS导出：生成标准日历文件，可导入日历应用进行提醒
- 分享功能：生成分享链接，他人可导入您的路书
- 在线模式：支持云端保存和管理路书计划（需要登录）
⌨️ 快捷键系统
支持丰富的键盘快捷键，提高操作效率：
- A - 进入添加标记点模式
- C - 打开连接标记点对话框
- D/Backspace/Del - 删除选中的标记点或连接线
- F - 自动调整视窗显示所有元素
- H / ? - 显示帮助面板
- / - 聚焦到搜索框
- ESC - 退出添加标记点模式
- Ctrl + Z - 撤销上一步操作
🌐 在线模式功能
- 用户认证：支持用户登录，JWT token认证
- 云端保存：路书计划可保存到云端
- 计划管理：支持创建、读取、更新、删除路书计划
- 双击打开计划：在计划管理界面，双击任意计划项即可快速打开该计划。
- 自动同步：在线模式下自动保存编辑内容
- 内容检查：定期检查内容变化，提示保存状态
📱 移动端适配
- 设备检测：自动检测移动设备并提供相应提示
- 响应式设计：界面适配不同屏幕尺寸
- 触摸优化：支持触摸操作
🔧 高级功能
- 撤销重做：支持操作历史记录，可撤销多步操作
- 坐标转换：自动处理中国地图坐标系转换
- 距离计算：自动计算连接线距离
- 导航集成：一键生成各种导航应用链接
- 购票服务：当交通方式为火车或飞机时，可根据路线起终点实时查询并跳转到携程购票页面。
- 酒店预订：在标记点详情中，提供Google酒店搜索链接，方便规划住宿。
- 内容探索：在标记点和连接线详情中，提供小红书搜索链接，发现更多目的地玩法。
🦄 AI 助手 (特色功能)
点击右下角的 🦄 悬浮图标唤起 AI 助手，它能通过自然语言帮您操作地图：
- 一键生成行程：
/generate 北京三日游，要看升旗和故宫
AI 会自动搜索地点、规划路线、安排时间并生成每日概览。 - 自然语言操作：
“在天安门旁边加个国家博物馆”
“把第二天上午的行程改成下午”
“删除最后那个标记点” - 快捷指令：
/generate [提示词]- 根据描述生成完整行程/xiaohongshu [提示词]- 将当前行程导出为小红书文案（可选风格偏好）/clear- 清空对话历史/help- 查看可用指令
- 智能辅助：
遇到模糊地点会自动搜索；可以为每天的行程添加总结备注。
💡 使用技巧
- 快速开始：先添加几个标记点，然后用连接线串联起来
- 时间规划：为标记点设置合理的时间，便于行程安排
- 图标选择：使用emoji图标让标记点更直观
- 颜色搭配：不同交通方式使用不同颜色，便于区分
- 定期保存：重要修改后建议手动导出备份
- 分享协作：使用分享功能与他人协作编辑路书