publicdataau publicdata.au on GitHub
Published by Department of Industry, Science and Resources under CC BY 4.0 and republished here without change to the content. Department of Industry, Science and Resources has not endorsed this site.An independent republication of open government data. No government agency has endorsed it. Read more

Suburb and locality boundaries, New South Wales (Geoscape)

live
Publisher Department of Industry, Science and ResourcesUpdated quarterlyLicence CC BY 4.0Latest 2026-08-17Rows 4,611Fields 6

The NSW suburb and locality layer of Geoscape Administrative Boundaries, read from the GDA2020 Esri shapefile release on data.gov.au. Each row is one locality polygon with Geoscape's polygon and locality identifiers, its creation date, name, class and state. The newest quarterly release is followed.

Also called: NSW suburb boundaries, NSW locality boundaries GeoJSON, Sydney suburb boundaries shapefile, Geoscape Localities NSW.

Part of Geoscape suburb and locality boundaries, 8 tables the publisher releases together: Suburb and locality boundaries, Victoria (Geoscape), Suburb and locality boundaries, Western Australia (Geoscape), Suburb and locality boundaries, South Australia (Geoscape), Suburb and locality boundaries, Tasmania (Geoscape), Suburb and locality boundaries, Northern Territory (Geoscape), Suburb and locality boundaries, Australian Capital Territory (Geoscape), Suburb and locality boundaries, Other Territories (Geoscape).

Before you use it
What is in each row?
One suburb or locality of New South Wales, with Geoscape's identifiers for the polygon and the locality, the date the record was created, the locality's name, its class, such as Gazetted Locality, and the state. Its shape is in the GeoParquet, GeoJSON, GeoPackage and PMTiles files. A locality made of separate pieces, such as one with islands, has a row for each piece.
How do these differ from the ABS suburbs and localities?
These follow the official locality boundaries in the NSW cadastre and change each quarter as localities are named or moved. The ABS Suburbs and Localities layer is built from mesh blocks for one census, so its edges differ from these.
Can I use it for a commercial product?
The Commonwealth released Administrative Boundaries under CC BY 4.0. The release notes ask that use is consistent with the Australian Privacy Principles and that adapted material carry the words in the attribution here, which every file carries. Geoscape Australia has not endorsed this site.
4,611localities
2022 to 2025years drawn
6fields
12formats
1version
05001k1.5k2k2022: 15520222023: 17920232024: 54820242025: 1,5672025
Locality polygons by the year Geoscape created their current record per year, 2022 to 2025. 2021 is not drawn because the rows begin on 24 June 2021. 2026 is not drawn because the rows run to 24 June 2026. The figure is a count of rows from version 2026-08-17, worked out in the build. Nothing else is added.

Made for agents

Connect your AI agent

Any agent that connects to publicdata.au/mcp can find this dataset, read its 6 fields, count and filter across all 4,611 rows and diff its versions. Every answer names the version and carries DISR's attribution. No key.

Then ask it: What does Suburb and locality boundaries, New South Wales (Geoscape) hold, and what changed in the newest version?

claude mcp add --transport http publicdata https://publicdata.au/mcp

One command. No key, no account, no sign-up.

Download it as Excel, CSV, JSON and 9 more formats

Pick a format and a version. Excel is picked first because it opens in the tools most offices have. The URL is yours to keep. A dated version never changes.

Format
"Latest" redirects to the newest version and will change when the publisher releases again. A dated version never changes.
https://publicdata.au/d/au-localities-nsw/latest/data.xlsx
Download

In your own tools

Use it in Excel, R, Python and more

Excel and Power BI read the CSV from its address and refresh from it. The R and Python packages take any dataset on this site by its slug, so a new dataset needs no new release. The DuckDB file attaches read-only over HTTPS, and a query reads only the blocks it touches.

The dated URL in the code never changes. https://publicdata.au/d/au-localities-nsw/latest/ redirects to the newest version.

