A step-by-step guide on how to use our plugin for the quick discovery and import of LINZ data into QGIS.

Simplified API access to data

The LINZ Data Importer plugin allows you to easily explore and connect to any LINZ Data Service (LDS) and LINZ Basemaps web service from QGIS. Make a one-time connection to any LINZ or other participating agency data portal to get access to all available WFS and WMTS services from your QGIS project.

Once the connection is set up, any new datasets supported by WFS or WMTS will be immediately available to you in QGIS.

Visit the QGIS Project website for more help and to download the application.

QGIS Project website

Available data

Data (available through WFS or WMTS) from the agency data portals and services below are available via the LINZ Data Importer.

Open data portals

LINZ Basemap service

Get an API key

The first step in using the LINZ Data Importer is to get an API key. An API key is required from each service you wish to access data from via the plugin.

LINZ Data Service and other agency data portal API key

See our guide to create an API key for the LINZ Data Service. The same general process can also be used to generate an API key from the agency data portals above.

Creating an API key

You must login and create an API key for each individual data source you wish to access data from.

LINZ Basemaps API key

Visit LINZ Basemaps to grab an API Key. Simply open the menu on the right, then copy the pre-populated API key from the full WMTS URL.

LINZ Basemaps

Note: these keys are rotated every 90 days and will need to be updated accordingly. Contact basemaps@linz.govt.nz if you wish to retrieve an unlimited developer API key.

Installing the plugin

The following process for viewing and importing data using the LINZ Data Importer in QGIS is performed using QGIS version 3.10.

  1. From the QGIS application, Plugins > Manage and Install Plugins… the Plugins dialogue box will open, search LINZ Data Importer, and click Install Plugin.
  2. Once the plugin is installed the LINZ logo will be added above the Browser window. Click the logo to open the LINZ Data Importer dialogue box.
  3. Access the “Settings” tab to configure each service’s domain and API key. Click the dropdown menu under the “API Keys” heading and select the domain of the data service which you are interested in (e.g. data.linz.govt.nz).
  4. Click the “+” symbol. This will confirm the selected domain and provide a text box to insert the relevant API key. Copy and paste the API key that you created earlier (see above) in the text box and click Save.
  5. This will trigger the plugin to request the domain’s dataset information, allowing you to view and import the data in QGIS via WMTS and WFS web services.
  6. Select the layer of interest and click “Add”. The corresponding dataset will be added to the map display.
  7. Another open data portal can then be added by changing the domain and repeating steps 4-7.

See the LINZ Data Importer page on GitHub for more information on caching, coordinate reference systems and filtering.

LINZ Data Importer on GitHub

Reference Category: Web services, Map tile services
Reference Tags: QGIS, Web Feature Services (WFS), Web Map Tile Services (WMTS), XYZ tile services
Last Updated: 
30 June 2021