Skip to content

Using Humap

Overlays Wizard – QGIS export & ArcGIS Online guidance

The Humap Overlay Wizard tool allows admin users to upload their own geospatial data as overlays. The feature is currently in beta mode and is currently limited to:

  • Geojson uploads only (or links to externally hosted and vector or raster georeferenced tilesets such as on ArcGIS Online)
  • Coordinate Reference System (CRS) set to Default: CRS EPSG:4326 WGS 84 (see below)
  • No z-dimension/3D vertical coordinates (see below)
  • Vector (polygon, point, and/or line data) only (raster image uploads will be included in a later release)

Exporting features from QGIS into your Humap platform

QGIS is a free and open source geographic information system. If you have basic knowledge of GIS, you can use QGIS and ESRI’s ArcGIS software to export features into Humap as overlays.

Coordinate Reference System (CRS) selection

When exporting your feature layer, select the Default: CRS EPSG:4326 WGS 84 coordinate reference system. Currently, the Humap platform overlay system can only work with this CRS. To set the export’s CRS within QGIS, in the Export dialogue window select CRS > Default: CRS EPSG:4326 WGS 84

CRS Coordinate Reference System example selection
Example of the CRS selection menu in QGIS’s export panel

Ensure there are no z-dimension values attributed to features within the output

The Overlay Wizard tool geojson import will fail if any features contain z values (vertical coordinates). To remove them from your layer or features within QGIS:

  • Select the layer or features with z-dimensions (select all features or the entire layer if you don’t know which).
  • Navigate to the Processing menu and search for ‘Drop M/Z values’ in the Processing Toolbox. Within the Drop M/Z values dialogue panel, select the Drop Z Values checkbox and click Run.
  • Your features will be outputted to a new layer ready for export.
QGIS Processing panel
Drop M/Z Values option within the QGIS Processing panel

Coordinate precision

If your data needs to be precisely geolocated, we recommend a resolution of five numeric points of precision when exporting to a geojson file within QGIS. Typically QGIS will render the export at a coordinate precision of 15 places by default, which is not necessary and will result in a larger than intended geojson file and data. You can change the precision within QGIS’s export dialogue window under Layer Options > Coordinate Precision

Disappearing feature element – minimum zoom fixes

If you’ve imported your data successfully but upon zooming into the map, points and/or polygons disappear from view, open the Zoom panel in the Overlay Wizard’s layers panel by clicking the Vector dropdown arrow and clicking Zoom. The Zoom panel will indicate what zoom Level you are currently viewing on the map. Change the Overzoom Level number to the first level your data disappears. For example, if you zoom down to level 14 and then your data disappears from view, change the Overzoom Level to 14.

Overlay Wizard layer panel zoom options
Overlay Wizard layer panel zoom options

Exporting bounds

The bounds or bounding box of your data on the map will only do one thing within the Humap platform and that is provide a locate overlay icon to users. The icon will allow end users to click the locate (target) icon within the overlay toolbar and zoom into the overlay wherever it may be on the map.

Map overlay panel options
The map overlay panel with locate icons

To export your feature layer bounding box, select Yes in the WRITE_BBOX option in the QGIS export window. Exporting your bounding box coordinates out of QGIS will state the lat, lon coordinates of the extent within your geojson file which you can input into the Humap Overlay Wizard layers pnael Bounds section under the Vector editor options. Please note that QGIS exports the BBOX data as lon, lat so you will need to reverse the two coordinates when copying into the Overlay Wizard Southwest and Northeast extent input fields.

QGIS WRITE_BBOX and Coordinate Precision export options
QGIS WRITE_BBOX and Coordinate Precision export options

Alternatively, you can draw a rectangle bounding box across the extent of your data on the map. This is useful if you would prefer your bounding box to be larger than the feature extent (or smaller).

Adding layers from ArcGIS Online

If you have access to ESRI’s ArcGIS Online, you can include raster or vector layers in your Humap project by referencing the ArcGIS Online server URL. To do so, navigate to the Layer panel and click Add layer or Add another layer. Select Add from URL and paste in your ArcGIS Online tile server address and select between an intended vector or raster layer.

Add layer from URL example
Add layer from URL example

The correct format to use for your URL will be:{z}/{y}/{x}

Typically you will need to add the following text to the end of your URL where it ends with /MapServer (as above):


The layer will load into the map immediately and allow you to edit your Layer panel options such as vector styles and zoom levels.

Send a message

How can we help?

We usually respond in a few hours