From OpenStreetMap Wiki
Jump to navigation Jump to search
Public-images-osm logo.svg ref:linz:address_id
NZ letter boxes 1 - 7.jpg
Unique identifier for a street address in the Land Information New Zealand's Addressing Information Management System Show/edit corresponding data item.
Group: references
Used on these elements
may be used on nodesshould not be used on waysmay be used on areas (and multipolygon relations)may be used on relations
Status: importedPage for proposal

The ref:linz:address_id=* tag is added to street addresses in New Zealand when they are imported. The tag was first introduced during the 2017 import, and is being used for ongoing maintenance, and for the 2021 import.

As a mapper, you don't need to worry about this tag, or its value. If it accidently deleted, moved, edited, or duplicated, the LINZ Address Import project will detect it and suggest fixing it.

Standard Case

For a normal address, an example of the tag is ref:linz:address_id=123456. 123456 is the address_id of the address in LINZ's Addressing Information Management System (AIMS).

Example: node 5504304112

Complex Cases (stacks)

In some situations, such as tall apartment buildings or hotels, there may be hundreds of addresses in a single location. In this case, the value of ref:linz:address_id=* may be a stack, such as ref:linz:address_id=stack(120-190), which means there are 70 units/flats at that location, which all have the same house number. In that example, 120 is the first ID, and the 190 is the last ID.

node 2100738956 is an example of a stacked address for a hotel with 21 rooms.

way 292667892 is an example where the range of address_ids is complicated due to repeated subdividing.

OSM Character limit

The maximum number of characters allowed in an OpenStreetMap tag value is 255. If a stack contains many address IDs, such as stack(100-105,107,203-209,...) and this value is too long, then it will be  hashed to reduce it's length but remain a unique ID.

node 8909376872 is an example where the value of this tag had to be hashed to reduce it's length.

See Also