Sign in
Back to documentation

MapHub QGIS Plugin

Table of Contents

Introduction

The MapHub QGIS Plugin provides seamless integration between QGIS and the MapHub platform, enabling you to work with your geospatial data across both environments. This plugin bridges the gap between MapHub's cloud-based platform and QGIS's powerful desktop analysis capabilities.

Key Benefits: With the MapHub QGIS Plugin, you can view, edit, download, and upload geospatial maps directly within QGIS, streamlining your GIS workflow.

Setup

Installation

Installing the MapHub QGIS Plugin is straightforward through the QGIS Plugin Manager:

  1. Open QGIS on your computer
  2. Navigate to Plugins > Manage and Install Plugins
  3. In the search bar, type MapHub
  4. Click on the MapHub plugin in the results
  5. Click the Install button

Once installed, you'll see the MapHub icon in your QGIS toolbar or in the Plugins menu, indicating that the plugin is ready to use.

Configuration

Before using the plugin, you need to configure it with your MapHub API key:

  1. Generate a API key on the website
  2. Go back to QGIs and select Plugins > MapHub > Set API Key
  3. Enter your MapHub API key that your created on the website
  4. Click Save to store your API key

Using the Plugin

Viewing and Downloading Maps

You can view and download your own and public MapHub maps directly in QGIS:

  1. Navigate to Plugins > MapHub > Get Map from MapHub

  2. Browse through the maps in your projects or the public maps

  3. To visualize a Map in QGIS do either of the following:

    • Click one the Download button next to a Map to download it and open it in QGIS
    • Click on Tiling Service to stream it into QGIS via tiling, much faster specifically for large datasets.

  4. In either case, the map will be added to your QGIS canvas as a layer

When selecting Tiling Service, the plugin uses MapHub's tiling service to display maps quickly, even for large datasets. This is particularly useful for getting a quick overview of your data before deciding to download it for editing.

Map TypeViewing MethodPerformance
VectorVector TilesFast, even for large datasets
RasterXYZ TilesFast, preserves visualization settings

Uploading Maps

After creating or editing maps in QGIS, you can upload them to MapHub:

  1. Navigate to Plugins > MapHub > Upload to MapHub
  2. Select the QGIS layer you want to upload
  3. Define name for the Map
  4. Choose a destination project (or create a new one)
  5. Set visibility options (public or private)
  6. Click Ok to start the process

The plugin will convert your QGIS layer to a format compatible with MapHub and upload it to your account.

Note: Large datasets may take some time to upload depending on your internet connection speed.

Troubleshooting

If you encounter issues with the MapHub QGIS Plugin, try these common solutions:

IssuePossible Solution
Plugin doesn't appear after installationRestart QGIS and check if the plugin is enabled in the Plugin Manager
Cannot connect to MapHubVerify your API key and internet connection
Maps fail to loadCheck your internet connection or try viewing the map on the MapHub website
Upload failsMake sure the layer is saved to your local disk and is not just a virtual layer.
Plugin crashesUpdate to the latest version of the plugin and QGIS

If problems persist, please contact us.

Next Steps

Now that you're familiar with the MapHub QGIS Plugin, you might want to explore:

VisualizationAPI