Mappin Architecture

At its most basic level, Mappin takes data from a WMS (Web Map Service) server and PostGIS database and provides the services / features described in the this documentation. Mappin is flexible in terms of where these input sources are located - they could be on the same network or somewhere else on the internet.

Subscription-based Mappin instances have their own WMS server (QGIS Server) and PostGIS database. On-premises Mappin installations will need to point at an existing WMS server and PostGIS database (the Installation Guide (On-Premises Only) also covers installing these components). Whichever way Mappin is configured (whether to use built-in sources or whether to use your own WMS / PostGIS sources) these sources are referred to in this documentation as the *Nominated* WMS source and *Nominated* PostGIS source.

It’s important to note that Mappin looks at only one of each source type. If you wish to use maps from multiple WMS sources, you simply need to proxy (load/publish) them through the single, nominated WMS source. FIXME is this correct?

_images/arch_1.png

Built-in WMS source

Mappin’s default Nominated WMS source is its internal WMS server (QGIS server). One key advantage of using QGIS server for WMS is that you can prepare yours layers (including styling) quickly and easily in QGIS, then upload the project file to Mappin. The published layers will then look the same as they do in QGIS.

Mappin also tries to parse many layer properties (e.g. layer aliases, ordering, default visibility) from the QGIS project, populating many of Mappin’s layer settings automatically.