關於 MocaMap
MocaMap 係一個開放、本地優先、多交通方式嘅 Mobility Intelligence Platform。佢唔係只做電單車導航,亦唔係 Google Maps clone。
開放出行
地圖、搜尋同導航預設全世界。泊車快照而家仍然只有台南。頂欄同主頁「駕駛/步行」會打開路線規劃;步行、電單車、單車同駕駛都可以「開始導航」,經典跟車畫面用綠色轉彎提示同底部剩餘時間。傾斜視角時前方 3D 樓宇會擋住路線,唔會把線畫穿樓。地點搜尋經 Moca API 打 Photon/OSM 索引,唔會用公共 Nominatim 做 autocomplete。城市目錄用 GeoNames id(CC BY)策展;`cities5000.zip` 係人口大於 5000 約五萬筆,**唔等於**全球最出名 5000 城。交通覆蓋按營辦商/feed 分開標示(未有資料/只有班次表/有即時到站/資料過期/暫時故障),唔會用 `city_has_transit=true`。香港「實時公交」顯示附近站下一班:九巴/龍運/城巴/綠色小巴官方 ETA 同港鐵 Next Train;冇 ETA 就寫「尚無即時數據」,班表備註唔會標成即時。呢個係車站到站,唔係 A→B 總車程。我哋未擁有全世界線路。全球 OTP 係多區 graph 聯邦:`GET /journeys` 按座標轉發各地區 OTP,唔會硬上單一全球 graph;區域 graph 未上線時可 fallback Transitous。
- 步行
- 單車
- 電單車
- 駕駛
- 公共交通
- 渡輪
- 混合行程
3D 地圖
主圖用 OpenFreeMap Liberty/Bright/Positron/Dark/Fiord(OpenMapTiles schema)。3D 係 MapLibre 傾斜同旋轉,加上 OSM Simple 3D Buildings(OpenMapTiles building fill-extrusion,瓦片最高 z14,再 overzoom;全球 OFM 覆蓋,唔限單一城市)。OSM 外輪廓係 building=*,高度/顏色唔同嘅體積用 building:part。 外牆讀瓦片 colour(OSM building:colour);冇色就中性 #c8c2b8(夜間 #28384b),唔會從衛星猜色。高度讀 render_height,基座讀 render_min_height(min_height 係離地開始嘅高度,唔係「呢部分再加高咁多」)。標咗 hide_3d 嘅外框唔擠出,等 parts 分開畫。OpenMapTiles 冇 roof:colour,唔會填假屋頂。「3D」掣係3D 景觀:傾斜+輕微 bearing;光源用 MapLibre setLight 日間/黃昏/夜間(整體環境光,唔係真實太陽/窗戶發光)+可選 sky;深色底圖優先 OpenFreeMap Dark,可選 CARTO Dark Matter(條款/非無限免費)。可選樹木層:真實 OSM natural=tree 抽樣優先(全港覆蓋稀疏),綠地(公園/林地/草地)另加示意植被(非逐棵核實);唔係 Mapbox Standard 專有 landmarks/trees/lighting presets。詳見 docs/MAPLIBRE-LIGHTING-TREES.md。撳一棟樓會顯示瓦片欄位,方便核對 part/顏色有冇保留。室內 indoor=*/level=-1/B1 泊車地圖係之後一期,而家唔會畫假樓層。WebGL 先有 3D;Leaflet 後備同路線頁示範圖仍然係 2D,唔會刪。規劃/預覽路線畫喺 3D 樓宇之上、地名標籤之下,避免被擠出體挡住。呢個唔係衛星影像,亦唔係高德車道級 3D 導航。可選嘅 deck.gl 泊車疊圖(「deck 泊車」)只係 MapLibre 上面嘅 overlaid 點層,預設關;唔係 interleaved,亦唔係寫實 3D Tiles。山影(hillshade)預設開,插喺道路之下、用柔和 exaggeration(高 zoom 淡出),避免蓋住底圖顏色或喺水面留黑色殘影;「2D/地形」可選開 MapLibre setTerrain(exaggeration=1),唔係寫實岩石。弱機會關閉樓宇擠出,維持平面+山影。高程授權見 Mapzen / AWS Terrain Tiles。差距說明見倉庫 docs/MAPLIBRE-3D-CITIES.md。寫實實驗門檻見 Labs · 3D Tiles;未有合法 tileset 前唔會掛 Cesium/OpenGlobus 喺主圖。
資料原則
- 冇上游結果就空名單或錯誤,唔會做假 API、假搜尋、假班次或假即時泊車。交通狀態按營辦商/feed 分開標示,唔會把「城市有一個 feed」報成「全市即時」。
- GoTooi 地點/場景/靈感表面(見 /inspire/ 同倉庫
docs/S4-GOTOI-DINING-MAP-UI.md)絕對原則:搵地方同計劃去程,唔加朋友、動態牆、地圖頭像或假地點。Mockup 個樣可以似美食風格,但內容唔限定美食(美食/咖啡只係篩選之一)。主圖仍然保留公交/泊車/機車。 - 地圖底圖用 OpenFreeMap vector tiles(MapLibre GL JS、OpenMapTiles 風格)顯示 OSM 資料,並顯示 © OpenStreetMap contributors。唔用瀏覽器直打公共 raster tile CDN 做主圖。
- Web 唔會直接打 Photon、Valhalla、Nominatim 等第三方 search / routing API;呢啲只可以由 Moca Platform API 伺服器呼叫。公共 Nominatim 禁止用作 client-side autocomplete,搜尋框只打自家
/places。Photon 先於 Pelias;全球 Photon planet 自架係之後容量計劃。 - 城市目錄用 GeoNames(CC BY)策展;搵 GTFS 可先用 Mobility Database 網站,但唔會把必須註冊嘅 Mobility Database API 做成硬依賴。OpenTripPlanner 只會按城/區部署,唔做全球一部機。
- 本地位優先:瀏覽器先能用地圖,平台 API、Apps、離線泊車會按層推進。
而家有咩
網站而家有全世界 OSM 地圖(MapLibre + OpenFreeMap/OpenMapTiles,3D 樓宇 z14+)、W3 搜尋、W4 路線(P1 上游 maneuvers)、W5 台南泊車地圖快照、W6 台南泊車快照頁、W7 地圖泊車深連結、W8 可選 ?region=TW|HK 收窄搜尋(唔再把台灣/香港當成產品身份)、W9 本機記住已睇過嘅台南泊車快照(API 連唔到仍可打開)、W10 一併記住 P2 maps.gotooi.com 連結(離線地圖/泊車頁用嗰條)、W11 目錄/地圖層成功結果亦寫入同一個本機庫、W12 地點頁成功結果寫入本機 mocamap.placeById.v1(API 連唔到仍可打開)、W13 打開地圖或地點頁會用 P5 GET /places?ids= 一次補最多 20 個記住嘅地點(失敗就留住本機快照)、W14 打開地圖或泊車頁會用 P6 GET /parking?ids= 一次補最多 20 個記住嘅台南泊車快照(失敗就留住本機快照)、W15 地圖泊車層跟鏡頭打 GET /parking?west=&south=&east=&north= 再用範圍過濾(範圍外唔會釘上台南車位,亦唔會 hop 去台南;目錄頁仍然 city=tnn)、W16 把範圍內泊車層寫入本機 mocamap.parkingBbox.v1(失敗就留住上次範圍快照;成功空名單會蓋過台南疊圖)、台南泊車目錄。地圖主頁跟 OsmAPP:全畫面地圖、漢堡+頂部搜尋、地點資料面板;漢堡入面有附近/泊車/路線。地點頁有開放資料、本機收藏同「去呢度」。路線頁按 GraphHopper 排起終點,只顯示上游最快一條。同手機 A1–A12 Moca 搜尋(台灣/香港,地區會留喺本機)/附近油站維修機車格/機車路線/天氣鄉鎮/泊車同地點深連結同分享網頁連結、M0–M6 台南泊車快照疊圖、按 ID 補卡,本機記住已睇過同附近查過嘅泊車快照同 P2 maps.gotooi.com 連結(離線深連結/分享)、M7 本機記住已用深連結打開過嘅地點快照,A12 把搜尋/附近/地圖 reverse 成功結果一併寫入同一個本機庫(離線深連結可用)。A13 搜尋同附近油站/維修會再用 P5 GET /places?ids= 按 ID 補名,id 對唔上就唔頂替。A14 附近機車格會再用 P6 GET /parking?ids= 按 ID 補卡,id 對唔上就唔頂替。M8 開機用 P5 GET /places?ids= 一次補最多 20 個記住嘅地點,失敗就留住本機快照。M9 開機用 P6 GET /parking?ids= 一次補最多 20 個記住嘅台南泊車快照,失敗就留住本機快照。A15 地圖泊車疊圖跟搜尋 origin 打 GET /parking?west=&south=&east=&north= 再用範圍過濾(台北/香港 origin 唔會留住台南車位)。M10 把範圍內泊車疊圖寫入本機 mocamap.parkingBbox.v1(失敗就留住上次範圍快照;台北/香港成功空名單會蓋過台南疊圖)。P2 泊車/地點 API 帶 maps.gotooi.com 連結;P3 按 ID 讀地點會跟返同一個 OSM 物件;P4 喺 Photon reverse 對唔上或掛咗嗰陣用 OSM element 標籤補名;P5 可以用 GET /places?ids= 一次補最多 20 個記住嘅地點,唔會頂替附近唔同物件。P6 可以用 GET /parking?ids= 一次補最多 20 個台南泊車快照,未知 id 略過,唔會填假車位。P7 可以用 GET /parking?west=&south=&east=&north= 按地圖範圍讀台南泊車快照,範圍內冇就空名單,唔會填假車位。地圖主頁有推薦地點同路線畫線;公共交通/渡輪/混合行程用 Transitous MOTIS,冇覆蓋就唔會填假班次。泊車仍然係台南快照(occupancyLive=false)。MocaMap 屬於 Gotooi 生態;Gotooi.com 會喺 first-party API 穩定之後先顯示地點同可達性,唔會提前假裝已經接好。