Skip to content

Latest commit

 

History

History
63 lines (40 loc) · 1.98 KB

README.md

File metadata and controls

63 lines (40 loc) · 1.98 KB
Raw

What is it?

A QGIS plugin to directly download and import GBIF occurrence data from the application interface.

Tutorial

Installation

Note: the plugin has been re-submitted to the QGIS plugins repository. If you used a previous version, you will need to uninstall it and reinstall it completely (update won't work).

  1. Launch QGIS
  2. In the main menu, go to Plugins -> Manage and install plugins...
  3. Go to Settingsand make sure Show also experimental plugins is checked
  4. Go back to the All tab and search for GBIF occurrences
  5. Select the plugin and click on Install plugin

Plugin install window

Use

  1. Open the extension window from the main menu: Vector -> GBIF Occurrences -> Load GBIF Occurrences (alternatively, use the Plugin iconicon in the toolbar).

  2. Fill in the details about yout search (for example: betta splendens occurring in Thailand) and click "Load occurrences".

Main plugin window

  1. Done! You'll notice a new QGIS layer for your occurrences. All details known by GBIF are also available as attributes.

Occurrences in QGIS Attributes table

Limitations

  • More filters should be implemented.
  • Due to limitations of the GBIF API, searches are limited to 200,000 records.

Status

First release ok! Feel free to report any bug or feature requests (or even better, contribute to improve it!)

Running tests:

$ make test

(Currently it is difficult to run tests on Mac OS X since Kyngchaos QGIS packages embed PyQt without the QtTest module.)

How-to release:

  • Bump version number and update changelog in metadata.txt.

  • Submit the plugin to the QGIS plugins repository, after renaming the directory to qgisgbifapi.

  • create a git tag and push it to github:

    $ git tag v0.1-in-plugin-repo $ git push origin --tags