https://publicdata.au/d/au-localities-nsw/latest/data.csv

In Excel choose Data, then From Web, and paste this address. Excel keeps it, so Refresh All reads the newest version. A sheet holds about a million rows; past that, load the query to the Data Model.

What is in it

Column names are made snake_case and the publisher's original header is kept beside each one. Blank cells are null. Nothing is added, removed, ranked or summarised.

FieldTypePublisher's headerNote
lc_ply_pidstringLC_PLY_PID
loc_pidstringLOC_PID
date_createddateDT_CREATE
locality_namestringLOC_NAME
locality_classstringLOC_CLASS
statestringSTATE

Download this table as a data dictionary (Excel), or read it as a Frictionless Table Schema at schema.json. The key is lc_ply_pid.

A sample of 10 rows

From the latest version, newest first by date created, then in the publisher's order, with every field. A blank cell is shown as null.

lc_ply_pidloc_piddate_createdlocality_namelocality_classstate
lcppkquWqgQdLbqloced90abd695592026-06-24LarnookGazetted LocalityNSW
lcp6rSf7gcM3nMzloce057c225ca6d2026-06-24CondobolinGazetted LocalityNSW
lcpvDqzi8td_yfgloc7810ba818b782026-06-24LornGazetted LocalityNSW
lcp0lHZIgGRnCmUlocc7db8f18469c2026-06-24Batemans BayGazetted LocalityNSW
lcpBwrNTv-U19bWloc07e4221a6f102026-06-24Booti BootiGazetted LocalityNSW
lcp4SMf7WYHIaS_loc96e4127f10472026-06-24Berowra HeightsGazetted LocalityNSW
lcp5FCTC1fxcErqloc9a09c93a8c4e2026-06-24Theresa ParkGazetted LocalityNSW
lcpSTmKXyDEMbULloc6fd694169c652026-06-24Kiama DownsGazetted LocalityNSW
lcphcJZB6PxtvDdlocd16a0e11ef7e2026-06-24PittwaterGazetted LocalityNSW
lcpVS8Nbq0Boc7iloc8fd76f88db072026-06-24Ben LomondGazetted LocalityNSW
The first row as JSON

As it appears in data.json.

GET https://publicdata.au/d/au-localities-nsw/latest/data.json
{
  "lc_ply_pid": "lcppkquWqgQdLbq",
  "loc_pid": "loced90abd69559",
  "date_created": "2026-06-24",
  "locality_name": "Larnook",
  "locality_class": "Gazetted Locality",
  "state": "NSW"
}

Query it without downloading

The query API returns only the rows you ask for, as JSON, NDJSON or CSV, from the same typed rows as the files. It needs no key. Build a query here and run it, then copy the URL or the code into your own work.

Try rows or aggregate for this dataset. The query builder needs JavaScript.

How filters work

Each filter is field=operator.value in the query string, and every filter must match. A number or date field compares as a number or date, and a text field compares as text. Values are case-sensitive except with ilike. Prefix not. to negate a filter, as not.eq.value.

OperatorWhat it matches
eq.valueEqual to the value.
neq.valueNot equal to the value. A blank cell does not match.
gt.valueGreater than the value.
gte.valueGreater than or equal to the value.
lt.valueLess than the value.
lte.valueLess than or equal to the value.
like.*text*Matches a pattern where * stands for any run of characters. Case-sensitive.
ilike.*text*The same as like, ignoring case.
in.(a,b,c)Equal to any value in the list. A value cannot contain a comma.
is.nullBlank in the source, or suppressed by the publisher.
ParameterWhat it does
selectFields to return, comma-separated. Every field when absent.
orderfield.asc or field.desc, comma-separated. The publisher's row order when absent.
limitRows per page, 1 to 10,000. 100 when absent.
offsetRows to skip. The next URL in each answer sets it for you.
groupOn aggregate, fields to group by, comma-separated.
metricOn aggregate, count, sum.field, avg.field, min.field or max.field, comma-separated. count when absent.
formatjson, ndjson or csv. JSON carries the provenance header, and the others carry it in response headers.

