【资源自取】Qt 5.14.0 集成百度地图API:3步在桌面应用里嵌入可交互地图与轨迹管理

原创2026-11-13 20:56:291,339 阅读

【资源自取】Qt 5.14.0 集成百度地图API:3步在桌面应用里嵌入可交互地图与轨迹管理

这个示例项目基于 Qt 5.14.0,演示了如何在桌面应用中调用百度地图API:用 QWebEngineView 加载百度地图网页,通过 QWebChannel 打通 JavaScript 与 C++ 的双向通信,并附带一套轨迹点的设计、插入、删除、保存与读取功能,可以直接当作 Qt 加载百度地图的工程参照。

桌面应用里加一张能点的地图,要绕多少弯路?

如果你需要在自己的桌面程序里放一张能缩放、能点选的地图,可选路线并不多。一是引入第三方 C++ 地图库,依赖重、文档分散;二是自己画瓦片,坐标转换、缩放级别全要自己实现。更省事的一条路是:地图本身就用现成的网页版 API,桌面应用只负责给它套个壳,再用消息通道跟它说话。这个例子做的就是这件事,而且把"在地图上标点、管理轨迹"这种真实业务也一并做完了。

项目定位

这个项目的定位很单一:给想在 Qt 桌面程序里集成百度地图的开发者一份能直接跑的工程示例。它要解决的问题是两件事——地图怎么嵌进窗口,以及嵌进去之后 C++ 侧的程序怎么和地图页面互相通信。

技术路线分三层:界面层用 QWebEngineView 把百度地图 3.0 的离线网页装进主窗口;通信层用 QWebChannel 让页面里的 JS 直接调用 C++ 对象,C++ 也能反向执行 JS;业务层则围绕轨迹点,实现了插入、删除、存成 txt、读回来重画的全链路。

工作原理

离线地图网页的加载

项目没有走在线接口,而是把百度地图 3.0 的 JS 库、离线模块和瓦片全部打包在 MAP/bmap-offline 目录里,页面主体是 MAP/MapShow/MapShow.html。C++ 侧在 MapIni() 里创建 QWebEngineView,用 file 协议加载这个 html 即可显示地图。改地图交互逻辑只需要动这一个文件,离线瓦片单独放目录,换图也很方便。

QWebChannel 打通 JS 与 C++ 双向通信

通信的核心代码不长:

channel->registerObject("Route", (QObject*)myRoute);
mainMap_view->page()->setWebChannel(channel);

registerObject 一行之后,页面上的 JS 就能像调用本地对象一样访问 C++ 侧的 Route。反方向则用 runJavaScript 把拼接好的坐标字符串发回页面,再执行页面里定义的画点函数,C++ 到 JS 这一路就通了。

轨迹点的插入、删除、保存与读取

轨迹点走的是完整生命周期。在地图上点选位置时,JS 把经纬度送进 C++ 侧的 acceptSaveData 槽函数,写入轨迹数组;界面提供删除点位;点保存后,数据按"编号、经度、纬度"的 tab 分隔格式写入 RouteData.txt;再选文件读取时逐行解析坐标,重新在地图上绘制。文件格式简单到外部系统可以直接读,这也是它作为对接示例的价值。

适用场景

  • 物流与车辆监控:把实时坐标点送进地图页面渲染,轨迹保存/读取对应导出与回放。
  • 航路与巡检路线规划:右键菜单里的"航线居中"和点位增删,就是典型的规划交互。
  • GIS 业务原型:不想引入重型 GIS 库时,用 Qt 5.14.0 百度地图的这套组合先把功能验证出来。

上手指引

代码获取:

git clone https://gitcode.com/open-source-toolkit/d8a0c

环境要求是 Qt 5.14.0 及 WebEngine 模块,用 Qt Creator 打开工程编译运行即可;地图 Key 需自行申请并配置。项目入口在 QtMap/QtMap/table.pro;轨迹的增删和文件读写集中在 Route.h / Route.cpp,地图加载与通信初始化在 mainwindow.cpp,页面逻辑在 QtMap/QtMap/MAP/MapShow/MapShow.html。README 里附有 CSDN 文章的入口,其中有运行演示截图和踩坑说明,建议对着看。

项目亮点

  • 离线可用的地图资产:百度地图 3.0 JS 库加瓦片全在本地的 MAP 目录,不依赖在线服务,也方便换图。
  • 一行注册的双向桥:QWebChannel 的 registerObject 是全部通信的支点,C++ 调 JS 用 runJavaScript,套路通用,换别的地图 API 同样成立。
  • 轨迹闭环而非演示:插点、删点、存 txt、读回重画都真实可用,数据格式简单稳定。
  • 零第三方 C++ 依赖:整条链路只用 Qt 标准模块,基于 Qt 5.14.0 编译即可复现。

写在最后

我的建议是先完整跑一遍,再动代码:第一次只看 MapIni 的加载流程和 acceptSaveData 的数据流向,这两段看明白,整个项目就通了。改动尽量集中在 MapShow.html 和 Route.cpp 两个文件里,风险最小。如果地图白屏,先查离线瓦片目录是否完整、Key 是否正确配置。需要更多细节时,README 里给出的 CSDN 文章里有完整演示截图,照着排查效率更高。

登录后查看全文
Qt5.14.0实现百度地图API调用指南