NZ Addresses (Pilot)

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](https://data.linz.govt.nz/set/4787) and allocated addresses identified as missing from AIMS gathered from Territorial Authorities.

To improve ease of use, this dataset also includes:

- Official locality names from [NZ Localities - NZGB Compliant Names](https://data.linz.govt.nz/table/105353)

- Territorial Authority association

**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](https://data.linz.govt.nz/set/4787) and the simplified version [NZ Street Address](https://data.linz.govt.nz/layer/53353) 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.


**Feedback**
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: addresses@linz.govt.nz 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](https://data.linz.govt.nz/layer/105615/webservices/)
[ArcGIS Online map services](https://linz.maps.arcgis.com/home/item.html?id=8d66dcb16f8a4ca8916b4b6d6114d9cf)


---

**Data fields**
Please refer to the [Street Address Data Dictionary](https://data.linz.govt.nz/document/12627) 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.