HEALS 基地分析工作站 · HEALS Site Analysis Studio
以真實台灣政府開放圖資為基礎的基地（site）分析網頁工具:在地圖上放標記或畫出基地範圍,即可一次取得人口結構、開放空間/綠地可及性、熱環境與健康研判、法規對照,並由 Claude AI 產出可讀的綜合報告、匯出 PDF。
⚠️ 本工具分析僅供規劃參考,不構成正式法定文件或專業意見。詳見「方法與限制」。
線上版本
功能相同,差別僅在 AI 解讀需要後端(金鑰)。
功能總覽
底圖與疊圖
- 底圖(NLSC WMTS):臺灣通用電子地圖 (EMAP)、正射影像+路名套疊 (PHOTO_MIX)、正射影像 (PHOTO2)
- 疊圖圖層(官方圖資,可多選 + 共用透明度)
- 國土利用調查(綠地/土地利用)— NLSC,綠地實況視覺參考
- 各級學校範圍(學區)— NLSC
- 段籍圖(地籍)— NLSC
- 土壤液化潛勢 — 經濟部地質調查及礦業管理中心 WMS
- 活動斷層分布線(2021) — 地質調查所 WMS
- 活動斷層地質敏感區(帶狀) — 地質調查所 WMS
工具
- 地名搜尋(OpenStreetMap Nominatim)
- 點選放標記 / 繪製基地範圍(多邊形)/ 清除
- 基地面積量測(公頃,turf.js)
人口與指標
點一個點查村里、畫一塊面查鄉鎮市區,顯示真實戶政指標:
人口數、戶數、人口密度、性別比、老化指數、扶養比、扶幼比、扶老比、高齡比例(65+)、幼年比例(0-14)等。
開放空間 · 綠地(OpenStreetMap 即時查詢)
以焦點周邊 500m 服務圈分析,並分兩類:
- 公園(≥0.1ha):最近公園距離/面積、300m & 500m 內公園數、公園面積
- 零星綠地(草地·小塊):處數、面積
- 整體:綠覆率(全綠地)、3-30-300 可及性
- 法規對照:都市計畫法 §45(公園綠地廣場兒童遊樂場 ≥ 計畫面積 10%)、通盤檢討辦法(兒童遊樂場 ≥0.1ha、閭鄰公園 ≥0.5ha、社區公園 ≥4ha)、3-30-300 準則
NDVI 植群分析(Sentinel-2 衛星影像)
按「分析 NDVI 植群」(或「分析周邊綠地」時自動一併執行),以 Copernicus Sentinel-2 L2A(10 m)計算 NDVI =(近紅外 B08 − 紅光 B04)÷(B08 + B04);其高植生比例並作為熱環境與療癒綠地指數的樹冠代理(見下節):
- 選景:向 Element 84 Earth Search(STAC)查近一年場景雲量 < 60% 的影像,依日期由新到舊讀基地處的 SCL 場景分類,遮除雲 / 雲影 / 缺值,採第一景「基地晴空 ≥ 90%」者(都不足時取最佳且 ≥ 50%)
- 讀取:瀏覽器以 HTTP Range 只讀基地所在的 COG 圖塊(AWS Open Data
sentinel-cogs,免金鑰、支援 CORS),每次約 3–8 MB
- 範圍:點模式 = 標記周邊 500 m(同綠地分析);面模式 = 基地範圍內
- 指標:平均 / 中位數 NDVI、植被覆蓋率(NDVI ≥ 0.2)、高植生比例(NDVI ≥ 0.6,樹冠粗略代理,對照 3-30-300 的 30%)、五級分級面積比例、晴空像元比例
- 地圖:10 m 像元分布圖(重投影至 Web Mercator),點圖可查單一像元值;報告匯出附分布圖
- 反射率換算:
sentinel-cogs 的像元值已扣除 ESA 的 +1000 偏移(STAC earthsearch:boa_offset_applied: true),不可再套 STAC raster:bands 的 offset −0.1;另以 SCL 植生像元紅光中位數做經驗檢核
在地評價 · 評論分析(Google 地圖評論等)
分析貼上或上傳的評論文字。面板以 4 個編號步驟引導(1 取得評論 → 2 貼上或上傳 → 3 分析評論 → 4 AI 分析),並有預設展開的「📋 如何取得與上傳評論」說明(含 Google 地圖評論的複製步驟),分析完成後自動收合:
- 「⤓ 下載 Excel / CSV 範本」:欄位為「評論」(必填)、「評分」(1–5,選填),含 UTF-8 BOM 讓 Excel 正確顯示中文;以「範例:」開頭的示範列上傳時自動略過
- 「在 Google 地圖開啟基地位置」(Maps URLs,免金鑰)方便閱讀、摘錄評論
- 貼上:可把 Google 地圖評論列表整段貼上,自動略去作者名稱、「在地嚮導 · N 則評論」、相對時間、按鈕字樣與業主回應;其他文字以空行分隔;行首「★★★★☆」「4/5」「4 顆星」記為星等。亦可上傳 CSV / Excel / TXT
- 本地統計:則數、平均評分與星等分布、19 個景觀 · 健康面向被提及則數(遮蔭、炎熱、綠意、放鬆療癒、步道運動、兒童、座椅、廁所、整潔、維護、安全照明、無障礙、交通停車、聲環境、人潮、蚊蟲、景觀、生態、寵物)、關鍵詞
- AI 分析:環境如何影響使用者(
/api/analyze 的 reviews_analysis 模式,最多 150 則 / 約 3 萬字):Claude 找出提到環境要素(綠蔭、炎熱、水景、聲音、氣味、清潔、設施、步道、照明、人潮、蚊蟲、景觀…)且描述其對使用者影響(舒適、情緒與壓力恢復、安全感、活動行為、社交、可及性)的評論,整理成「環境要素 → 影響 → 正/負 → 代表評論」表格與設計意涵
- 不自動抓取 Google 評論(Places API 需金鑰與帳單,且 Google Maps Platform 條款限制與非 Google 地圖並用、保存評論及以其產生新內容)
熱環境 · 健康研判
樹冠代理(對 3-30-300 的 30% 樹冠目標)× 脆弱族群(高齡 + 幼年比例)→ 綜合高溫脆弱度(低/中/高)。屬研判,非實測。
- 樹冠代理:有 NDVI 結果時採 Sentinel-2 NDVI ≥ 0.6 高植生比例;NDVI 無法取得(雲遮、連線)時退回 OSM 綠覆率(下限估計)。「療癒綠地介入需求」的綠地匱乏因子同此。
- 不採 NDVI ≥ 0.2 的植被覆蓋率:它含草地與稀疏植生,一般街廓多已超過 30%(如臺大校園周邊 500 m 為 80.6%),綠地缺口會失去鑑別力;高植生比例(臺大 28.4%、西門町 0.5%)較接近 30% 樹冠目標的本意。
- 熱環境資料中的
green_input 標示實際採用的來源(ndvi_dense_veg_pct / osm_green_coverage_pct)。
AI 解讀
將上述真實數值送至後端 /api/analyze,由 Claude 產生五段式繁中報告(基地概述 / 開放空間綠地 / 熱環境健康 / 規劃建議 / 資料與限制),嚴格限定只用提供的數值並引用法規。
報告匯出
「匯出 / 列印報告」另開乾淨獨立頁面,可列印或儲存成 PDF(含人口/綠地/熱環境/AI 報告/資料來源)。
架構
三段式:GitHub(原始碼)→ Netlify(部署網站 + 後端代理,保管 API 金鑰)→ Anthropic(Claude)。
┌─ GitHub (cyckaper/la-maps) ────────────────── 原始碼 + 版本控制
│ │ push 觸發自動部署
│ ▼
├─ Netlify ─────────────────────────────────── 部署 · 託管 · 後端
│ ├─ public/ 靜態網站(HTML/CSS/JS、Leaflet 地圖)
│ └─ netlify/functions/analyze.mjs 後端 Function(/api/analyze)
│ 持環境變數 ANTHROPIC_API_KEY,代理呼叫 ↓
│ ▼
└─ Anthropic API (claude-haiku-4-5) ──────────── AI 報告 / 意見摘要
前端另直接呼叫多個免金鑰公開 API(不經後端):
瀏覽器 (public/) 直接取用:
├─ NLSC WMTS 圖磚 / 地質調查所 WMS 底圖與疊圖
├─ public/data/*.json 界線 + 人口(建置時產生)
├─ OSM Overpass 綠地、開放空間服務水準
├─ OSM Nominatim 地名搜尋
├─ Open-Meteo (ERA5) 氣候背景
├─ iNaturalist 生態 · 生物多樣性
├─ Element 84 Earth Search (STAC) Sentinel-2 選景(NDVI)
├─ AWS Open Data sentinel-cogs (S3) Sentinel-2 COG 圖塊(HTTP Range 讀取)
└─ unpkg CDN (SheetJS, geotiff.js) .xlsx 解析、COG 解碼(首次使用時才載入)
- 前端:純靜態(
public/),無框架,vanilla JS。
- 資料:
public/data/{towns,villages,meta}.json 由 scripts/build-data.mjs 於建置時抓取界線 + 戶政人口產生(不進版控)。
- 後端:
netlify/functions/analyze.mjs(Netlify Function),持金鑰呼叫 Claude;金鑰存於 Netlify 環境變數,前端永不外露。AI 呼叫用串流(stream:true)避免 Netlify 閒置逾時(504)。
- 使用者上傳的 Excel 意見:僅存在瀏覽器;唯有按「AI 摘要意見主題」才會把範圍內意見經後端送 Anthropic。
註:repo 內 functions/api/(Cloudflare 格式)為未使用的備援;實際部署只跑 netlify/functions/(見 netlify.toml)。
成本
各節點是否收費、以及「在哪看帳單」:
| 節點 | 收費? | 計費方式 | 哪裡看用量/帳單 |
|---|
| GitHub(公開 repo) | 免費 | — | github.com → Settings → Billing |
| Netlify(託管 + Functions) | 免費額度內 | 免費方案:每月 100 GB 流量、Functions 12.5 萬次呼叫/125 萬次·秒執行;超量才付費 | Netlify → Team → Usage / Billing |
| Anthropic API(Claude) | 是,按用量 | 依 token 計費(輸入 + 輸出),claude-haiku-4-5:約 US$1 / 百萬輸入 token、US$5 / 百萬輸出 token | console.anthropic.com → Usage / Billing(可設用量上限與額度警示) |
| NLSC / 地質所 / Overpass / Nominatim / Open-Meteo / iNaturalist | 免費 | 公開政府/開源服務,免金鑰 | — |
| Element 84 Earth Search / AWS Open Data(Sentinel-2) | 免費 | 公開 STAC 目錄與 S3 公開資料集,免金鑰(流量由 AWS Open Data 計畫負擔) | — |
| unpkg(SheetJS CDN) | 免費 | 公共 CDN | — |
唯一會持續產生費用的是 Anthropic API,其餘在正常使用量下都在免費額度內。
Anthropic 每次大約多少錢?
以本工具的用法估算(claude-haiku-4-5,2026/06 牌價;實際以官方為準):
This is the beginning of the README. Read the rest at the original. Read the full README ↗
