Parking Vacancy (Transport Department)

Source

Transport Department (TD)

Vacancy API: https://resource.data.one.gov.hk/td/carpark/vacancy_all.json
Basic Info API: https://resource.data.one.gov.hk/td/carpark/basic_info_all.json
CKAN Dataset: https://data.gov.hk/en-data/dataset/hk-td-sm_4-carpark-vacancy-real-time

Format

JSON Real-time (minutes-level updates). No API key.

~650

Carparks Covered

Real-time

Update Frequency

Free

No Auth

Schema / Fields

Basic Info (basic_info_all.json)

Field	Type	Example	Description
`park_Id`	string	`"1001"`	Unique carpark ID
`name`	string	`"Sheung Wan Municipal Services Building"`	Carpark name
`district`	string	`"Central & Western"`	Administrative district
`address`	string	`"345 Queen's Road Central"`	Address
`latitude`	float	`22.286141`	WGS84 latitude
`longitude`	float	`114.149832`	WGS84 longitude
`privateCar`	boolean	`true`	Accepts private cars
`hourlyFee`	string	`"HKD 30/hr"`	Hourly rate

Vacancy (vacancy_all.json)

Field	Type	Example	Description
`park_Id`	string	`"1001"`	Carpark ID (join key)
`privateCar`	integer	`42`	Current private car vacancies
`LGV`	integer	`0`	Light goods vehicle vacancies
`HGV`	integer	`0`	Heavy goods vehicle vacancies
`coach`	integer	`2`	Coach vacancies
`motorCycle`	integer	`8`	Motorcycle vacancies
`lastUpdateTime`	string	`"2024-01-15T08:28:00"`	Data timestamp

Example API Call

# Get carpark locations for Central & Western
curl "https://resource.data.one.gov.hk/td/carpark/basic_info_all.json" | \
  jq '[.carpark[] | select(.district == "Central and Western")]'

# Get current vacancy
curl "https://resource.data.one.gov.hk/td/carpark/vacancy_all.json" | \
  jq '.carpark[] | select(.park_Id == "1001") | {id: .park_Id, spaces: .privateCar}'

Example Response

{
  "carpark": [
    {
      "park_Id": "1001",
      "name": "Sheung Wan Municipal Services Building",
      "district": "Central and Western",
      "latitude": 22.286141,
      "longitude": 114.149832,
      "privateCar": 42,
      "lastUpdateTime": "2024-01-15T08:28:00"
    },
    {
      "park_Id": "1002",
      "name": "Wing Lok Street Carpark",
      "district": "Central and Western",
      "latitude": 22.286890,
      "longitude": 114.151240,
      "privateCar": 18,
      "lastUpdateTime": "2024-01-15T08:28:00"
    }
  ]
}

Used By

Model	How
Catchment Area	Carpark locations and capacity define car-accessible zone boundaries
Site Rating	Parking availability sub-score: nearby vacancies = easier car access = larger effective catchment

Notes / Gotchas

Sheung Wan has limited parking; most customers arrive on foot or by MTR — parking is a weak signal here
The district field uses “Central and Western” (not ”&”) — filter accordingly
Vacancy data is pull-based; build a time-series by polling at intervals for temporal analysis
Join basic_info and vacancy on park_Id — they are separate API calls