如何在WeMapEngine中加载显示地图

我们在《全新跨平台GIS引擎将问世》一文中,为你分享了我们自主研发了一款全新跨平台的国产化GIS引擎------WeMapEngine。

现在再为你分享一下,如何在WeMapEngine中加载地图服务的方法,不过该产品暂未发布,因此暂时还无法立即体验。

如何在WeMapEngine中加载显示地图

基础地图是大多数GIS应用的数字"基座",因为有了基础图层,我们可以在上面进行各种类型的业务拓展开发。

例如,规划设计、指挥调度、地图制图、植被生长检测、自然灾害防治、热力分布等专业功能研发。

我们的WeMapEngine和其它二次开发SDK相同,也支持多种形式的基础地图加载显示,主要包括WMTS瓦片地图服务、自定义/模板URL和本地缓存瓦片等。

你通过WeMapEngine开发GIS系统时,只需要编写少量的代码就可以完成基础地图的加载与显示。

加载显示WMTS瓦片地图

WMTS是开发地理信息联盟(Open Geospatial Consortium OGC)制定的瓦片地图标准。

它基于静态缓存技术,实现该标准的服务通常具有支持高并发、高性能的技术特性, 大多数GIS服务端或客户端都支持该标准。

可以通过WeServer、GeoServer、ArcGIS Server或其它地图服务端来发布该标准的地图服务。

(1)加载显示WeServer发布的地图

加载WeServer发布的地图服务时,只需要添加类似以下的代码即可。

//准备服务地址const QString strUrl =QStringLiteral("https://test.ditushuju.cn:8086/WeServer/wmts?service=wmts&request=getcapabilities");           //创建WMTS图层pLayer = new WeWmtsLayer("GlobalMap", strUrl, "acimage");           //把图层添加到视图mMapView->addLayer(pLayer);

在Demo中运行代码后,就可以查看WeServer发布地图的加载显示效果。

WeServer发布地图的加载显示效果

(2)加载显示ArcGIS Server发布的地图

加载显示ArcGIS Server发布的地图服务时,只需要添加类似以下代码即可。

//准备服务地址const QString strUrl =QStringLiteral("http://sampleserver6.arcgisonline.com/arcgis/rest/services/WorldTimeZones/MapServer/WMTS");           //创建WMTS图层pLayer = new WeWmtsLayer("WorldTimeZones", strUrl, "WorldTimeZones");               //把图层添加到视图mMapView->addLayer(pLayer);

在Demo中运行代码后,就可以查看ArcGIS Server发布地图的加载显示效果。

ArcGIS Server发布地图的加载显示效果

以上为你分享了如何使用WeMapEngine加载WeServer和ArcGIS Server发布的WMTS服务,如果要加载其它地图服务端发布的服务,方法也基本相同。

对于这样的标准地图服务,在加载WMTS图层时仅需要提供服务的元信息地址,并指定要访问的图层名称就可以了。

加载显示URL自定义地图

对于提供了地图服务API申请的数据服务商,大多都提供了WMTS服务的元信息地址,例如星图地球或天地图等。

但这并不能应对所有情况,因为有的地图服务我们只能获取到瓦片的访问地址,比如OpenStreetMap地图。

有时我们也希望自主构建更灵活的请求方式,能够自定义瓦片请求地址。

从而设置自定义请求头信息,对需要附带Token的请求临时更换Token等操作。

该功能只需要通过继承WeServiceImageTiledLayer就可以实现自定义URL图层,下面的代码演示了如何自定义一个图层来加载星图地球的图源。

