【实测好用】Qt 集成百度地图完整教程:QWebEngineView 地图加载与轨迹管理实战

原创2026-11-13 23:02:272,198 阅读

【实测好用】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++ 源码

快速上手 🚀

  1. 克隆仓库:git clone https://gitcode.com/open-source-toolkit/d8a0c
  2. 解压 QtMap.zip,在 Qt Creator 中打开 table.pro 项目(需 Qt 5.14.0+ 与 WebEngine 模块)
  3. 编译运行,窗口里即可看到百度地图,点选轨迹点试试

想给自己的桌面应用加地图,先跑一遍这个例子吧。

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