Using your XMAP layers in QGIS

Using your XMAP layers in QGIS

Overview

For customers who have a dedicated database connected to XMAP, you can access your data directly in QGIS. This means that both XMAP and QGIS are reading from the same source, so there is no risk of multiple versions of your data existing in your organisation.

Getting Started

For any user needing to access the database, you will need to create a user. You can do this from XMAP, or using a database tool such has DBeaver or pgAdmin.

QGIS Authentication

We recommend using the authentication manager to create a named configuration for XMAP. In QGIS, go to: Settings -> Options -> Authentication
  1. Click the green + symbol to create a new configuration.
  2. Enter a name for the configuration
  3. Click the orange padlock symbol to unlock the 'id' field
  4. Enter xmapdbu as the ID
  5. Select Basic Authentication from the drop down
  6. Enter your username and password for the database user.

Connect to the Database

  1. Open the datasource manager: 
  2. Select PostgreSQL
  3. Click New
  4. Enter a name for the connection
  5. In the Host field, enter the connection URL. If you do not know this, contact support.
  6. In the database field, enter the name of the database to connect to.
  7. Under Authentication, click the drop down and select the configuration you created for XMAP.
  8. Select 'Also list tables with no geometry'
  9. Click OK to save
  10. Click 'Connect' to connect to the database. 
  11. You can then browse the database schemas and tables and select a table to 'Add' to the QGIS view.

Troubleshooting

You must select a table in order to add a layer

If you see this message when trying to add a table, you may need to tell QGIS what the geometry type is of the layer. In the datasource manager, find the table and scroll across to the Spatial Type column. Try selecting a Geometry Type and clicking Add:

I've added my layer to QGIS, but it isn't showing, there's a warning symbol next to the layer or the layer doesn't seem to have a geometry type.

See above. This layer may be using a generic geometry type. You can use the data source manage to tell QGIS the geometry type of the layer, or add a feature to the layer using XMAP and refresh the QGIS connection.

    • Related Articles

    • QGIS Connector

      Overview This add-on for XMAP Cloud GIS allows layers to be viewed in QGIS. The layer can be edited and saved directly to your XMAP Cloud GIS account without downloading and re-uploading the data. Setup QGIS There are no plugins needed for viewing an ...
    • Connecting to XMAP Layers externally

      Overview XMAP has the functionality to give access to XMAP-hosted Map Layers through three methods: QGIS QLR file (using WFS-T) WMS WFS These options give you the ability to view and edit XMAP-hosted Map Layers in a variety of desktop GIS software. ...
    • Print issues with WMS basemaps in QGIS

      Print issue - only half the map is showing: If you come across an issue with QGIS and using XMAP WMS base-mapping feeds, where by a print export is only producing only half a base-map image then there are two options to fix this. The reason for this ...
    • Adding a WMS/WFS feed to QGIS

      Overview A Web Map Service (WMS) is an online data feed that can be connected to desktop or web-based GIS software to view digital maps without having to download the full dataset. A Web Feature Service (WFS) is the same as WMS, except it will ...
    • An Introduction to Layers

      Overview Layers (points, lines, polygons or base mapping) are stored in Collections on the left of the map. Searching for layers: You can search for layers via the Layer Search tool at the top of the Collections panel. Layer Tools: When you click on ...