Documentation

QGIS Plugin

Installing and Using the GeoDB.io QGIS Plugin

The GeoDB.io QGIS plugin connects your QGIS environment directly to your GeoDB.io account, allowing you to pull, manage, and visualize exploration data seamlessly. Follow these steps to install and start using the plugin.

Downloading the Plugin
 This URL resolves dynamically within the GeoDB.io platform to provide the latest plugin version.

Installation Instructions
The GeoDB.io plugin follows standard QGIS plugin installation procedures. Here’s how to install it:
  • Unzip the Plugin:
  1. After downloading, locate the ZIP file (e.g., geodb_io_plugin.zip) and extract its contents using your operating system’s unzip tool.
  • Move to QGIS Plugins Directory:
  1. Copy or move the extracted plugin folder (e.g., geodb_io_plugin) to the default QGIS plugins directory. The location varies by operating system:
  2. Windows: Typically C:\Users\[YourUsername]\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins
  3. Linux: Usually ~/.local/share/QGIS/QGIS3/profiles/default/python/plugins
  4. macOS: Generally ~/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins
  5. Ensure the entire folder (not just its contents) is placed in this directory.
  • Enable in QGIS:
  1. Open QGIS and go to Plugins > Manage and Install Plugins.
  2. In the Installed tab, locate “GeoDB.io Connection” and check the box to enable it.
  3. The plugin will now appear under the Database dropdown menu at the top of the QGIS interface.

Initial Setup
Once installed, configure the plugin to connect to your GeoDB.io account:
  • Access the Plugin:
  1. From the QGIS menu bar, select Database > GeoDB.io Connection.
  • Authenticate:
  1. Enter your GeoDB.io username and password in the plugin’s login dialog.
  2. Once validated, select your Company and Project from dropdowns mirroring the GeoDB.io online dashboard.
  • Select or Create a GeoPackage:
  1. Choose an existing GeoPackage previously created by the plugin, or create a new one using the file dialog box.
  2. This GeoPackage will store and manage your synced data locally within QGIS.

Syncing Data with the ‘Data Pull’ Tab
The plugin’s Data Pull tab is your primary tool for retrieving data:
  • Pulling Data:
  1. Select the Data Pull tab in the plugin interface.
  2. Choose a data model (e.g., LandHolding, DrillSamples, etc.) from the list—every model available in the GeoDB.io web app is accessible here.
  3. Click Sync to fetch the data.

  • Handling Updates:
  1. If the GeoPackage is new, the plugin will populate it with the selected model’s data.
  2. If it already contains data, the plugin queries the GeoDB.io database for changes since the last sync, listing additions or modifications.
  3. Review the changes and either Accept (to add new rows and overwrite updated fields) or Reject them.
  • Data Display:
  1. Models with geometry (e.g., DrillCollars, PointSamples) are displayed as spatial layers in QGIS.
  2. Models without geometry (e.g., Assays, Certificates) appear as tables.

Key Notes
  • Comprehensive Model Access: All data models from the GeoDB.io web application are available through the plugin, ensuring full integration with your exploration workflow.
  • Image and Document Links: Links to uploaded photos and documents are live and clickable but expire after 24 hours for security. To refresh them, re-sync the model using the Data Pull tab.
  • Experimental ‘Push Data’ Tab: The Push Data tab is currently non-functional. It will query the database and list local changes, but it won’t upload them to GeoDB.io yet—stay tuned for updates!