Australian addresses, resolved
Turn an address someone typed into a G-NAF id, a coordinate, an ABS mesh block and fields your own schema has room for. One call, and the same answer every time, because the id is the address rather than the text.
Free for the first 10,000 lookups a month. No card, and the free tier does not expire.
Try it
Live, against the free tier. Start with a street number.
Number first, then the street. A suburb narrows it.
What an address resolves to
- A G-NAF id
- The Address Detail PID from the Geocoded National Address File, the national address register. Store it against your own record and two systems agree they mean the same door, whatever either of you does to the formatting later.
- Coordinates
- Latitude and longitude from G-NAF itself, not from a geocoder guessing at a string. Ready to put a pin on a map or to hand to a routing engine.
- An ABS mesh block
- The smallest area the census publishes, and the join key to every ABS statistic about where an address sits. Included, not billed separately.
- Structured components
- Unit, level, number, street name, street type, suburb, state, postcode, each in its own field and named the way G-NAF names it. No parsing a formatted line back apart.
Four endpoints
Not fourteen. Validation, geocoding and parsing are one question, so they are one call.
GET /v1/addresses?q=Suggest as somebody typesPrefix matched down the street index, fast enough for a keystroke. Every result is a resolved address, so there is no second call to find out what was picked.
GET /v1/addresses/resolve?q=Resolve one you already holdFor an address off a checkout form or a spreadsheet row. Abbreviations, missing commas and a missing state are all fine.
GET /v1/addresses/similar?q=When it is misspelled1 gorge rd sydenhum is one address, and saying which is the point.
GET /v1/addresses/{gnaf_pid}Read it back laterThe id you stored, a year on, without knowing how it was originally typed.
Where the data comes from
G-NAF, the Geocoded National Address File, published by Geoscape Australia under an open licence. It is the address register the ABS, Australia Post and the states themselves work from: roughly sixteen million addresses, updated quarterly. We load every release, keep the components G-NAF ships rather than reformatting them, and return the ids unchanged.
No third party geocoder sits in the middle, so there is nothing to disagree with and no per-request licence to pass on.