Australian Address API - G-NAF, Parcels, Buildings

Verify any Australian address against the national address file, then follow it down: the coordinates, the cadastre parcel it sits on, the property it belongs to, the building on it with its height, roof, solar panels and pool, and the statistical, electoral and local government areas around it.

What this actor does

• Address autocomplete. Suggest addresses or localities from a partial string, with the provider's own ranking and the suggestion ID you retrieve the full address with. Restrict by state, by address type, or to the national file, the live file or mail addresses.
• Geocode, with an honest match score. Match a full address or its separate parts and get back the match type, match code, match quality and a numeric score. A "match" at locality level is a suburb, not a house, and those four columns are what tell you which one you got.
• Reverse geocode. Addresses at a coordinate, with the provider's match method describing how the point was resolved.
• Address attributes, with bundles. Everything known about an address ID, and optionally the statistical areas, remoteness, socioeconomic indexes, commonwealth and state electorates, local government area, parcel, property, buildings and solar panel bundles attached to the same row.
• Mail point. Delivery point identifier and barcode for an address, for mail preparation.
• Cadastre and property. Land parcels and properties by identifier, by point with an optional radius, or inside a bounding box, with the option of base parcels only so strata subdivisions do not multiply your rows.
• Buildings. Footprints by identifier, point or bounding box, with height, roof material and shape, solar panels and pool indicator, plus the addresses, parcels and properties each building relates to.
• Administrative boundaries. Which locality, ABS mesh block, remoteness area, socioeconomic index area, state and commonwealth electorate and local government area a point falls in.
• Dataset catalogue. What bulk datasets your key is actually licensed for, which is worth knowing before you spend a run finding out.
• Pay per result. You are charged for rows carrying a real record. Addresses the provider cannot match and points with nothing at them are free.

Bring your own key

This actor calls the provider with your own account key, created in your provider account. Paste it into the input, or set it as the DATA_API_KEY secret. Nothing runs on anyone else's credentials, and a run without a key ends cleanly with an explanation rather than failing.

One detail that costs people an afternoon: the key travels in an Authorization header with no scheme word in front of it. Not Bearer, not ApiKey. A key pasted with a scheme attached is not seen as a credential at all, which looks exactly like a wrong key. This actor strips one if you paste it by accident.

GDA94 is not WGS84

The coordinates this API returns default to GDA94, not WGS84. In Australia the two are about 1.8 metres apart, and they agree to roughly six decimal places, so nothing about the numbers tells you which one you have. That is the difference between a point on a roof and a point in the garden, and it is enough to put an address on the wrong side of a parcel boundary.

So every row this actor writes records the reference system it was returned in, in a crs column. Pick GDA2020 if you are joining to current Australian survey data, WGS84 if you are plotting on a web map, or leave the provider default and know what you have.

Polygons are opt in

A cadastre parcel or building footprint is a full ring of coordinates. Written into a spreadsheet cell it makes the file several times larger without making it more useful, so every feature row carries a centroid and a geometry type by default, and the complete GeoJSON geometry only when you ask for it.

The centroid is the average of the outer ring's positions. It is good enough to map and explicitly not a survey grade centroid, which is exactly why the full geometry is one checkbox away.

Rate limits start at two a second

Rate limits on this API are per subscription: two requests a second on the free plan, ten on Team, twenty on Professional, fifty on Enterprise. The default pacing here is 120 requests a minute, which matches the free plan, because that is what most first runs are on. Raise it to match yours.

Example output

{
  "recordType": "address",
  "requested": "219 North Terrace, Adelaide SA 5000",
  "found": true,
  "crs": "gda94",
  "matchType": "address",
  "matchQuality": "exact",
  "matchScore": 1,
  "geometryType": "Point",
  "latitude": -34.92123456,
  "longitude": 138.60123456,
  "addressId": "GASA_424242424",
  "formattedAddress": "219 NORTH TERRACE, ADELAIDE SA 5000",
  "localityName": "ADELAIDE",
  "stateTerritory": "SA",
  "postcode": "5000",
  "streetNumber1": 219,
  "streetName": "NORTH",
  "streetType": "TERRACE",
  "cadastralIdentifier": "D12345 A100",
  "geoFeature": "address"
}

FAQ

What Australian address data does this actor return?

Verified addresses from the national address file with their identifiers, every parsed address part, coordinates, geocode feature level and match quality, plus optional bundles covering statistical areas, remoteness, socioeconomic indexes, electorates, local government area, the parcel and property behind the address, buildings and solar panels. It also returns cadastre parcels, properties, building footprints and attributes, administrative boundaries and the bulk dataset catalogue.

How do I verify an Australian address?

Run geocode mode with the address as one line, or fill in the separate address part inputs. Each result carries a match type, match code, match quality and score. Set the minimum feature level to address if a suburb centroid is not an answer you can use, and the run will report a miss rather than quietly hand you a locality.

What is G-NAF and is this it?

G-NAF is Australia's authoritative address file, compiled from state and territory land registries and other contributing sources. This actor reads the provider's APIs over that dataset, so address identifiers returned here are the ones other G-NAF derived datasets join on. You can also search the continuous address dataset, which includes addresses the national file has not adopted yet.

Can I get building footprints and heights?

Yes. The building modes return footprints by building identifier, by point with an optional radius, or inside a bounding box, and the building attributes input adds height, roof material and shape, solar panels and the pool indicator. Each attribute family may be entitled separately on your plan.

What is the difference between a cadastre parcel and a property?

A cadastre parcel is a land registry parcel: the surveyed lot in the register. A property is the thing people own and occupy, which may combine several parcels or sit as one of many strata lots inside one. Both are available here, both by identifier, point and bounding box, and the base parcels and base properties switches keep strata subdivisions from multiplying your rows.

Which coordinate system should I ask for?

GDA2020 if you are joining to current Australian survey or cadastral data. WGS84 if you are plotting on a web map or joining to global data. GDA94 is the provider's default and what most older Australian datasets are in. Whichever you pick, every row records it.

Why did my bounding box request come back empty?

A bounding box here is four comma separated numbers in the order bottom left longitude, bottom left latitude, top right longitude, top right latitude, to five decimal places or fewer. Latitude and longitude the other way round describes a box somewhere in the ocean rather than an error, so the order matters more than the precision.

How do I find out what my key covers?

Run the dataset catalogue mode with licensed datasets only switched on. It lists the products, regions, releases and formats this account can actually download, which turns a later entitlement refusal into something you knew in advance.

Keyword map

Australian address API, address validation Australia, G-NAF API, address autocomplete Australia, address verification API, geocoding API Australia, reverse geocoding Australia, cadastre API, land parcel data Australia, property boundaries API, building footprint API, building height data, roof data API, solar panel data Australia, swimming pool detection data, ABS mesh block API, SEIFA data API, local government area lookup, electoral boundary API, postcode lookup Australia, DPID mail point, address barcode Australia, GDA2020 coordinates, GDA94 WGS84 difference, property data API Australia