【保姆级打包】Qt集成百度地图API实战:QWebEngineView 桌面轨迹管理完整指南
【保姆级打包】Qt集成百度地图API实战:QWebEngineView 桌面轨迹管理完整指南
这篇带你走通 Qt 5.14.0 桌面应用集成百度地图API的完整过程:用 QWebEngineView 内嵌地图窗口,再用 QWebChannel 桥接 C++ 与 JavaScript,实现轨迹点的新增、删除与 TXT 保存读取,拿到一份可直接复用的轨迹管理示例。
🗺️ 它解决了什么问题
想在桌面应用里放一张可交互的地图,通常只有两条路:引入体积庞大的第三方地图 SDK,或干脆内嵌一个浏览器窗口。可一旦要在地图上增删轨迹点、还要把坐标落盘成文件,两条路都得自己搭桥。这个项目把这条链路做完了:C++ 侧负责轨迹点的存取,地图页面负责实时重绘,中间靠 QWebChannel 打通。对想搞懂 Qt WebEngine 与 JS 互调的读者,它是个麻雀虽小五脏俱全的样本。
🚀 先跑起来:效果与快速上手
仓库里源码和资源打包在 QtMap.zip 中,解压后得到 QtMap 工程目录(含 MAP 资源目录)和一份效果图截图。主界面就是一张地图窗口,右侧竖排"保存、删除、插入、读航迹文件"四个按钮,地图本身基于百度地图离线包渲染。
最简运行路径:
- 克隆仓库:
git clone https://gitcode.com/open-source-toolkit/d8a0c - 解压 QtMap.zip 到当前目录
- 确认环境装有 Qt 5.14.0 及 WebEngine 模块
- 用 Qt Creator 打开 table.pro(位于 QtMap/QtMap 目录)
- 将 MAP 资源目录与编译产物保持在同级目录,点击运行
Qt百度地图API主界面:内嵌地图与保存、删除、插入按钮
截图文件名为中文,若在你系统上显示乱码,直接从 zip 包内按顺序提取即可。
🧩 功能拆解:它到底能做什么
不靠浏览器,怎么在桌面显示百度地图
程序启动时创建 QWebEngineView,加载本地的 MapShow.html;该页面引用的是仓库自带 bmap-offline 离线包里的百度地图 JS API,直接渲染地图,不依赖公网和第三方 SDK。想在自己应用里内嵌地图的开发者,照这份资源组织方式抄作业即可。
轨迹点怎么插入:每点一组经纬度
点右侧"插入"会弹出经纬度输入框,填入数值确认后,地图上出现一个带序号的标记,所有标记再用折线连成轨迹。JS 端把坐标经通道发回 C++,存入本地数组,供后续保存使用——适合做航线、巡检路线这类离散点位设计。
Qt百度地图API插入轨迹点:经纬度输入对话框
轨迹点怎么删除:按序号精确移除
点"删除"后输入要删除的序号,确认即移除对应标记并重新连线;信息框会回显该点的经纬度,便于核对删对了没有。做轨迹修正时,这种按序号的确定性操作比鼠标点选更可靠。
Qt百度地图API删除轨迹点:按序号删除弹窗与坐标回显
轨迹文件怎么存与读:TXT 三列格式
"保存"把全部轨迹点写成 TXT,每行一列"序号、经度、纬度";"读航迹文件"弹出文件选择框,选完 TXT 后解析点位并在地图上重绘整条轨迹。轨迹数据先导出再交接,适配数据需要流向其他系统的场景。
Qt百度地图API读取航迹文件后在地图上重绘整条轨迹
⚙️ 技术实现:底层是怎么工作的
- 本地网页加载:mainwindow.cpp 创建 QWebEngineView,以
file://方式加载 MAP/MapShow/MapShow.html,页面内嵌百度地图 JS API,绕开公网依赖。 - QWebChannel 双向桥接:Route 对象以 "Route" 注册到通道,JS 端调用
acceptSaveData把坐标送回 C++;C++ 端则用runJavaScript调accept_ReadData、Read_addPoint等函数驱动地图重绘。 - 离线地图包:bmap-offline 目录内置 map3.0.js 与瓦片切片,断网环境地图也能正常显示,省去了申请在线密钥的折腾。
- 轨迹数据结构:StrRouteWay 存 id/lon/lat,固定 256 点的数组容量,TXT 采用制表符分隔三列,读写逻辑集中在 Route.cpp。
🏭 能用在哪些真实场景
- 物流路线规划:运营在桌面端设计行驶路线,存成 TXT 交给调度系统,改线只需换文件。
- GIS 二次开发:开发者拿它当 QWebChannel 桥接模板,直接省去 C++/JS 互调的试错成本。
- Qt 入门学习:新手可以借它一次看懂 WebEngine 页面加载、离线资源与 JS 通信三件事。
上手建议与延伸
- 先改保存路径:Route.cpp 中保存路径写死在原作者电脑的桌面,运行前改成自己的目录;读航迹文件同样要求"序号 经度 纬度"三列 TXT,格式对不上会解析失败。
- 再读两个关键文件:MapShow.html 承载全部前端交互逻辑,Route.cpp 承载轨迹读写,两者对照看,整条 C++/JS 通信链就通了;想继续深入,可顺 QWebChannel 模块文档把信号槽换成 QMetaObject 方式注册。
界面只有四个按钮,但 C++ 与 JS 的通信链路是完整闭环。作为桌面地图集成的起点样本,够用。