API: Metered Parking
Real-time and pattern-based endpoints surfaced from our processed metered parking datasets. All endpoints return JSON. Timestamps are ISO-8601.
/api/metered/carparks
List metered carparks with coordinates and total spaces
Query Params
- district — Filter by district (exact match)
- limit — Max rows (default 50, max 200)
- offset — Pagination offset (default 0)
Example
/api/metered/carparks?district=...
/api/metered/recommendations
Rank metered carparks most likely to have availability now (hour-of-day pattern based)
Query Params
- district — Optional district filter
- limit — Max rows (default 20, max 100)
Example
/api/metered/recommendations?district=...
/api/metered/trends
5-minute vacancy-rate trend for metered parking (last 24h)
Query Params
- district — Optional district filter
- vehicle_type — Optional vehicle type filter
Example
/api/metered/trends?district=...
/api/metered/districts/busiest
District-level volatility (stddev vacancy rate, last 24h)
Example
/api/metered/districts/busiest
Data Notes
- Freshness: Backed by materialized views refreshed by the parking cron (`app/api/cron/refresh-parking/route.ts`). Recommendations use current HK hour patterns until live per-carpark snapshots are exposed.
- Coverage: Metered parking only; regular carparks are available through the existing `/parking` visualizations and can be added here if needed.
- Limits: Results are capped to avoid Supabase row limits; paginate where supported.