Transport by mesh block — stops, stations, commuting within 1 km (by gnaf_id)
/v1/properties/{gnaf_id}/mesh-blocks/transport20¢ per callHow do you get around from here? For every mesh block around the property: distance to the nearest bus stop, train station and tram stop, bus stops within 320 m, and how many workers commute by public transport.
One entry per mesh block within 1,000 m of the property under mesh_blocks, nearest first, each with its mb_code, distance_m, population and dwellings. Blocks across suburb lines are included. Values only — the polygons come from /properties/{gnaf_id}/context/mesh-blocks.
Every field carries provenance — measured (at this block), measured_wider_area (measured for the SA1 or postcode and repeated on every block in it), estimate (our model) or not_recorded (not labelled yet) — plus how, one sentence on how the number was arrived at (empty when not_recorded).
Authorization
Request
The only values you send. Fields under Responses below are what comes back — you never pass those.
Path parameters
gnaf_idstringrequiredQuery parameters
Responses
Successful Response
gnaf_idstringalways returnedThe property, as given.
suburbstringmay be nullThe property's suburb (SAL). Blocks across suburb lines are included.
statestringmay be nullState / Territory abbreviation of the property.
radius_mintegeralways returnedRadius around the property, in metres (1,000).
topicstringalways returnedWhich topic this answers.
questionstringalways returnedThe question this topic answers.
betabooleanalways returned`true` when the figures behind this topic have not been validated against an independent source yet.
beta_noticestringmay be nullWhat is unvalidated, on beta topics only.
block_countintegeralways returnedHow many mesh blocks are in `mesh_blocks`.
mesh_blocksarray of PropertyMbTopicBlockalways returnedOne entry per mesh block within `radius_m`, nearest first.
notestringalways returnedHow to read `provenance`.
About this data
What this is
Public transport around one address, block by block: for each mesh block within 1 km, the distance to the nearest bus stop, train station and tram stop, the number of bus stops within 320 m, and the share of workers who commute by public transport.
What people use it for
- Buyers and renters: check how far a home really is from the station.
- Agents: back up "walk to transport" claims with distances.
- Developers and planners: assess transit access around a site.
Coverage
Mesh blocks nationwide (about 368,000). The 1 km radius crosses suburb lines. A field is null where we hold nothing for that block.
Tips
The commuting share is our estimate; distances are measured. For named stops and stations use /v1/properties/{gnaf_id}/transport/nearby. Check provenance before quoting a field. Whole suburb: /v1/suburbs/{suburb_name}/mesh-blocks/transport. Polygons: /v1/properties/{gnaf_id}/context/mesh-blocks, joined on mb_code.
/v1/properties/{gnaf_id}/mesh-blocks/transportcurl --request GET \
--url 'https://api.microburbs.com.au/v1/properties/GANSW704074813/mesh-blocks/transport' \
--header 'Authorization: Bearer test'{
"data": {
"gnaf_id": "GANSW704074813",
"suburb": "Belmont North",
"state": "NSW",
"radius_m": 1000,
"topic": "transport",
"question": "How do you get around from here?",
"beta": false,
"block_count": 102,
"mesh_blocks": [
{
"mb_code": "10434270000",
"population": 124,
"dwellings": 46,
"fields": {
"bus_stop_nearest_m": {
"value": 533.64,
"unit": "metres",
"measured_at": "mesh_block",
"label": "Nearest bus stop",
"provenance": "measured",
"how": "measured at this level"
},
"train_station_nearest_m": {
"value": 8187.3,
"unit": "metres",
"measured_at": "mesh_block",
"label": "Nearest train station",
"provenance": "measured",
"how": "measured at this level"
},
"tram_stop_nearest_m": {
"value": 127623.22,
"unit": "metres",
"measured_at": "mesh_block",
"label": "Nearest tram stop",
"provenance": "measured",
"how": "measured at this level"
},
"bus_stops_within_320m": {
"value": 0,
"unit": "count",
"measured_at": "mesh_block",
"label": "Bus stops within 320 m",
"provenance": "measured",
"how": "measured at this level"
},
"public_transport_to_work_pct": {
"value": 1.55,
"unit": "% of workers",
"label": "Workers who commute by public transport",
"provenance": "estimate",
"how": "our estimate for this Microburb"
},
"listed_close_to_public_transport_pct": {
"value": 0,
"unit": "% of listings",
"measured_at": "mesh_block",
"label": "Listings that describe themselves as close to public transport",
"provenance": "measured",
"how": "measured at this level"
}
},
"distance_m": 0
},
{
"mb_code": "10434330000",
"population": 89,
"dwellings": 32,
"fields": {
"bus_stop_nearest_m": {
"value": 630.42,
"unit": "metres",
"measured_at": "mesh_block",
"label": "Nearest bus stop",
"provenance": "measured",
"how": "measured at this level"
},
"train_station_nearest_m": {
"value": 8244.62,
"unit": "metres",
"measured_at": "mesh_block",
"label": "Nearest train station",
"provenance": "measured",
"how": "measured at this level"
},
"tram_stop_nearest_m": {
"value": 127523.11,
"unit": "metres",
"measured_at": "mesh_block",
"label": "Nearest tram stop",
"provenance": "measured",
"how": "measured at this level"
},
"bus_stops_within_320m": {
"value": 0,
"unit": "count",
"measured_at": "mesh_block",
"label": "Bus stops within 320 m",
"provenance": "measured",
"how": "measured at this level"
},
"public_transport_to_work_pct": {
"value": 1.55,
"unit": "% of workers",
"label": "Workers who commute by public transport",
"provenance": "estimate",
"how": "our estimate for this Microburb"
},
"listed_close_to_public_transport_pct": {
"value": 20,
"unit": "% of listings",
"measured_at": "mesh_block",
"label": "Listings that describe themselves as close to public transport",
"provenance": "measured",
"how": "measured at this level"
}
},
"distance_m": 15
},
{
"mb_code": "10434440000",
"population": 99,
"dwellings": 34,
"fields": {
"bus_stop_nearest_m": {
"value": 359.41,
"unit": "metres",
"measured_at": "mesh_block",
"label": "Nearest bus stop",
"provenance": "measured",
"how": "measured at this level"
},
"train_station_nearest_m": {
"value": 8160.54,
"unit": "metres",
"measured_at": "mesh_block",
"label": "Nearest train station",
"provenance": "measured",
"how": "measured at this level"
},
"tram_stop_nearest_m": {
"value": 127793.88,
"unit": "metres",
"measured_at": "mesh_block",
"label": "Nearest tram stop",
"provenance": "measured",
"how": "measured at this level"
},
"bus_stops_within_320m": {
"value": 0,
"unit": "count",
"measured_at": "mesh_block",
"label": "Bus stops within 320 m",
"provenance": "measured",
"how": "measured at this level"
},
"public_transport_to_work_pct": {
"value": 1.77,
"unit": "% of workers",
"label": "Workers who commute by public transport",
"provenance": "estimate",
"how": "our estimate for this Microburb"
},
"listed_close_to_public_transport_pct": {
"value": 50,
"unit": "% of listings",
"measured_at": "mesh_block",
"label": "Listings that describe themselves as close to public transport",
"provenance": "measured",
"how": "measured at this level"
}
},
"distance_m": 56
}
],
"note": "Each field says how its number was arrived at. An estimate is not a measurement, and a figure measured for a wider area is not a measurement of the block."
}
}