NZ Addresses (Pilot)


Creative Commons Attribution 4.0 International

You may use this work for commercial purposes.

You must attribute the creator in your own works.

17 Jan 2023

This dataset was last updated on LINZ Data Service on 17 Jan 2023.

This pilot dataset provides more comprehensive national address data for New Zealand, incorporating previously missing addresses to our official address data.

NZ Addresses (Pilot) comprises both AIMS addresses and allocated addresses identified as missing from AIMS gathered from Territorial Authorities.

To improve ease of use, this dataset also includes:

Please note: we are still working through a process of identifying missing addresses. NZ Addresses (Pilot) will continue to be populated with missing addresses as they are verified.

AIMS address set and the simplified version NZ Street Address will continue to be updated by LINZ as normal as advice is received from Territorial Authorities.

In June 2022, NZ Addresses will become the national, authoritative dataset for physical addresses, replacing NZ Street Address.

Update August 2022 - Customer feedback identified an issue which is generating some duplicate addresses in NZ Addresses. We hope to resolve this as soon as possible and publish NZ Addresses as the national, authoritative dataset for physical addresses.

About the validation process
The Toitū Te Whenua LINZ Addressing Team developed routines and procedures to validate address sets sourced from Territorial Authorities against the AIMS address set.

A pilot project ran for six months, until December 2021, to gather feedback. Thank you for your valuable responses which have helped improve the data. Further validation of NZ Addresses (Pilot) will continue for six months until June 2022.

NZ Addresses (Pilot) remains for test purposes only at this stage. The pilot dataset is not intended to be used in place of the AIMS suite of published addresses, including NZ Street Address.

In June 2022, NZ Addresses will become the national, authoritative dataset for physical addresses, replacing NZ Street Address. We welcome any additional feedback as we work towards this goal.

We welcome your feedback on NZ Addresses (Pilot). The questions below could help guide feedback:
1. How useful is NZ Addresses (Pilot) to your application?
2. Have you identified any aspects of NZ Addresses (Pilot) that could be improved?
3. Have you encountered any addresses that you feel should not have been included as a missing address?
4. Any other feedback?

Please direct feedback to: with the subject line ‘NZ Addresses (Pilot) Feedback’.

APIs and web services
This dataset is available via ArcGIS Online and ArcGIS REST services, as well as our standard APIs.
LDS APIs and OGC web services
ArcGIS Online map services

Data fields
Please refer to the Street Address Data Dictionary for detailed metadata and information about the AIMS fields in this dataset.

NOTE: there are a few differences between the existing AIMS dataset and this dataset.

  • New addresses identified are named ‘CADS’ (Comprehensive Addresses Data Store) addresses.

  • Some new fields include source_dataset (the source of the record, e.g. CADS or AIMS), and address_lifecycle.

  • Field address_id is the unique identifier for an address in either AIMS or CADS addresses.

  • Field change_id is the unique identifier for the address version in either AIMS or CADS addresses.

  • Field address_class is same as address_type and includes throughfare and water.

  • Field road_section_id is not included in this dataset.

Layer ID 105689
Data type Vector point
Feature count 2299966
Primary key address_id
Services Vector Query API, Web Feature Service (WFS), Catalog Service (CS-W), Atom Feed