🔌 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