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.
See our Creating an API key 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 listed on the About page.
You must login and create an API key for each individual data source you wish to access data from.
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.
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.
The available CRS options for each layer are shown in a drop down next to the “Add Layer” button (in terms of EPSG code). Select the CRS of the dataset to be requested from the server.
If the QGIS project initially has a CRS which does not match the imported dataset’s CRS, QGIS will reproject the imported dataset to match the project CRS. Important: reprojecting the CRS of a dataset can degrade spatial accuracies and relationships.
If the first dataset of a QGIS session is imported via the plugin, the plugin will change the QGIS project’s CRS to match the imported data. As the plugin enables on-the-fly projections, any further datasets which don’t match the first dataset’s CRS will be reprojected. When these changes occur, the user will be notified via the QGIS message bar.
The first time a Domain and API key are saved via the Settings menu, the plugin will request capability documents for the domain’s web services (WMTS/WMS). This causes a delay as the Data Portal’s server retrieves these documents, resulting in the plugin appearing inactive. After the documents are fetched, they are cached and updated, removing any further delays each time the plugin is started.
The left-hand panel allows users to filter by service types (All, WFS, WMTS). Users can toggle column headers to order data by ascending or descending. Datasets can be filtered using keywords by text being entered into the “Filter Data Sets” search bar.