系統狀態
呢頁係架構透明度,唔係即時監控。冇上游結果就空名單或錯誤,唔會顯示假 freshness 燈號。
而家上線
- 網站
- https://maps.gotooi.com — Next.js 靜態匯出,Cloudflare Worker
mapsio - Moca Platform API(P0/P1/P2/P3/P4/P5/P6/P7/P8)
- 同源
/api/v1。health、OpenAPI、places、nearby、parking 快照、walk/bicycle/motorcycle/drive/transit/ferry/mixed 路線、全球 OTP 聯邦 journeys、附近公共交通站同 Transitous 班表。P1 把 Valhalla maneuvers 原句放進steps,冇 maneuvers 就空陣列,唔會填假轉彎。P2 泊車/地點記錄帶 canonicallinks.map/links.page(maps.gotooi.com)。P3GET /places/:id跟返請求嘅 OSM type+id,附近唔同物件唔會頂替。P4 喺 Photon reverse 對唔上、冇結果、或 502 嗰陣查 OSM element 標籤補名;OSM 404/冇名仍然係未命名地點。P5GET /places?ids=可以一次讀最多 20 個 id,無效 id 略過,唔會填假地點。P6GET /parking?ids=可以一次讀最多 20 個台南泊車 id,未知/未接入城市嘅 id 略過,occupancyLive 永遠 false,唔會填假車位。P7GET /parking?west=&south=&east=&north=按地圖範圍讀台南泊車快照;台北/香港視野係空名單,唔會填假車位。P8GET /journeys按 bbox 轉發區域 OTP;跨區唔會串假轉乘。Web 只打呢個 API。 - 地圖底圖
- 主圖用 MapLibre GL JS + OpenFreeMap vector tiles(OpenMapTiles Liberty/Bright/Positron/Dark/Fiord)。 3D 用 MapLibre pitch/bearing 加 OSM Simple 3D Buildings(OpenMapTiles
buildingfill-extrusion,z14,全球 OFM):外牆讀colour(冇色#c8c2b8/夜間#28384b);高度/基座讀render_height/render_min_height;hide_3d外輪廓唔擠出。「3D 景觀」+日間/黃昏/夜間setLight(環境光,唔係窗戶發光;唔係 Mapbox Standard presets)。深色底圖優先 OFM Dark,可選 CARTO。樹木層可關(OSM 抽樣+綠地示意植被)。弱機關擠出→平面+山影。撳樓可睇瓦片欄位。室內 B1/B2 唔喺呢期。Leaflet 後備維持 2D。唔係衛星圖,亦唔係車道級 3D 導航。授權: © OpenStreetMap contributors。路線頁示範圖仍然可以用 Leaflet raster。唔會隱藏 OSM 署名。可選 deck.gl 泊車疊圖(「deck 泊車」,預設關)係 MapLibre overlaid 模式,唔係 interleaved/寫實 globe。P3 寫實實驗門檻見 /labs/3d-tiles/;未有合法 3D Tiles 前唔會喺主圖掛 CesiumJS 或 OpenGlobus。P4 擴城要先過權利/成本/更新/弱網退回;全球入口 OK,但 3D 覆蓋要誠實標示,唔好寫「全球寫實 3D」。 - 覆蓋範圍
- 地點搜尋/reverse/路線預設全世界(Photon 唔加 countrycode/bbox)。可選
region=TW或HK收窄。策展城市目錄GET /cities用 GeoNames id(CC BY),唔係完整 cities5000 匯入,亦唔係「最出名 5000 城」。泊車快照而家只有台南;城市模型仍然有tpe、tnn、hkg。 - 搜尋
- W3:SearchBar 只打
/api/v1/places,預設region=WORLD,用而家地圖中心做 bias。地圖撳一下用/api/v1/nearbyreverse。上游失敗或冇名就唔填假地點。 地圖主頁跟 OsmAPP/高德式主畫面:漢堡+頂部搜尋、圓形快捷(駕駛/實時公交/步行/景點/場景/美食/咖啡…)同底部主選單。附近未提供q時只做 reverse + 半徑內台南泊車快照,唔會用假關鍵字。S4 GoTooi 靈感 stub: /inspire/ 列真實附近地點/場景(美食只係可選篩選),唔加社交同假相(詳見倉庫docs/S4-GOTOI-DINING-MAP-UI.md)。 - 地點頁(W12/W13)
/place/?id=只打/api/v1/places/:id。靜態匯出,未換 OpenNext。W12 把成功結果寫入本機mocamap.placeById.v1(最多 50 個,只接受 maps.gotooi.com 連結);API 連唔到就用記住嘅副本。W13 打開地圖或地點頁會用 P5GET /places?ids=一次補最多 20 個記住嘅地點;失敗或空結果會留住本機快照。404 仍然係 404,唔會填假地點。版面有名稱、地址、開放資料、本機收藏同「去呢度」;未有營業時間就唔會填假時段。- 路線
- W4/P8:地圖主頁同
/routes/打/api/v1/routes;公共交通/混合改打/api/v1/journeys(全球 OTP 聯邦)。walk/bicycle/motorcycle/drive 用 Valhalla(伺服器)。公共交通優先同區 OTP 區域 graph;未上線或跨區時 fallback Transitous MOTIS。渡輪優先 MOTIS 渡輪船班,否則 OSM Valhalla。 有 maneuvers/legs 就列出;冇就空步驟,唔會填假轉彎。Transitous/OTP 回傳嘅 itineraries 會當成替代方案;preference=fastest|least_transfers只會重排真實上游方案(唔會發明路線)。路線卡會標 OTP 或 MOTIS · Transitous。票價顯示「票價未接入」(未有官方八達通 OD 引擎)。PWA 離線殼只快取介面同本機上次規劃,唔等於即時到站。地圖「開始導航」行步行/電單車/駕駛經典跟車(綠色轉彎橫幅+剩餘時間);定位/導航用 Three.js 低多邊形化身貼地(有 DEM 就 queryTerrainElevation;唔係營辦商掃描模型);3D 樓宇會擋住前方路線。GET /cities//cities/search//cities/:id/coverage提供 GeoNames 策展城市目錄同按營辦商嘅交通覆蓋狀態。公共交通晶片打GET /transit:Photon 車站、香港範圍內九巴/龍運/城巴/綠色小巴 ETA 同港鐵 Next Train,以及其他城市嘅 MOTIS stoptimes,約每 15 秒再取(Worker 對官方 ETA 快取約 10 秒)。realtime=true只喺營辦商預測或上游標 GTFS-RT 先有;班表同空 ETA 分別顯示「班表」同「尚無即時數據」,唔會把車站倒數當成全程時間。電車/輕鐵/渡輪係班表或 MOTIS/OTP 旅程覆蓋,冇專用 ETA。全球 OTP 係多區 graph 聯邦(唔係一部機載成個地球);我哋未擁有全世界線路。地點/泊車可以用「去呢度」喺地圖畫線。 - 地圖泊車層
- W5/W15/W16:地圖「泊車快照」打
/api/v1/parking?west=&south=&east=&north=(唔 hop 去台南,亦唔會同city/ids/lat一齊用)。客戶端再用鏡頭過濾;台北/香港視野係空名單,即使上游仍然係 P6 忽略 bbox、回成台南目錄,亦唔會釘喺台北。W16 把範圍內結果寫入本機mocamap.parkingBbox.v1;台北/香港成功空名單會蓋過先前台南疊圖,失敗就留住上次範圍快照。occupancyLive 永遠 false。目錄頁仍然city=tnn。W11 把成功、範圍內結果寫入本機mocamap.parkingById.v1。 - 泊車快照頁(W6/W9/W10/W11/W14)
/parking/?id=只打/api/v1/parking/:id。靜態匯出,未換 OpenNext。 空位仍然係快照。W9 把睇過嘅台南快照寫入本機mocamap.parkingById.v1;API 連唔到就用記住嘅副本。W10 一併記住 P2links.map/links.page(只接受 maps.gotooi.com),地圖同泊車頁用相對路徑,唔會跳去外站。W11 目錄/地圖層成功結果亦寫入同一個本機庫,唔會填假車位。W14 打開地圖或泊車頁會用 P6GET /parking?ids=一次補最多 20 個記住嘅泊車快照;失敗或空結果會留住本機快照,occupancyLive 永遠 false。- 地圖泊車深連結(W7/W9/W10/W11/W14)
/?parking=moca_parking_…打開泊車快照層同該車場卡片,並飛去該座標;圖層跟新鏡頭範圍,唔會把成個台南目錄疊上台北。第一次成功之後,離線可以再用本機快照。唔會填假車位。- 手機搜尋(A1/A3/A5/A6/A7/A10/A11/A12/A13/M7/M8)
- 搜尋盒打
/api/v1/places,可選台灣/香港(冇 GPS 就用地區中心 bias;定位只喺選定地區內先送)。A7 把呢個地區寫入本機mocamap.userSettings,下次開啟會跟返,唔上雲。附近油站/機車維修/機車格用同一個 origin。香港 Photon 標成 CN,API 用 bbox 過濾,唔會把內地結果當成香港。地圖撳一下同天氣鄉鎮 reverse 打/api/v1/nearby。App 唔再帶 client Photon/Valhalla/OSRM fetcher。A10 可以分享 P2/place/?id=網頁連結(只接受 maps.gotooi.com);冇 Moca id 嘅地圖撳一下唔會分享,亦唔會填假地點。A11 接受mocamap://place/moca_place_…同同一個/place/?id=深連結,打/api/v1/places/:id開卡;回應 id 必須跟請求,唔會頂替附近唔同 OSM 物件。M7 把成功結果寫入本機mocamap.placeById.v1(只接受 maps.gotooi.com 連結),離線深連結可以再打開;未讀過嘅 id 唔會填假地點。A12 把搜尋、附近油站/維修、同有名嘅地圖 reverse 成功結果一併寫入同一個本機庫;空結果同冇 Moca id 嘅撳一下唔會記住。A13 搜尋同附近油站/維修成功之後再用GET /places?ids=按 ID 補卡(P3/P4);id 對唔上或者 batch 失敗就留住搜尋/附近名單,唔會填假地點。M8 開機用GET /places?ids=一次補最多 20 個記住嘅地點(P5);失敗或空結果會留住本機快照,唔會填假地點。 - 手機路線(A2)
- 機車導航打
/api/v1/routes?mode=motorcycle。唔再直接打 Valhalla/OSRM。有上游 maneuvers 就顯示逐轉指示。 - 手機泊車(M0–M6/M9/M10/A8/A9/A14/A15)
- 停泊點用 expo-secure-store。A15 地圖泊車疊圖打
/api/v1/parking?west=&south=&east=&north=(跟 A6 搜尋 origin:地區內 GPS,否則台南安平/香港中環),客戶端再過濾;台北/香港 origin 係空疊圖,即使上游仍然係 P6 忽略 bbox、回成台南目錄,亦唔會留喺疊圖。M10 把範圍內結果寫入本機mocamap.parkingBbox.v1;台北/香港成功空名單會蓋過先前台南疊圖,失敗就留住上次範圍快照。occupancyLive 永遠 false。M0 台南目錄city=tnn仍然背景快取,唔會整份倒上台北疊圖。機車格打/api/v1/parking?lat=&lng=快照;撳一下會用/api/v1/parking/:id補卡。A8 接受mocamap://parking/moca_parking_…同 W7 嘅?parking=深連結。A9 可以分享同一個網頁連結。M4 把按 ID 睇過嘅台南快照另存mocamap.parkingById.v1,離線深連結可以再打開。M5 一併記住 P2links.map/links.page(只接受 maps.gotooi.com)。M6 把附近機車格成功結果一併寫入同一個本機庫,離線附近/深連結可以用。M9 開機用GET /parking?ids=一次補最多 20 個記住嘅泊車快照(P6);失敗或空結果會留住本機快照,occupancyLive 永遠 false,唔會填假車位。A14 附近機車格成功之後再用GET /parking?ids=按 ID 補卡;id 對唔上或者 batch 失敗就留住附近名單,occupancyLive 永遠 false。台北/香港目錄未接入,空名單唔會填假車位。寫入 API/SQLCipher 未做。 - 定位
- 要用家先撳「定位」先會向瀏覽器要權限。成功後只用於目前頁面 session 置中地圖;拒絕權限唔會 crash,可以繼續睇地圖。唔會默默寫定位軌跡,亦唔會把座標送到 analytics。
- 本機收藏
- 收藏只寫入呢部瀏覽器嘅 localStorage,未同步帳號。唔好當已經上雲。
尚未上線
- 獨立 SSR 地點 permalink(OpenNext 未換 mapsio Worker)
- 帳戶、回報、寫入 API
建造順序係 Web → Apps → Platform API → Mobile Offline Parking。每筆資料都帶 source、licence、freshness/confidence。