之前我们分享过如何 在本地发布OSM矢量瓦片地图,里面介绍了生成的矢量瓦片会存放在 .mbtiles
文件中,然后用 tileserver-gl 软件发布。
mbtiles 是基于sqllite数据库存储地图瓦片数据的标准规范,
.mbtiles
文件就是实现了这个规范的sqllite数据库。
最近遇到个相关的问题,项目上需要将这份.mbtiles
格式的矢量瓦片部署到客户服务器上并发布。
之前分享过我在用的 开源GIS解决方案,里面将 postgis、geoserver、tomcat 都搞成了绿色版,并且可以通过批处理脚本将它们一键注册成系统服务,这样就形成了一个套开源GIS的绿色版安装包,部署时会很方便。
这套安装包的整体技术架构是偏 java 的,而这次发布矢量瓦片用到的 tileserver-gl 是基于 nodejs 开发的,按上面的思路,需要将 nodejs 也搞成绿色版的,并且可以使用批处理注册成系统服务。
因为不想把安装包搞的太大,也不想用太多的技术体系,让后期维护变得复杂,所以就想能不能在现有的技术体系下搞定 .mbtiles 发布的问题。
按这个思路,需要去研究有没有相关的geoserver插件,或是 java 的软件或项目。
下面是我研究的具体过程,不想看过程的同学可以直接跳到末尾看总结。
先研究了geoserver插件,还真有。
geoserver有个mbtiles的扩展插件(https://docs.geoserver.org/latest/en/user/community/mbtiles/index.html),支持对.mbtiles
文件的读写。
geoserver 安装 mbtiles 插件的教程可以参考这篇:https://blog.csdn.net/dyxcome/article/details/98375453
从官网下载插件,安装测试后,发现跟想的有点不一样。
geoserver安装完插件后,新建数据源的界面多了两个 mbtiles 相关的选项,如下图,上面的是发布矢量瓦片,下面的是发布栅格瓦片。
我用第二个红框,发布栅格瓦片的选项,发布了下矢量瓦片,会报错。
用第一个红框,发布矢量瓦片的选项,可以走的通,但就是过程有点曲折,需要把 pbf 中的图层再挨个发布一遍。
.mbtiles
文件中存的是处理好的 pbf
文件,按说插件只需要根据请求参数,从 sqllite 数据库中查询 pbf
文件,返回给前台就 ok 了。
但 geoserver 不是这么做的,它是将 .mbtiles
文件中的 pbf
瓦片作为矢量数据源来使用,类似于读取 .mdb
文件。
可以推理出,geoserver 内部的处理方式大概是:
pbf
瓦片拼起来,读取拼接后的各图层原始数据pbf
文件返回给前台怎么说呢,这么做和把 pbf
文件直接扔给前台相比,结果是一样的,但就是感觉 geoserver 的戏太足,内耗太严重,还有就是这个发服务的操作过程也很麻烦。
只能说,这个插件针对矢量瓦片的设计,仅是用来读取原始数据的,不适合用来发布数据。
再看 java 这边。
在 github上搜了一下,找到了这个项目:mbtiles4j(https://github.com/jtreml/mbtiles4j)。
是个现成的 java 工程,拉取下来研究了一下,逻辑很简单,就是直接读取 mbtiles
中的瓦片返回给前台,这一点很符合要求,美中不足的是,这个项目是针对栅格瓦片的,默认只支持 .png
文件,不支持 .pbf
。
这个好说,有源码,改改就是了。
改完后发现,前端地图不显示,瓦片请求地址报 404 ,
将请求地址中的瓦片编号和 mbtiles
库中的瓦片编号对了一下,确实没有。
为啥呢?
哈哈,这个我有经验,持续关注我们的同学还记不记的,我之前分享过关于 如何让 maputinik 支持 geoserver 的问题,里面最关键的一点就是设置 mapboxgl 请求瓦片的模式 scheme
,模式包括 xyz
和 tms
,默认使用 xyz
。
难道 openmaptile 生成的这个 mbtiles
文件是按 tms
存储的?试一下就知道了
果然 ~ 没那么简单,地图还是没有出来,但瓦片可以请求到了,看来确实是 tms
的。
事后简单翻了一下 mbtiles 规范,里面有明确写到,数据源是以 tms 格式来存储的。
看来还是要多研究标准规范和说明文档。
但为啥地图还是没有出来呢?
对比了下 tileserver-gl(下图左) 和 mbtiles4j(下图右) 的返回参数,发现了问题所在。
pbf 文件是采用 gzip 压缩过的,需要在返回参数中明确告知返回内容的类型是 gzip,而刚才将 mbtiles4j 中的png 改成 pbf 后,没有加这个设置。
加上试试,哈哈,搞定。
这个通了,剩下的就简单了,工程编译成 war 包,直接扔到tomcat下就可以了。
本来以为可以收工了,但浏览地图时发现了另一个问题。
我的地图只切到了14级,因为在矢量瓦片中,14级包含的内容就已经很细了,所以没有必要再往下切。
但用地图浏览时,超过14级后,因为后台没有对应的瓦片,前台就请求不到数据,地图就不显示了。
用 tileserver-gl 发布同样的 mbtiles 文件,再用它的默认地图查看器浏览地图,就没有这个问题。
看来后台需要把超过14级的请求参数处理一下,超过14级时,直接返回14级的瓦片。
翻了翻 tileserver-gl 的代码,并没有找到相关的逻辑。
在同事的提醒下,发现 tileserver-gl 的默认地图查看器,它的前台请求在超过14级时,是按14级来请求的,这说明我要找的逻辑是在前台完成的。
去翻 tileserver-gl 的地图样式配置,和我自己的配置对比后发现,对数据源设置 maxzoom
就可以解决这个问题。
看一下官网的解释,大概意思是,如果你设置maxzoom=14,那么当地图缩放超过14级时,地图仍然会使用14级的瓦片。
这个设置正是我要的。
我把改完后的后台代码上传到了github,方便以后遇到同样问题的同学使用。
地址:http://gisarmory.xyz/blog/index.html?source=OSMMbtiles
本地发布的OSM矢量瓦片地图,生成的矢量瓦片存放在 mbtiles 文件中
发布mbtiles 中的矢量瓦片,目前主流的方式是 tileserver-gl ,它基于nodejs开发的
geoserver有个读取 mbtiles 的插件,但它针对矢量瓦片的设计是用来读取 pbf 中原始数据的,不适合用来发布数据。
github上有个 mbtiles4j 的项目,java 开发的,稍加修改后,可以用来直接发布 mbtiles
mapboxgl 使用发布的地图瓦片时,需要设置数据源的 maxzoom 属性。
原文地址:http://gisarmory.xyz/blog/index.html?blog=OSMMbtiles。
关注《GIS兵器库》公众号, 第一时间获得更多高质量GIS文章。
本文章采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名《GIS兵器库》(包含链接: http://gisarmory.xyz/blog/),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。