QML QtLocation地图应用学习-5：实现自己的plugin加载瓦片地图

超、凢脫俗 2023-06-24 09:29 1阅读 0赞

Qt Location模块中的plugin默认只有 "esri"、"mapbox"、"osm"、"here"，一般我们需要换成自己的数据源，github 上有人做了谷歌地图和其他地图的 plugin 。而我目前的需求是加载本地瓦片地图，所以准备实现一个自己的 plugin 。

# 1.了解如何自定义 plugin  #

我们可以通过查看 Qt Location 相关文档，了解自定义 plugin 的步骤：[https://doc.qt.io/qt-5/qtlocation-geoservices.html][https_doc.qt.io_qt-5_qtlocation-geoservices.html]

文档上提到了两点，给插件写一个json描述文件；继承 QGeoServiceProviderFactory 并实现其部分接口。

对于 json 文件的 Features 字段的内容，可以参考：[https://doc.qt.io/qt-5/qgeoserviceprovider.html][https_doc.qt.io_qt-5_qgeoserviceprovider.html]。比如我目前做这个只用到了瓦片加载，那么可以这样写（写的Online实际上是自己处理的网路请求加载本地数据）：

{
        "Keys": ["mymap"],
        "Provider": "mymap",
        "Version": 100,
        "Experimental": false,
        "Features": [
            "OnlineMappingFeature"
        ]
    }

对于接口实现部分，插件实现者需要继承QGeoServiceProviderFactory以及要为其提供实现的许多ManagerEngine类的子类（机器翻译），如果插件不提供对应引擎，则相关函数应返回0（nullptr）。如果要制作自己的 plugin 加载瓦片，需要重写createMappingManagerEngine处理相关请求来实现映射。

当然，只是看文档还不足以自己做一个插件，需要参考已有的实现，如：

> Qt源码的实现： qt-everywhere-src-5.12.4\\qtlocation\\src\\plugins\\geoservices\\osm\\osm.pro
> 
> GitHub：[https://github.com/mavlink/qgroundcontrol][https_github.com_mavlink_qgroundcontrol]
> 
> GitHub：[https://github.com/vladest/googlemaps][https_github.com_vladest_googlemaps]
> 
> GitHub：[https://github.com/wangpengcheng/OfflineMapTest][https_github.com_wangpengcheng_OfflineMapTest]

# 2.实现中的一些关键点 #

目前的实现我只做了瓦片的请求，也就是继承 QGeoServiceProviderFactory 类后实现其 createMappingManagerEngine 接口。具体的请求由 QGeoTileFetcher 的子类来完成，我们继承他后实现 getTileImage 接口。

对于一些请求参数，我是通过 QGeoServiceProviderFactory 虚函数接口中的 parameters 参数来捕获的，我们可以在QML中通过给 Plugin 添加 PluginParameter 来传递参数（也可以通过 MapParameter 来实现）：

plugin: Plugin {
                name: "mymap" //"esri" "mapbox" "osm" "here"
    
                PluginParameter {
                    name: "mapPath"
                    value: applicationDirPath+"/dianzi_gaode_ArcgisServerTiles/_alllayers"
                }
                PluginParameter {
                    name: "format"
                    value: "png"
                }
            }

目前也有一些没解决的问题，如请求的 url 不对的话程序会很卡等。

（2020-1-18）之前自定义的模块加载了 cache 但是不会释放， Map 切换多次后内存占用飙升，参考源码之后借用 QGeoFileTileCache 类来管理瓦片缓存，解决了 cache 没释放的问题。

# 3.实现效果及源码 #

实现效果如下图，源码中带有部分瓦片地图，可以直接运行。要注意的是不同的 Qt 版本可能 Location 模块有些接口不同，我使用的 Qt5.12 和 Qt5.15 来测试，其他版本请自行查看 Qt 源码来修改。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9nb25namlhbmJvMTk5Mi5ibG9nLmNzZG4ubmV0_size_16_color_FFFFFF_t_70][]

代码中有个 MyQtLocation.pro 用于运行示例，示例是静态加载的 plugin 。Plugin文件夹下有个单独的 pro文件用于生成 lib dll，生成动态库之后放到 Qt 安装目录的插件目录下（如 E:\\Qt\\Qt5.12.6\\5.12.6\\msvc2017\\plugins\\geoservices ），就可以在别的项目中使用这个 dll 了，可以通过添加 build 参数 install 自定安装到对应目录。

至此，一个简单的瓦片地图插件就完成了，如果要自己做一定要看文档和源码。

代码 github 链接：[https://github.com/gongjianbo/MyQtLocation][https_github.com_gongjianbo_MyQtLocation]

[https_doc.qt.io_qt-5_qtlocation-geoservices.html]: https://doc.qt.io/qt-5/qtlocation-geoservices.html
[https_doc.qt.io_qt-5_qgeoserviceprovider.html]: https://doc.qt.io/qt-5/qgeoserviceprovider.html
[https_github.com_mavlink_qgroundcontrol]: https://github.com/mavlink/qgroundcontrol
[https_github.com_vladest_googlemaps]: https://github.com/vladest/googlemaps
[https_github.com_wangpengcheng_OfflineMapTest]: https://github.com/wangpengcheng/OfflineMapTest
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9nb25namlhbmJvMTk5Mi5ibG9nLmNzZG4ubmV0_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20191222180614416.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9nb25namlhbmJvMTk5Mi5ibG9nLmNzZG4ubmV0,size_16,color_FFFFFF,t_70
[https_github.com_gongjianbo_MyQtLocation]: https://github.com/gongjianbo/MyQtLocation