一、前言
离线地图的核心其实就是拿到这些瓦片地图文件，并不是离线地图的代码怎么写，其实离线地图的网页代码和在线地图的网页代码几乎一致的，主要就是将对应的依赖的js文件从在线的地址改成本地的地址，然后可能多几个特殊的js文件用来本地交互，离线地图完全具备在线地图的大部分功能，离线地图有个好处就是可以离线使用，根本不需要联网，而且也不需要什么秘钥，你只要搞到那些瓦片地图文件就随便你怎么摩擦了。其实在线地图也是通过读取服务器上的离线地图文件加载到网页中的，你在快速的缩放和拖动地图的时候可以看到缝隙和空白，估计此刻就是在从服务器拉取瓦片地图文件来加载，而且这个服务器上的瓦片地图永远是最新的最完整的。
离线地图相比于在线地图有这么几个地方要注意，一个是设置地图中心点默认只支持经纬度坐标而不支持城市名称，在线的城市名称是可以的那是因为服务器会给你自动转换成经纬度，离线地图如果也想这样的话需要自己写一个js文件专门用于枚举罗列出来各个城市对应的经纬度坐标，传入城市名称查询经纬度，然后再去设置地图中心点。还一个要注意的是获取指定行政区域名称获取边界的，这个在线地图也是服务器去执行的，而离线地图就没有这个功能，总之可以想到的需要通过服务器执行的，离线地图就直接做不到，需要自己额外编写js代码去实现，在官方提供的离线地图的js文件夹中是没有对应的文件。
二、功能特点
- 同时支持在线地图和离线地图两种模式。
- 同时支持webkit内核、webengine内核、IE内核。
- 支持设置多个标注点，信息包括名称、地址、经纬度。
- 可设置地图是否可单击、拖动、鼠标滚轮缩放。
- 可设置协议版本、秘钥、主题样式、中心坐标、中心城市、地理编码位置等。
- 可设置地图缩放比例和级别，缩略图、比例尺、路况信息等控件的可见。
- 支持地图交互，比如鼠标按下获取对应位置的经纬度。
- 支持查询路线，可设置起点位置、终点位置、路线模式、路线方式、路线方案（最少时间、最少换乘、最少步行、不乘地铁、最短距离、避开高速）。
- 可显示点线面工具，可直接在地图上划线、点、矩形、圆形等。
- 可设置行政区划，指定某个城市区域绘制图层，在线地图自动输出行政区划边界点集合到js文件给离线地图使用。
- 可静态或者动态添加多个覆盖物。支持点、折线、多边形、矩形、圆形、弧线、点聚合等。
- 函数接口友好和统一，使用简单方便，就一个类。
- 支持js动态交互添加点、删除点、清空点、重置点，不需要刷新页面。
- 支持任意Qt版本、任意系统、任意编译器。
三、体验地址
- 体验地址：https://pan.baidu.com/s/1uQsDQO5E5crUBN2J-nPeLQ 提取码：1jkp 文件名：bin_map.zip
- 国内站点：https://gitee.com/feiyangqingyun
- 国际站点：https://github.com/feiyangqingyun
- 个人主页：https://blog.csdn.net/feiyangqingyun
- 知乎主页：https://www.zhihu.com/people/feiyangqingyun/
四、效果图
五、相关代码
void MapBaiDu::addHead(QStringList &list)
{
//构建网页头部
list << QString("<html>");
list << QString("<head>");
list << QString("<title>%1</title>").arg(title);
list << QString("<meta http-equiv=\"Content-Type\" content=\"text/list; charset=utf-8\" />");
//地图页面样式
list << QString("<style type=\"text/css\">");
//页面宽度高度占比
list << QString(" html,body{height:100%;width:100%;margin:0px;padding:0px;}");
//隐藏左下角的logo
list << QString(" .anchorBL{display:none;}");
if (startAddr.isEmpty()) {
list << QString(" #map{height:100%;width:100%;}");
} else {
list << QString(" #map{height:%1px;width:100%;}").arg(height);
list << QString(" #result,#result table{width:100%;font-size:12px;}");
}
//webkit浏览器滚动条样式
list << QString(" ::-webkit-scrollbar{width:0.8em;}");
list << QString(" ::-webkit-scrollbar-track{background:rgb(241,241,241);}");
list << QString(" ::-webkit-scrollbar-thumb{background:rgb(188,188,188);}");
list << QString("</style>");
//引入webchannel.js
#ifdef webengine
list << QString("<script type=\"text/javascript\" src=\"qwebchannel.js\"></script>");
#endif
//在线和离线地图加载的文件路径不一样
if (mapLocal) {
//引入百度地图JS文件
list << QString("<script type=\"text/javascript\" src=\"map_load.js\"></script>");
//引入CurveLine JS文件,只有当绘制弧线的时候才需要,如果不需要绘制弧线可以注释
list << QString("<script type=\"text/javascript\" src=\"tools/CurveLine.min.js\"></script>");
//加载点聚合需要下面两个js文件
list << QString("<script type=\"text/javascript\" src=\"tools/TextIconOverlay_min.js\"></script>");
list << QString("<script type=\"text/javascript\" src=\"tools/MarkerClusterer_min.js\"></script>");
//引入行政区划轮廓图JS文件
list << QString("<script type=\"text/javascript\" src=\"citypointjs/%1.js\"></script>").arg(cityJsName);
//引入鼠标绘制工具JS文件
if (showOverlayTool) {
list << QString("<script type=\"text/javascript\" src=\"tools/DrawingManager_min.js\"></script>");
list << QString("<link rel=\"stylesheet\" type=\"text/css\" href=\"tools/DrawingManager_min.css\"/>");
}
} else {
//引入百度地图JS文件
list << QString("<script type=\"text/javascript\" src=\"http://api.map.baidu.com/api?v=%1\"></script>").arg(mapVersionKey);
//引入CurveLine JS文件,只有当绘制弧线的时候才需要,如果不需要绘制弧线可以注释
list << QString("<script type=\"text/javascript\" src=\"http://api.map.baidu.com/library/CurveLine/1.5/src/CurveLine.min.js\"></script>");
//加载点聚合需要下面两个js文件
list << QString("<script type=\"text/javascript\" src=\"http://api.map.baidu.com/library/TextIconOverlay/1.2/src/TextIconOverlay_min.js\"></script>");
list << QString("<script type=\"text/javascript\" src=\"http://api.map.baidu.com/library/MarkerClusterer/1.2/src/MarkerClusterer_min.js\"></script>");
//引入实时路况JS文件
if (showTrafficControl) {
list << QString("<script type=\"text/javascript\" src=\"http://api.map.baidu.com/library/TrafficControl/1.4/src/TrafficControl_min.js\"></script>");
list << QString("<link rel=\"stylesheet\" type=\"text/css\" href=\"http://api.map.baidu.com/library/TrafficControl/1.4/src/TrafficControl_min.css\"/>");
}
//引入鼠标绘制工具JS文件
if (showOverlayTool) {
list << QString("<script type=\"text/javascript\" src=\"http://api.map.baidu.com/library/DrawingManager/1.4/src/DrawingManager_min.js\"></script>");
list << QString("<link rel=\"stylesheet\" type=\"text/css\" href=\"http://api.map.baidu.com/library/DrawingManager/1.4/src/DrawingManager_min.css\"/>");
}
}
list << QString("</head>");
}
