Australia - 5.0

Geo Addressing SDK Developer Guide

Product type
Software
Portfolio
Locate
Product family
Geo Addressing
Product
Geo Addressing SDK
Version
5.0
Language
English
Product name
Geo Addressing SDK
Title
Geo Addressing SDK Developer Guide
Copyright
2023
First publish date
2007
Last updated
2024-09-12
Published on
2024-09-12T14:50:21.470801

The following table lists output fields that are unique to the Australian Geocoded National Address File (G-NAF®) database. G-NAF is an optional database that is available for all six states and two territories. G-NAF is the only authoritative Australian national index of locality, street and number, validated with geographic coordinates.
Table 1.
Field Name Description
GNAF_ADDRESS_CLASS The Address_Class is constructed using a combination of elements from the G-NAF Data Dictionary source tables. The components of the Address_Class field are:
A
Alias address record
P
Principal address record
PP
Principal primary address record
PS
Principal secondary address record
AP
Alias primary address record
AS
Alias secondary address record
GNAF_CONFIDENCE

A number indicating how many G-NAF datasets the address is found in. A higher confidence level means that the same address was found in more data contributor sources. One of the following:

<number>
The number of datasets the address was found in, minus 1. For example, a value of 0 indicates that the address was found in one contributor's dataset, a value of 1 indicates that the address was found in two contributors' datasets, a value of 2 indicates that the address was found in three contributors' datasets, and so forth.
-1
The address could not be found in any G-NAF dataset.
GNAF_EIGHT_DECIMAL_PLACE_LATITUDE

The parcel latitude, precise to eight digits after the decimal. This is the latitude that the candidate matched to in the G-NAF database. These are the original coordinates directly from the G-NAF data prior to truncation or rounding.

This field is only returned if you check the Return eight decimal places for parcel latitude/longitude box on the Geocoding tab.

GNAF_EIGHT_DECIMAL_PLACE_LONGITUDE

The parcel longitude, precise to eight digits after the decimal. This is the longitude that the candidate matched to in the G-NAF database. These are the original coordinates directly from the G-NAF data prior to truncation or rounding.

This field is only returned if you check the Return eight decimal places for parcel latitude/longitude box on the Geocoding tab.

GNAF_GEOCODE_LEVEL

A number indicating the level o f geocode for the address. Every principal address within the G-NAF database has at least a locality level geocode. They may also have a street level geocode and a point level geocode.

One of the following:

0
No geocode.
1
Parcel level geocode only (no locality or street level geocode).
2
Street level geocode only (no locality or parcel level geocode).
3
Street and parcel level geocodes (no locality geocode).
4
Locality level geocode only (no street or parcel level geocode).
5
Locality and parcel level geocodes (no street level geocode).
6
Locality and street level geocodes (no parcel level geocodes).
7
Locality, street and parcel level geocodes.
GNAF_PARCEL_ID The Parcel ID field is the generic parcel id field provided by custodial data, and represents a Lot on Plan description that is useful for government agencies. The exact format varies. G-NAF source data has over 7 million records with a Parcel_ID. The Australia geocoder supplements this to populate over 12,730,000 G-NAF records with a Parcel_ID field.
GNAF_PID

The G-NAF Persistent Identifier (G-NAF PID) is a 14-character alphanumeric string that uniquely identifies each G-NAF address. The PID is constructed from a combination of the major address fields of the G-NAF database. An example of a G-NAF PID is:

GAACT718519668

GNAF_RELIABILITY

A number indicating the geocode precision. Reliability is related to the dictionary used to determine the geocode. Data with geocoded reliability levels 1, 2, and 3 is contained in the GNAF123 Dictionary. This is point (parcel) level geocoded data. Data with geocoded reliability levels 4, 5, and 6 is contained in the GNAF456 Dictionary. This contains non-parcel centroid geocoded data.

1
Geocode accuracy recorded to appropriate surveying standard. For example, this could apply to an address level geocode that was manually geocoded. Geocode resolution is sufficient to place the centroid within address site boundary with a GPS.
2
Geocode accuracy sufficient to place centroid within address site boundary. For example, this could apply to an address level geocode that was automatically calculated as the centroid of the corresponding cadastre parcel.
3
Geocode accuracy sufficient to place centroid near (or possibly within) address site boundary. For example, this could apply to an address level geocode that was automatically calculated by calculating where on the road the address was likely to appear based upon other bounding geocoded addresses.
4
Geocode accuracy sufficient to associate address site with a unique road feature. For example, this could apply to a street level geocode that was automatically calculated by using the road centerline reference data.
5
Geocode resolution sufficient to associate address site with a unique locality or neighborhood. For example, this could apply to a locality level geocode that was automatically calculated as the centroid of the locality.
6
Geocode resolution sufficient to associate address site with a unique region. For example, this could apply to a locality level geocode that was derived from topographic feature.
GNAF_SA1 The Statistical Area Level 1 (SA1) field as the second smallest geographic area defined in the Australian Statistical Geography Standard (ASGS). Mesh Block is the smallest unit. The SA1 is designed for use in the Census of Population and Housing as the smallest unit for the processing and release of Census data. An SA1 is represented by a unique seven digit code.
LEVEL_NUMBER

The number of a floor or level in a multistory building. For example,

Floor 2, 17 Jones Street

The G-NAF database includes level information for some Australian states. Level information may be associated with unit information, but not necessarily. If the G-NAF database contains multiple records with the same level, the level information is returned only if the input address contains unique content (such as a unit number). If the G-NAF database has level information for an address, that information is returned with the matched candidate.

The correct level information is returned (when available) even if the input address did not include level information, or if the input had the wrong level information. If the input address has level information but the G-NAF database does not include level information for the matching address, then the input level information is discarded since it is not validated in the G-NAF data.

LEVEL_TYPE

The label used for a floor of a multistory building. For example, "Level" or "Floor". In this example, the level type is "Level":

Suite 3 Level 7, 17 Jones Street

In this example, Suite 3 is a unit.

The G-NAF database includes level information for some Australian states. Level information may be associated with unit information, but not necessarily. If the G-NAF database contains multiple records with the same level, the level information is returned only if the input address contains unique content (such as a unit number). If the G-NAF database has level information for an address, that information is returned with the matched candidate.

The correct level information is returned (when available) even if the input address did not include level information, or if the input had the wrong level information. If the input address has level information but the G-NAF database does not include level information for the matching address, then the input level information is discarded since it is not validated in the G-NAF data.

MESH_BLOCK_ID A Meshblock is the smallest geographic unit for which statistical data is collected by the Australian Bureau of Statistics (ABS). Meshblocks usually contain a minimum of 20 to 50 households. This is about one fifth the size of a Collection District (CD). You can use the Meshblock ID to do additional attributions against your own data.
LOT_NUMBER Lot numbers are returned for G-NAF candidates because some rural addresses do not have adequate physical or house number information.
STREET_TYPE_ABB This is an abbreviation for the street type. For example, EX is an abbreviation for Extension and FTRL is an abbreviation for Firetrail.