Guides
for everything Geocodio
Guides
for everything Geocodio
Australian Federal Electorates
Geocodio can return the federal and state electorates for Australian addresses, postcodes, or coordinates. An electorate, also called a division or electoral district, is the area that elects members to a lower house of parliament. Two categories of electorate data are available:
Federal electorates (
au-federal-electorateandau-federal-electorate-next): House of Representatives divisions, called Commonwealth Electoral Divisions (CED) by the ABSState and territory electorates (
au-state-electorate): Legislative Assembly and House of Assembly electorates, called State Electoral Divisions (SED) by the ABS
This guide covers federal electorates, the 150 areas that each elect one member to the House of Representatives.
Geocodio doesn't return Senate data, or the names or contact details of members of parliament.
How do I add federal electorates to my addresses?
Via the API, add one of these appends to the fields parameter, for single addresses or batches:
| Append | Response key | Returns |
|---|---|---|
au-federal-electorate
|
au_federal_electorate
|
The federal electorate (House of Representatives division) |
au-federal-electorate-next
|
au_federal_electorate
|
The same, using the boundaries for the next election where a redistribution has been decided |
If you're uploading a spreadsheet, choose the federal electorate append in the data appends step of the upload process.
What does Geocodio return for each electorate?
au_federal_electorate is a list of electorates, and every entry has the same keys:
name: the electorate's name, spelled the way the ABS spells it (e.g. "McEwen", "O'Connor").code: the ABS code for the electorate, the state digit and 2 more digits, such as802for Canberra. Upcoming electorates can have anullcode until the ABS allocates one.ocd_id: the Open Civic Data ID, built from the state or territory and the electorate's name. It's always present, so if you store electorates, key them onocd_id. See the OCD IDs guide.state: the state or territory the electorate belongs to, such asVICorACT.proportion: how much of the matched area falls in this electorate, from 0 to 1. See below.is_upcoming_district:trueonly when the electorate comes from upcoming boundaries.source: the boundary publisher.
Here is the result for 83 Torrens Street, Braddon ACT 2612:
{
"results": [
{
"formatted_address": "83 Torrens St, Braddon ACT 2612",
"location": {
"lat": -35.265582,
"lng": 149.135149
},
"accuracy_type": "rooftop",
"fields": {
"au_federal_electorate": [
{
"name": "Canberra",
"code": "802",
"ocd_id": "ocd-division/country:au/territory:act/federal_electorate:canberra",
"state": "ACT",
"proportion": 1,
"is_upcoming_district": false,
"source": "Geoscape Australia"
}
]
}
}
]
}
The full response schema is in the API docs.
Election-focused? Use the -next variant
Australia redraws its federal electorates in a process called a redistribution. New boundaries are usually decided months before the election that first uses them. Until that election, a state or territory has two sets of electorate boundaries: the current ones, which today's members represent, and the upcoming ones, which will be used in the next election.
| Append | Returns | Use it for |
|---|---|---|
au-federal-electorate
|
The electorates members sit for today | Contacting a current member, or matching constituents to their current representative |
au-federal-electorate-next
|
The boundaries for the next election, where a redistribution has been decided. Everywhere else, today's electorates. | Election campaigns, voter outreach, and planning around an upcoming election |
is_upcoming_district tells you which one you got. It's true for an upcoming electorate and false for today's. New boundaries appear only after Geoscape Australia includes them in a release. Until then, au-federal-electorate-next returns the same electorates as au-federal-electorate.
Both appends' results are returned under the same key,
au_federal_electorate. If you request both in one call, you get only the next-election electorates, billed as one lookup. To compare an address's current and upcoming electorates, make two separate requests, one with each field.The upcoming set is chosen per state or territory. Where one exists, every electorate in that state returns
is_upcoming_district: true, including electorates whose boundaries didn't change. To find out whether a particular address moves, compare theocd_idfrom the two requests.If you're working on an election, use
au-federal-electorate-next. It returns the new boundaries where they exist and today's electorate everywhere else, so you don't have to track redistributions yourself.
What about Jervis Bay, Norfolk Island, and the other territories?
Addresses in Australia's external and other territories have a federal electorate, even though they aren't part of a state:
| Territory | Federal electorate |
|---|---|
| Jervis Bay Territory | Fenner (ACT) |
| Norfolk Island | Bean (ACT) |
| Christmas Island and the Cocos (Keeling) Islands | Lingiari (NT) |
The state field is the state or territory the electorate belongs to, so Jervis Bay returns "state": "ACT".
Why does an address return more than one electorate?
A rooftop or street-level match falls inside exactly one electorate, so it returns one electorate, with a proportion of 1.
A suburb or postcode match can return several. Geocodio returns every electorate that overlaps the postcode in the result's address_components, including for a suburb match, and ranks the list by proportion, highest first.
Each one's proportion is its share of the postal area's surface, so the shares for a postcode add up to about 1. Electorates covering less than 0.01% of the postal area are left out, and very small shares are given to 4 decimal places so they don't show as 0.
For postcode 3030, Geocodio returns:
| Federal electorate | proportion |
|---|---|
| Corio | 0.308 |
| Lalor | 0.295 |
| Hawke | 0.238 |
| Gellibrand | 0.160 |
A bare postcode query like this returns one result for each suburb in the postcode, and each result carries the same list.
Check the proportions before you use the first entry. They measure area, not population, so a large rural part of a postcode can outweigh the suburb where most people live. In the example above, Corio comes first but covers less than a third of the postal area. The first entry tells you which electorate covers the most land, not which one a given address is in.
To get one electorate per address, use full street addresses or coordinates instead of postcodes.
Cost
Australian geocoding and coordinate lookups cost 1 credit each. A federal electorate append adds 1 credit per address, so an Australian address with au-federal-electorate costs 2 credits in total. Requesting au-federal-electorate and au-federal-electorate-next together counts as one lookup.
Australia is available on all plans, including Pay-As-You-Go. See Country support.
Where does the boundary data come from?
Electorate boundaries come from Geoscape Australia's Administrative Boundaries. Electorate codes come from the ABS allocation files, and names use the ABS spelling. Both are published under the Creative Commons Attribution 4.0 International licence (CC BY 4.0). If you display or redistribute the data, Geoscape asks for this attribution:
Incorporates or developed using Administrative Boundaries © Geoscape Australia licensed by the Commonwealth of Australia under Creative Commons Attribution 4.0 International licence (CC BY 4.0).