🔌 REST & VECTOR TILES API REFERENCE
REST API、PostGIS Vector Tiles 與開放數據匯出規範
所有公開讀取端點均支援跨域查詢,寫入端點及高頻率調用請於 Header 附上 `Authorization: Bearer kfm_live_...`。
1. 查詢附近社區設施及鏡頭:`GET /api/facilities`
支援空間半徑 (`lat`, `lng`, `radius`)、類別 (`category`)、標籤 (`tag`)、地區 (`district`) 及只限公眾開放 (`publicOnly=true`)。
GET /api/facilities?lat=22.2849&lng=114.1545&radius=1000&category=SMART_BIN&lang=zh-HK
2. 實時分區天氣及空氣質素:`GET /api/weather`
自動配對最近香港天文台自動氣象站、18 區過去一小時雨量及環保署 AQHI 監測站(10 分鐘快取)。
GET /api/weather?lat=22.3019&lng=114.1742&lang=zh-HK
3. PostGIS 向量瓦片:GET /api/tiles/{z}/{x}/{y}.pbf
透過 PostGIS `ST_AsMVT` 直接由 PostgreSQL 輸出二進位向量瓦片,適合在行動網絡下高速渲染過萬個地標。
4. 開放數據回饋匯出:`GET /api/export?format=geojson|csv`
一鍵下載經清洗及街坊核實後的完整數據集(支援 `category` 或 `dataset` 參數過濾)。
GET /api/export?format=geojson&dataset=epd-wasteless GET /api/export?format=csv&category=TOILET