【永久免费】Qt 5.14.0 如何调用百度地图 API?QWebEngineView 嵌入地图与轨迹管理完整指南
【永久免费】Qt 5.14.0 如何调用百度地图 API?QWebEngineView 嵌入地图与轨迹管理完整指南
本示例项目基于 Qt 5.14.0 与 QWebEngineView 嵌入百度地图 API,实现地图显示和轨迹点的设计、插入、删除、保存与读取,为桌面端地图集成提供可直接编译运行的参考工程。
为什么桌面应用需要内嵌百度地图
物流调度、位置服务和地理信息系统(GIS)类桌面程序,通常要在窗口里直接展示地图并标记物体位置。如果从零自绘地图渲染,工作量很大;而直接内嵌百度地图的网页端能力,则可以利用其现成的瓦片渲染、缩放控制和坐标拾取,把开发重点放在业务数据上。本项目正是这条路线的实现:用 Qt 的 WebEngine 控件承载百度地图页面,再用 JavaScript 与 C++ 的桥接把轨迹数据传回桌面程序处理。
核心设计:QWebEngineView 嵌入百度地图 API 与轨迹数据流
工程名为 table(入口文件 table.pro),依赖 webengine、webenginewidgets 模块,编译标准为 C++11。关键实现分四层:
- 页面承载:QWebEngineView 加载
MAP/MapShow/MapShow.html,这是配置了百度地图 API 的地图页面,配合 layer.js 做布局、qwebchannel.js 做通信。要调整地图交互,主要改这个 HTML。 - JS 与 C++ 通信:通过 QWebChannel 机制,页面里的 JavaScript 调用 C++ 侧
Route类的acceptSaveData(int id, double lon, double lat, int num)槽函数,用户每在地图上点一个点,坐标就进入 C++ 侧缓冲。 - 轨迹存储:数据放在
StrRouteWay结构体(字段为 id、lon、lat、num)构成的 256 点数组中,支持设计、插入和删除轨迹点。 - 保存与读取:
SaveData将轨迹写成制表符分隔的 txt 文件(仓库内的 RouteData.txt 即样例,经度约 87.06~87.12、纬度约 42.18~42.22);ReadRoute通过 QFileDialog 选文件后逐行解析回填,实现轨迹的持久化与复现。 - 离线支持:
MAP/bmap-offline目录内置百度地图离线 SDK(map3.0.js 及 modules),瓦片文件夹复制进来后可在无网络环境显示地图。
四步跑起 QtMap 地图演示
- 安装 Qt 5.14.0 及以上版本,勾选 Qt WebEngine 模块,并准备支持 C++11 的编译器。
- 克隆仓库:
git clone https://gitcode.com/open-source-toolkit/d8a0c。 - 在百度地图开放平台注册账号,申请地图 AK(密钥),并填入项目对应的配置位置。
- 解压仓库中的 QtMap 源码包,用 Qt Creator 打开
table.pro工程,编译并运行。
三类典型场景实践
- 物流车辆航迹记录:调度员在地图上逐点点击标记车辆途经位置,点击保存后生成航迹 txt;次日选择该文件重新加载,即可在地图上恢复整条航迹,用于回放或比对。
- 无网环境下的 GIS 录入:外业人员把瓦片文件夹拷入
bmap-offline目录后离线运行,在本地地图上采集坐标点并导出 txt,回单位后导入内网系统。 - 轨迹数据交换:因为保存格式是制表符分隔的纯文本(编号、经度、纬度),可直接用 Excel 或脚本做二次加工,不必经过专有格式转换。
与原生 SDK 集成方案的差异及扩展点
与直接封装百度地图原生 C++ SDK 的做法相比,本方案不引入第三方地图库,地图能力完全由 Web 页面提供,依赖只限于 Qt 自身的 WebEngine 组件,Windows、macOS、Linux 下行为一致。可在此基础上继续扩展:
- 将保存路径改为用户可选目录,替代源码中写死的桌面路径;
- 把 256 点上限的静态数组换成动态容器,支持更长轨迹;
- 利用页面内 DrawingManager、测距等插件,增加轨迹折线绘制与距离量算;
- 通过 QWebChannel 反向调用(C++ 调 JS)实现实时定位点的动态刷新。
常见坑位与参考资源
- AK 未生效或域名白名单不匹配时,地图瓦片不会加载,先核对密钥配置。
SaveData默认写入写死的 Windows 桌面路径,跨环境使用前需改为相对路径或对话框选路。- 离线显示需要手动补齐瓦片目录,
bmap-offline包内默认只带 SDK 与控件资源。 - 项目说明见 README.md,完整源码与离线地图文件在 QtMap.zip 中。
如需在自己的工程中集成百度地图 API,可直接以该工程为起点改造页面与轨迹数据结构。
登录后查看全文