Skip to contents

Fetch ASGS geometries for the Commonwealth Electoral Divisions (CEDs) geography.

Usage

ced(
  identifier = NULL,
  edition = NULL,
  reference_date = NULL,
  layer = c("gen", "full", "point"),
  where = NULL,
  filter_geom = NULL,
  predicate = c("intersects", "contains", "crosses", "overlaps", "touches", "within"),
  cache = getOption("ozgs.cache"),
  ...
)

Arguments

identifier

An optional character vector of named features to download from the specified geography. For most ASGS geographies, these are human-friendly names like e.g. "Tasmania" (a feature within the STE geography), "Sydney" (a feature within the LGA geography) or "2150" (a feature within the POA geography). If specified, identifier takes precedence over where. If neither identifier nor where are specified, all of the features in the specified geography will be downloaded.

edition

An ASGS edition: 1, 2, or 3.

reference_date

The geography's year of release. For most geographies, reference_year is optional and specifying an edition will be sufficient. However, for LGAs, CEDs and SEDs, the ASGS contains multiple releases per edition. For these geographies, a reference_date must be supplied to uniquely identify a release.

layer

One of:

  • "gen", the default. Fetches simplified geometries that have been generalised to 0.000025° or 2.5m.

  • "full", full ASGS geometries. Identical to ASGS Shapefile and Geopackage downloads.

  • "point", point geometries for each records in a geography.

where

An optional SQL WHERE clause to filter the features returned by the request. Ignored if identifier is specified.

filter_geom

An optional sf::sfc or single sf geometry to filter the records returned by the request.

predicate

An optional spatial predicate to specify the relation between filter_geom and geography. One of "intersects", "contains", "crosses", "overlaps", "touches", and "within".

cache

A cachem-compatible cache. If not otherwise specified, defaults to a memory cache. To persistently store downloaded ASGS geometries and data, supply an object created by cachem::cache_disk().

...

Additional arguments passed to arcgislayers::arc_read().

Details

Commonwealth Electoral Divisions (CED) are an ABS MB approximation of Australian Electoral Commission (AEC) federal electoral division boundaries. An Australian Electoral Commission electoral division boundary is an area legally prescribed for the purpose of returning one member to the House of Representatives, Australia's Federal Lower House of Parliament. Boundaries are based on the Australian Electoral Commission electoral division boundaries available prior to publication. Commonwealth Electoral Divisions may change as the Australian Electoral Commission revise their boundaries. Where this occurs, Commonwealth Electoral Divisions will be updated on an annual basis in conjunction with updates of other Non ABS Structures. Please note that ABS approximated boundaries do not match official legal or administrative boundaries and should only be used for statistical purposes. Further information about these regions can be found in the following publication: Australian Statistical Geography Standard (ASGS) Edition 3 https://www.abs.gov.au/statistics/standards/australian-statistical-geography-standard-asgs-edition-3/jul2021-jun2026

Availability

The following combinations of ASGS edition and reference_date are available:

geographyeditionreference_date
CED12011
CED12012
CED22016
CED22017
CED22018
CED32021