Without a version the API answers from the newest loaded version, and that answer changes when the publisher releases again. Put versions/<date>/ before rows or aggregate for an answer that never changes. /api/v1/datasets/<slug>/versions lists the loaded versions. The 1 newest version is loaded; versions lists them.

The API allows 60 requests in 10 seconds from one address. Above that it answers 429 for 10 seconds with a Retry-After header, a RateLimit-Policy header and a JSON body that gives the limit. Every API answer carries the same RateLimit-Policy. A client should wait the Retry-After seconds, or read the files, which have no limit. openapi.json describes this dataset's query paths for client generators and agents.

https://publicdata.au/mcp is a remote MCP server over Streamable HTTP with the same tools, defined in the same place, so a tool added to the pages is added here too. It needs no key and no account. The row tools are held to the query API's limit of 60 queries in 10 seconds from one address, and each call is two queries because it also counts the matching rows. Add it to Claude Code with claude mcp add --transport http publicdata https://publicdata.au/mcp, add the URL in Claude as a custom connector, or give it to any client that connects to remote MCP servers. Each queryable dataset is also a resource at https://publicdata.au/d/<slug>/fields.json, which lists its fields with their types, the publisher's descriptions, their ranges and the values they hold, so an agent can read a dataset's shape before it writes a query.

What changed

One version for every release the publisher has made since this site started following the dataset. The date is the day the file changed on the portal.

versions.json · changes.json · history.tar.zst (81 MB, every version's Parquet and manifest)

Questions

How do I download Suburb and locality boundaries as a CSV file?

Open https://publicdata.au/d/au-localities-nsw/latest/data.csv. It redirects to the newest dated version, which is https://publicdata.au/d/au-localities-nsw/v/2026-08-17/data.csv today. The same path serves Excel, JSON, GeoJSON, Parquet, SQLite, DuckDB, GeoPackage, PMTiles, NDJSON, Arrow. A dated URL never changes, so use it when the file must stay the same.

Can I open Suburb and locality boundaries in Excel?

Yes. https://publicdata.au/d/au-localities-nsw/v/2026-08-17/data.xlsx is a workbook with the 4,611 rows on a records sheet, the field list on a second sheet and the provenance on a third. The CSV also opens in Excel. https://publicdata.au/d/au-localities-nsw/v/2026-08-17/data.csv.gz is the CSV at about a tenth of the size.

What years does Suburb and locality boundaries cover?

The current version covers 2022 to 2025. Each release from DISR becomes a new dated version here, and earlier versions stay online.

How often is Suburb and locality boundaries updated?

DISR releases it quarterly. This site checks the portal every week and adds a dated version when the file changes.

Can I use Suburb and locality boundaries commercially?

Yes. CC BY 4.0 allows commercial use, redistribution and derived works as long as the attribution is kept. The attribution string is in this page's side column and inside every file.

Is this the official source for Suburb and locality boundaries?

No. The publisher is Department of Industry, Science and Resources, and its page is https://data.gov.au/data/dataset/nsw-suburb-locality-boundaries-geoscape-administrative-boundaries. This site republishes the publisher's file without changing its content. The original sits beside every version as source.zip with its SHA-256, so the two can be compared.

What coordinate system does Suburb and locality boundaries use?

Shapes in GDA2020 (EPSG:7844), the datum of the shapefile release read. The GeoJSON file uses GDA2020 as well, which differs from the WGS84 GeoJSON expects by well under a metre.

What this site did to the data. Cells were typed, headers were renamed and the encoding was made UTF-8. Rows were left alone. The publisher's file sits beside every version as source.zip so the change can be checked.

The publisher releases Geoscape suburb and locality boundaries as 8 files at once, so all 8 tables here share a version date.