class MyCustomLayer : public WeServiceImageTiledLayer{ MyCustomLayer(const WeTiledInfo& tiledInfo, const WeRectangle& fullExtent)               : WeServiceImageTiledLayer(tiledInfo, fullExtent, QStringLiteral("GeoVisearth"))        {        /* 瓦片请求配置 */        WeRequestConfiguration reqestConfig;              reqestConfig.setRetryCount(5);                  reqestConfig.setTimeout(3000);              QMapheaders;              reqestConfig.setUserHeaders(headers);              setRequestConfiguration(reqestConfig);                         /* 监听瓦片请求时回调信号 */              connect(this, &MyCustomLayer::tileUrlRequest, [&](const WeTileKey& tk)              {            //星图地球瓦片URL模板,用到的token可以在星图申请                     const QString strUrlTemplate = QStringLiteral("https://tiles.geovisearth.com/base/v1/img/mercator/%1/%2/%3?format=webp&tmsIds=w&token=5196de35d4c1cf288b3ecf4c9e819b33c0e3bffad707ea9caeed599bf2a378ac");            //格式化URL            const QString strUrlTile = strUrlTemplate.arg(tk.level()).arg(tk.column()).arg(tk.row());                        //将URL设置给接口                     setTileUrl(tk, stTileUrl);                  });       }                  ~MyCustomLayer() {};}

在Demo中运行代码后,就可以查看URL自定义地图的加载显示效果。

URL自定义地图的加载显示效果

同样地,通过以上方法也可调用吉林一号的在线卫星影像,前提是你已经申请了你的专属图源。

申请的具体方法,请参阅《如何申请吉林一号专属图源》一文中的详细说明。

加载显示XYZ瓦片模板地图

所谓"模板URL"是指具有特定占位符的地图瓦片URL地址,配合引擎提供的Web瓦片图层接口,就可以轻松实现瓦片地图的加载。

占位符是引擎内置的关键字,因此它不具有通用性。

WeMapEngine的内置占位符以及他们所代表的含义如下:

URL模板:https://{subDomain}.server.org/path/{level}/{col}/{row}.png

{level} : 级别

{col} : 瓦片列

{row} : 瓦片行

{subDomain} : 子域名(可选)

明白模板URL的接口以后,下面我们通过在来看一下如果使用模板URL图层来加载OpenStreetMap图源。​​​​​​​

//OSM 瓦片地址const QString strOSMTemplate = QStringLiteral("https://tile.openstreetmap.org/{level}/{col}/{row}.png");           //创建图层    pLayer = new WeWebTiledLayer(QStringLiteral("OSM"), strOSMTemplate);           //添加到视图pMapView->addLayer(pLayer);

由于SDK内置了OpenStreetMap图层,对于上面的示例我们还可以简化成如下形式。​​​​​​​

//创建图层pLayer = new WeOpenStreetMapLayer();           //添加到视图pMapView->addLayer(pLayer);

在Demo中运行代码后,就可以查看XYZ瓦片模板地图的加载显示效果。

XYZ瓦片模板地图的加载显示效果

最常见的XYZ瓦片的模板地图,有谷歌地图、高德地图和腾讯地图等,因此这些地图都可以在WeMapEngine中进行加载。

加载显示本地松散型瓦片地图

WeMapEngine除了可以加载在线服务的地图外,还可以加载显示本地的松散型瓦片地图。

但我们通常不建立将瓦片地图在本地进行松散型存储,尤其是全球范围这样的海量地图数据。

关于这一点,我们在《合作,不是无条件的服从》一文中已为大家作过"血泪"分享。

不过在数据范围较小,一般不超过两三个中型省份这样的数据体量时,还是可以勉强存储为松散型瓦片后再调用。

松散型瓦片的存储方式,一般以"z/x/y.jpg"目录形式来表达的瓦片层级关系,如下图所示。

松散型地图瓦片目录

WeMapEngine可以通过继承WeImageTiledLayer图层来加载此类数据源,下面的示例演示了如何构建一个本地文件加载图层。​​​​​​​

class MyLocalLayer : public WeImageTiledLayer{       Q_OBJECTpublic:       MyLocalLayer(const WeTiledInfo& tiledInfo, const WeRectangle& fullExtent)                  : WeImageTiledLayer(tiledInfo, fullExtent, QString::fromLocal8Bit("本地瓦片")) {               /* 监听瓦片请求 */              connect(this, &MyLocalLayer::tileRequest, [&](const WeTileKey& tk) {                                          const QString strRootDir  = QStringLiteral("G:\\Data\\Data.Publish\\tiled_google\\%1\\%2\\%3.jpg");                     const QString strFileName = strRootDir.arg(tk.level()).arg(tk.column()).arg(tk.row());                                       QFile f(strFileName);                     if (!f.exists())                     {                            //瓦片不存在,设置为NoData                            setNoDataTile(tk);                     }                     else if (!f.open(QIODevice::OpenModeFlag::ReadOnly))                     {                                //打开文件失败,设置错误                            setTileError(tk, QString("Cannot open: %1").arg(strFileName));                     }                     else                     {                            //正常读取,设置瓦片数据                            setTileData(tk, f.readAll());                     }              });       }                  ~MyLocalLayer() {}};

在Demo中运行代码后,就可以查看本地松散型瓦片的加载显示效果。

本地松散型瓦片的加载显示效果

通过扩展开发,也支持加载调用存储为SQlite或MbTiles本地瓦片离线包。

本地数据的加载,通常用于私有化地图的部署,而私有化地图的部署一般适用于有保密需要的企事业单位。

如果想进一步了解私有部署相关方面的技术或方案,请参阅《私有化地图离线部署整体解决方案》《难以置信,谁还会用离线地球》等文中的详细说明。

WeMapEngine的地图加载能力

基于WeMapEngine的二次开发,可调用加载各种地图的方法,且仅需要编写少量的代码就可以实现。

因此当采用WeMapEngine作为GIS开发平台时,你可以将更多的时间和精力放在核心业务功能的研发上。

另外,WeMapEngine引擎也支持对WMS、TMS服务的加载调用,以及可能涉及的权限认证能力,这里只是限于篇幅的原因暂略。

随着引擎的不断更新迭代,我们还会加入对矢量瓦片的兼容,从而实现更丰富自由多元化的地理元素信息渲染表达。

鉴于相应的帮助文档还在完善过程中,WeMapEngine的SDK开发包暂不对外提供

如果你想了解该WeMapEngine引擎的更多功能,请扫下方二维码添加微信,并发送"WeMapEngine"以说明来意。

扫码联系

写在最后

本文为你分享了WeMapEngine加载调用各种在线地图服务的方法,以及加载调用本地离线地图的方法。

你可以立即点击"分享"按钮,将本文免费分享给你的朋友!

相关推荐
水经注GIS5 个月前
私有化地图离线部署方案之高程检索服务
gis技术
水经注GIS7 个月前
如何使用 ArcGIS Pro 计算容积率
arcgis·gis技术
水经注GIS8 个月前
如何使用ArcGIS Pro进行选房分析
gis技术
水经注GIS8 个月前
如何使用 ArcGIS Pro 快速为黑白地图配色
gis技术
水经注GIS8 个月前
如何使用ArcGIS Pro进行路径分析
gis技术
水经注GIS8 个月前
如何使用 ArcGIS Pro 制作热力图
gis技术
水经注GIS9 个月前
ArcGIS Pro怎么进行挖填方计算
gis技术