Method of travel to work
/v1/suburbs/{suburb_name}/area-stats/travel-to-work5¢ per callHow working residents got to work: car as driver or passenger, train, bus, tram, ferry, bike, walking, working from home, and the share using public transport, for every suburb and council area.
Coverage: About 8,800 suburbs and localities and 540 council areas across Australia, in all states and territories (areas with too few people or homes for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10. Full description, field list and method: /v1/datasets/travel-to-work.
Exact suburb identifier required. Exact official suburb name (SAL), e.g. Burwood (NSW) — many suburbs carry a state suffix. If starting from free text or an unverified bare name, first call GET /v1/geocode/suburb?q=<text>, then use the exact data[].area_name it returns. Suburb data endpoints do not guess a state or typo-correct names.
Authorization
Request
The only values you send. Fields under Responses below are what comes back — you never pass those.
Path parameters
suburb_namestringrequiredExact official suburb name (SAL), e.g. `Burwood (NSW)` — many suburbs carry a state suffix. If starting from free text or an unverified bare name, first call `GET /v1/geocode/suburb?q=<text>`, then use the exact `data[].area_name` it returns. Suburb data endpoints do not guess a state or typo-correct names.
Query parameters
fieldsstringoptionalComma-separated subset of: total_employed, public_transport_count, public_transport_pct, car_as_driver_count, car_as_driver_pct, car_as_passenger_count, car_as_passenger_pct, train_count, train_pct, bus_count, bus_pct, ferry_count, ferry_pct, tram_or_light_rail_count, tram_or_light_rail_pct, taxi_or_ride_share_count, taxi_or_ride_share_pct, truck_count, truck_pct, motorbike_or_scooter_count, motorbike_or_scooter_pct, bicycle_count, bicycle_pct, walked_only_count, walked_only_pct, other_single_method_count, other_single_method_pct, two_methods_count, two_methods_pct, two_methods_with_train_count, two_methods_with_train_pct, two_methods_with_bus_count, two_methods_with_bus_pct, three_methods_count, three_methods_pct, worked_at_home_count, worked_at_home_pct, did_not_go_to_work_count, did_not_go_to_work_pct, method_not_stated_count, method_not_stated_pct. Omit for all.
fromstringoptionalFirst period to include: 2020, 2020-Q3, 2020-07 or 2020-07-01.
tostringoptionalLast period to include, same formats as `from`.
Responses
Successful Response
datasetstringalways returnedDataset slug; describe it with /v1/datasets/{slug}.
levelstringalways returnedsuburb, lga or block.
areastringalways returnedCanonical name (or mesh-block code) of the area answered.
period_typestringalways returnedsnapshot, year, financial_year, quarter or month.
as_ofstring · datealways returnedDate the dataset is current to. Values are never withheld for age; check this instead.
modelledbooleanalways returnedTrue when the figures are estimates from a model rather than counts or measurements.
fieldsarray of DatasetFieldSeriesalways returned/v1/suburbs/{suburb_name}/area-stats/travel-to-workcurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/area-stats/travel-to-work' \
--header 'Authorization: Bearer test'{
"data": {
"dataset": "travel-to-work",
"level": "suburb",
"area": "Bondi",
"period_type": "snapshot",
"as_of": "2021-08-10",
"modelled": false,
"fields": [
{
"field": "total_employed",
"name": "Employed residents",
"unit": "persons",
"values": [
{
"period": "2021-08-10",
"period_start": "2021-08-10",
"value": 6098
}
]
},
{
"field": "public_transport_count",
"name": "Public transport (train, bus, ferry or tram, alone or with another method)",
"unit": "persons",
"values": [
{
"period": "2021-08-10",
"period_start": "2021-08-10",
"value": 426
}
]
},
{
"field": "public_transport_pct",
"name": "Public transport (train, bus, ferry or tram, alone or with another method): share of employed residents",
"unit": "%",
"values": [
{
"period": "2021-08-10",
"period_start": "2021-08-10",
"value": 6.99
}
]
}
]
}
}About this dataset
About 8,800 suburbs and localities and 540 council areas across Australia, in all states and territories (areas with too few people or homes for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10; refreshed five-yearly.
What it is
How employed residents travelled to work on 10 August 2021, for every suburb and council area: each single method (train, bus, ferry, tram or light rail, taxi or ride share, car as driver, car as passenger, truck, motorbike or scooter, bicycle, walked only, other), trips with two or three methods, and those who worked at home or did not go to work that day, with a public-transport total.
What it shows
Employed residents by method of travel to work, each as a head-count and as a share of all employed residents, plus the total employed. Counts and shares are separate fields (for example train_count and train_pct). public_transport counts anyone who used a train, bus, ferry or tram for the trip, alone or with another method.
Why use it
Commuting shows how well a suburb is served by transport and how car-dependent it is. Use it to find suburbs where many people take the train or bus, to judge the value of a station or new transport line, to see where cycling and walking to work are common, to plan parking or transit-oriented development, or to add a commuting profile to a suburb report.
How it is built
The base is employed residents aged 15 and over. The day was a Tuesday during COVID-19 lockdowns in Greater Sydney, Melbourne and parts of regional New South Wales and Victoria, so in those areas working at home and not going to work are far higher, and public transport far lower, than in a normal year; compare those areas with care. Single-method fields count people who used only that method. public_transport adds single trips by train, bus, ferry or tram and multi-method trips that include a train or a bus (a few two-method trips pairing a ferry or tram with a car are not in it). Areas with fewer than 50 employed residents are left out. Our 2021 area statistics, matched to our suburb and council-area names. Figures are a snapshot at 10 August 2021 (the latest full count), so they describe the area then, not today. To protect privacy the source lightly randomises small numbers, so a count of 0, 3 or 6 can be approximate and shares in small areas jump around: check the base field before trusting a percentage. Shares are rounded to two decimals and capped at 100.
Fields
| Field | Unit | Description |
|---|---|---|
total_employedEmployed residents | persons | Employed residents aged 15 and over, the base for every share. |
public_transport_countPublic transport (train, bus, ferry or tram, alone or with another method) | persons | Number of employed residents who travelled to work by: Public transport (train, bus, ferry or tram, alone or with another method) (2021 snapshot). Small counts are lightly randomised for privacy. |
public_transport_pctPublic transport (train, bus, ferry or tram, alone or with another method): share of employed residents | % | Public transport (train, bus, ferry or tram, alone or with another method) as a percent of all employed residents in the area. |
car_as_driver_countCar, as driver only | persons | Number of employed residents who travelled to work by: Car, as driver only (2021 snapshot). Small counts are lightly randomised for privacy. |
car_as_driver_pctCar, as driver only: share of employed residents | % | Car, as driver only as a percent of all employed residents in the area. |
car_as_passenger_countCar, as passenger only | persons | Number of employed residents who travelled to work by: Car, as passenger only (2021 snapshot). Small counts are lightly randomised for privacy. |
car_as_passenger_pctCar, as passenger only: share of employed residents | % | Car, as passenger only as a percent of all employed residents in the area. |
train_countTrain only | persons | Number of employed residents who travelled to work by: Train only (2021 snapshot). Small counts are lightly randomised for privacy. |
train_pctTrain only: share of employed residents | % | Train only as a percent of all employed residents in the area. |
bus_countBus only | persons | Number of employed residents who travelled to work by: Bus only (2021 snapshot). Small counts are lightly randomised for privacy. |
bus_pctBus only: share of employed residents | % | Bus only as a percent of all employed residents in the area. |
ferry_countFerry only | persons | Number of employed residents who travelled to work by: Ferry only (2021 snapshot). Small counts are lightly randomised for privacy. |
ferry_pctFerry only: share of employed residents | % | Ferry only as a percent of all employed residents in the area. |
tram_or_light_rail_countTram or light rail only | persons | Number of employed residents who travelled to work by: Tram or light rail only (2021 snapshot). Small counts are lightly randomised for privacy. |
tram_or_light_rail_pctTram or light rail only: share of employed residents | % | Tram or light rail only as a percent of all employed residents in the area. |
taxi_or_ride_share_countTaxi or ride share only | persons | Number of employed residents who travelled to work by: Taxi or ride share only (2021 snapshot). Small counts are lightly randomised for privacy. |
taxi_or_ride_share_pctTaxi or ride share only: share of employed residents | % | Taxi or ride share only as a percent of all employed residents in the area. |
truck_countTruck only | persons | Number of employed residents who travelled to work by: Truck only (2021 snapshot). Small counts are lightly randomised for privacy. |
truck_pctTruck only: share of employed residents | % | Truck only as a percent of all employed residents in the area. |
motorbike_or_scooter_countMotorbike or scooter only | persons | Number of employed residents who travelled to work by: Motorbike or scooter only (2021 snapshot). Small counts are lightly randomised for privacy. |
motorbike_or_scooter_pctMotorbike or scooter only: share of employed residents | % | Motorbike or scooter only as a percent of all employed residents in the area. |
bicycle_countBicycle only | persons | Number of employed residents who travelled to work by: Bicycle only (2021 snapshot). Small counts are lightly randomised for privacy. |
bicycle_pctBicycle only: share of employed residents | % | Bicycle only as a percent of all employed residents in the area. |
walked_only_countWalked only | persons | Number of employed residents who travelled to work by: Walked only (2021 snapshot). Small counts are lightly randomised for privacy. |
walked_only_pctWalked only: share of employed residents | % | Walked only as a percent of all employed residents in the area. |
other_single_method_countOther single method | persons | Number of employed residents who travelled to work by: Other single method (2021 snapshot). Small counts are lightly randomised for privacy. |
other_single_method_pctOther single method: share of employed residents | % | Other single method as a percent of all employed residents in the area. |
two_methods_countTwo methods | persons | Number of employed residents who travelled to work by: Two methods (2021 snapshot). Small counts are lightly randomised for privacy. |
two_methods_pctTwo methods: share of employed residents | % | Two methods as a percent of all employed residents in the area. |
two_methods_with_train_countTwo methods, one of them train | persons | Number of employed residents who travelled to work by: Two methods, one of them train (2021 snapshot). Small counts are lightly randomised for privacy. |
two_methods_with_train_pctTwo methods, one of them train: share of employed residents | % | Two methods, one of them train as a percent of all employed residents in the area. |
two_methods_with_bus_countTwo methods, one of them bus (no train) | persons | Number of employed residents who travelled to work by: Two methods, one of them bus (no train) (2021 snapshot). Small counts are lightly randomised for privacy. |
two_methods_with_bus_pctTwo methods, one of them bus (no train): share of employed residents | % | Two methods, one of them bus (no train) as a percent of all employed residents in the area. |
three_methods_countThree methods | persons | Number of employed residents who travelled to work by: Three methods (2021 snapshot). Small counts are lightly randomised for privacy. |
three_methods_pctThree methods: share of employed residents | % | Three methods as a percent of all employed residents in the area. |
worked_at_home_countWorked at home | persons | Number of employed residents who travelled to work by: Worked at home (2021 snapshot). Small counts are lightly randomised for privacy. |
worked_at_home_pctWorked at home: share of employed residents | % | Worked at home as a percent of all employed residents in the area. |
did_not_go_to_work_countDid not go to work that day | persons | Number of employed residents who travelled to work by: Did not go to work that day (2021 snapshot). Small counts are lightly randomised for privacy. |
did_not_go_to_work_pctDid not go to work that day: share of employed residents | % | Did not go to work that day as a percent of all employed residents in the area. |
method_not_stated_countMethod of travel not stated | persons | Number of employed residents who travelled to work by: Method of travel not stated (2021 snapshot). Small counts are lightly randomised for privacy. |
method_not_stated_pctMethod of travel not stated: share of employed residents | % | Method of travel not stated as a percent of all employed residents in the area. |
