Guides
for everything Geocodio
Guides
for everything Geocodio
Australian State & Territory 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 state and territory electorates: the areas that elect members to the Legislative Assembly in each state and territory. (South Australia and Tasmania call their lower house the House of Assembly.)
Geocodio doesn't return the state Legislative Councils, or the names or contact details of members of parliament.
How do I add state electorates to my addresses?
Via the API, add au-state-electorate to the fields parameter, for single addresses or batches. The response key is au_state_electorate. It counts as its own lookup.
If you're uploading a spreadsheet, choose the state electorate append in the data appends step of the upload process.
The state append always returns the current state electorates. There is no au-state-electorate-next.
What does Geocodio return for each electorate?
au_state_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.code: the ABS code for the electorate, the state digit and 4 more digits, such as80003for Kurrajong. Codes arenullin Victoria and Tasmania. See below.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.chamber:house_of_assemblyin South Australia and Tasmania, andlegislative_assemblyeverywhere else.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_state_electorate": [
{
"name": "Kurrajong",
"code": "80003",
"ocd_id": "ocd-division/country:au/territory:act/sldl:kurrajong",
"state": "ACT",
"chamber": "legislative_assembly",
"proportion": 1,
"is_upcoming_district": false,
"source": "Geoscape Australia"
}
]
}
}
]
}
The full response schema is in the API docs.
Which states and territories are covered?
Geocodio returns the electorate for the lower house of parliament (or the only house, in Queensland and the territories) in all eight states and territories with their own parliament:
| State or territory | House | chamber | Electorates | Members per electorate |
|---|---|---|---|---|
| New South Wales | Legislative Assembly |
legislative_assembly
|
93 | 1 |
| Victoria | Legislative Assembly |
legislative_assembly
|
88 | 1 |
| Queensland | Legislative Assembly (the only house) |
legislative_assembly
|
93 | 1 |
| Western Australia | Legislative Assembly |
legislative_assembly
|
59 | 1 |
| South Australia | House of Assembly |
house_of_assembly
|
47 | 1 |
| Tasmania | House of Assembly |
house_of_assembly
|
5 | 7 |
| Australian Capital Territory | Legislative Assembly (the only house) |
legislative_assembly
|
5 | 5 |
| Northern Territory | Legislative Assembly (the only house) |
legislative_assembly
|
25 | 1 |
States call their electorates different things, such as districts, divisions, or electorates. Geocodio returns them all in the same field.
Tasmania uses the federal boundaries. Tasmania's five House of Assembly divisions share their names and boundaries with its five federal electorates, so an address in Howrah is in Franklin for both. Each division elects seven members.
The other territories have no state electorate. Jervis Bay, Norfolk Island, Christmas Island, and the Cocos (Keeling) Islands have no state or territory parliament, so
au_state_electorateis left out for those addresses. They do have a federal electorate.
Why is code null in Victoria and Tasmania?
Geocodio gets electorate codes from the ABS allocation file, which has no codes for Victorian or Tasmanian state electorates, so code is null for those. ocd_id is always present, so use it to identify electorates when you store or join them.
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:
| State electorate | proportion |
|---|---|
| Werribee | 0.684 |
| Point Cook | 0.314 |
| Eureka | 0.0003 |
| Lara | 0.0002 |
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. 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. au-state-electorate adds 1 credit per address, so an Australian address with its state electorate costs 2 credits in total. Adding the federal electorate too brings it to 3 credits.
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).