【实测好用】Qt 集成百度地图完整教程:QWebEngineView 地图加载与轨迹管理实战
【实测好用】Qt 集成百度地图完整教程:QWebEngineView 地图加载与轨迹管理实战
场景切入
你想在桌面应用里嵌一张能交互的地图,却发现百度地图的 JS API 天生属于浏览器,直接往 Qt 窗口里塞根本跑不起来。这个 Qt 集成百度地图的示例仓库给你搭了一条完整通路:地图网页跑在窗口里,C++ 还能接管轨迹点。
功能速览
- 在桌面窗口内加载并显示百度地图网页
- 支持百度地图离线瓦片,弱网、内网环境也能出图
- 可设计、插入、删除轨迹点,全程可视化操作
- 可将轨迹点保存到本地文件,下次启动一键读取
- 通过 qwebchannel 实现 JS 与 C++ 双向通信
技术拆解
技术栈一句话:Qt 5.14.0 + QWebEngineView + qwebchannel,外加一套百度地图离线包。
QWebEngineView 加载百度地图的做法
它解决什么:百度地图 API 是 JS 写的,Qt 原生控件不认识它。怎么实现:用 QWebEngineView 打开项目里的 MapShow.html,等于在窗口内嵌了一个精简浏览器;地图瓦片放进 bmap-offline/tiles 目录,出图就不再依赖外网。
用 qwebchannel 打通 JS 与 C++
它解决什么:C++ 侧怎么知道用户在地图上点选了哪些位置。怎么实现:Route 类作为 QObject 暴露槽函数,JS 端通过 qwebchannel 把经纬度回传给 C++,保存、读取等操作就能由原生代码接管。
轨迹点的设计、保存与读取
它解决什么:轨迹数据不能只活在内存里。怎么实现:结构体文件定义轨迹点,Route 相关代码负责把点写入 RouteData.txt,程序重启后直接读回并画到地图上。
落地场景
- 物流系统开发者:想让客户在桌面端实时看货运动向,又不想让用户开浏览器 → 直接把地图嵌进窗口,轨迹点还能量化保存
- 外勤巡检工具作者:现场网络不稳,在线地图经常白屏 → 换成本地离线瓦片,断网也能正常显示
- 课堂演示:想讲清 JS 与 C++ 混合编程 → qwebchannel 桥接链路短、代码量小,适合逐段拆解
核心亮点
- 离线瓦片支持:地图瓦片本地化,弱网与内网环境照样出图
- 双向数据通信:qwebchannel 桥接 JS 与 C++,点选能回到原生逻辑,不是只读展示
- 轨迹可持久化:设计、插入、删除、保存、读取一条龙,重启不丢数据
- 改动点集中:地图功能集中在 MapShow.html 里改,不用翻 C++ 源码
快速上手 🚀
- 克隆仓库:
git clone https://gitcode.com/open-source-toolkit/d8a0c - 解压 QtMap.zip,在 Qt Creator 中打开 table.pro 项目(需 Qt 5.14.0+ 与 WebEngine 模块)
- 编译运行,窗口里即可看到百度地图,点选轨迹点试试
想给自己的桌面应用加地图,先跑一遍这个例子吧。
登录后查看全文