HK Parking Meter Finder
Use the bundled script to search the official Transport Department metered parking space inventory together with the live occupancy feed.
Quick start
Run the bundled script from the skill directory:
CODEBLOCK0
Or use an absolute path rooted at the installed skill folder if needed.
Examples:
CODEBLOCK1
Workflow
- 1. Extract the place keyword first.
- Accept street names, districts, sub-districts, estates, landmarks, station names, or short area phrases.
- Examples:
富善街 大埔,
火炭站,
廣福坊,
Causeway Bay,
中環 咪錶.
- 2. Run the script with the user's place words.
- Read the top returned clusters.
- Each cluster groups nearby parking-meter spaces by district / sub-district / street / street-section / vehicle type.
- 4. Prefer clusters with vacant spaces when the user asks for
空位, vacancy, available, or 有冇位.
- Use
--vacant-only if that helps cut noise.
- 5. Include the Google Maps link when it helps the user navigate quickly.
- If the exact street is absent from the official metered-space feed, say so and report the nearest likely street clusters instead of pretending there is an exact match.
- Summarize clearly with vacant vs occupied counts and mention the best-matching street names.
Reporting guidance
- - Keep the answer practical: which nearby street clusters have vacant spaces right now.
- Include the Google Maps link for each recommended cluster when useful.
- If there are several plausible matches, list the top few instead of guessing.
- If the user gave a broad district only, mention that the result is area-level and may need a more specific street.
- Use
--json only when structured follow-up processing is useful.
Data sources
The script joins these official datasets:
- -
parkingspaces.csv — static metered-space inventory from Transport Department / DATA.GOV.HK. - INLINECODE12 — live occupancy status for sensor-equipped / new meter spaces from Transport Department / DATA.GOV.HK.
Scope and limitations
- - This skill covers roadside metered parking spaces only, not car parks, private parking, or non-metered kerbside spaces.
- Live occupancy is only as complete as the official occupancy feed. Some metered spaces may exist in the inventory but not have live occupancy records.
- Matching is keyword-based and fuzzy; it is good for nearby / likely street matches, not turn-by-turn navigation.
- The script reports approximate cluster centres from official coordinates, but it does not geocode arbitrary addresses.
- Queries like
附近 without any place anchor are too vague; provide a street, district, station, or landmark.
scripts/
- -
scripts/hk_metered_parking.py — search official Hong Kong metered parking spaces and live occupancy by street / area keyword.
香港咪錶泊車位搜尋器
使用附帶的腳本，結合官方運輸署的咪錶泊車位庫存資料及實時佔用情況進行搜尋。
快速開始
從技能目錄執行附帶的腳本：
bash
python3 scripts/hkmeteredparking.py <街道或區域關鍵字>
如有需要，亦可使用已安裝技能資料夾的絕對路徑。
範例：
bash
python3 scripts/hkmeteredparking.py 富善街 大埔
python3 scripts/hkmeteredparking.py 廣福坊
python3 scripts/hkmeteredparking.py 火炭站 --vacant-only
python3 scripts/hkmeteredparking.py 銅鑼灣 怡和街 --json
工作流程
- 1. 先提取地點關鍵字。
- 可接受街道名稱、地區、分區、屋苑、地標、車站名稱或簡短區域詞組。
- 範例：富善街 大埔、火炭站、廣福坊、Causeway Bay、中環 咪錶。
- 2. 使用使用者的地點詞彙執行腳本。
- 讀取回傳的頂部結果群組。
- 每個群組按地區/分區/街道/路段/車種，將附近的咪錶泊車位分組。
- 4. 當使用者查詢空位、vacancy、available或有冇位時，優先顯示有空位的群組。
- 如有需要，可使用--vacant-only減少干擾。
- 5. 在能幫助使用者快速導航時，加入Google地圖連結。
- 如果官方咪錶泊車位資料庫中沒有該街道的資料，應如實告知，並報告最接近的可能街道群組，而非假裝有完全匹配的結果。
- 清楚總結空置與佔用的數量，並提及最匹配的街道名稱。
報告指引
- - 保持答案實用：告知目前哪些附近街道群組有空位。
- 在適用的情況下，為每個推薦群組加入Google地圖連結。
- 如果有多個可能匹配的結果，列出最相關的幾個，而非猜測。
- 如果使用者只提供廣泛的地區名稱，應說明結果為區域層級，可能需要更具體的街道名稱。
- 僅在需要結構化後續處理時使用--json。
資料來源
腳本整合了以下官方資料集：
- - parkingspaces.csv — 來自運輸署/DATA.GOV.HK的靜態咪錶泊車位庫存資料。
- occupancystatus.csv — 來自運輸署/DATA.GOV.HK的感應器/新型咪錶泊車位實時佔用狀態。
範圍與限制
- - 此技能僅涵蓋路邊咪錶泊車位，不包括停車場、私人停車位或非咪錶路邊泊車位。
- 實時佔用資料的完整性取決於官方資料來源。部分咪錶泊車位可能存在於庫存中，但沒有實時佔用記錄。
- 匹配方式為基於關鍵字的模糊匹配；適用於附近/可能匹配的街道，而非逐個轉彎的導航。
- 腳本根據官方座標報告近似群組中心，但不會對任意地址進行地理編碼。
- 如附近等沒有具體地點的查詢過於模糊；請提供街道、地區、車站或地標。
scripts/
- - scripts/hkmeteredparking.py — 按街道/區域關鍵字搜尋香港官方咪錶泊車位及實時佔用情況。
