核心用法
geoskill-interactive-webgis 是一款纯前端 WebGIS 生成工具，通过命令行调用即可产出自包含的 HTML 地图应用。用户可通过 --bbox 指定地理范围、使用 --synthetic 生成模拟数据、或导入本地 GeoJSON/GeoTIFF 进行可视化。核心功能包括：双线性插值点查询（query_value_at）、最近邻高程查询、六类属性运算符筛选（gt/lt/ge/le/eq/contains）、点密度栅格聚合，以及图层开关面板控制。输出物为独立的 webgis.html，内嵌所有栅格与配置数据，双击即可在浏览器中运行。
显著优点
完全离线运行：--synthetic 模式无需网络连接，所有计算在本地完成，从根本上杜绝数据泄露风险，特别适用于涉密或合规要求严格的场景。零后端架构：无需部署 Node.js、Python 服务器或数据库，降低运维复杂度，生成文件可直接邮件发送或静态托管。轻量可移植：单 HTML 文件封装全部依赖，兼容主流浏览器，甚至在无网络的内网环境也能正常展示。算法可验证：输出 webgis_data.json 与 output-manifest.json，支持结果审计与单元测试回溯。灵活的查询能力：属性查询引擎支持数值比较与字符串包含匹配，满足常见空间数据分析需求。
潜在缺点与局限性
性能天花板：浏览器端 JavaScript 处理大尺度栅格（如 GB 级 GeoTIFF）时可能触发内存限制，降采样策略会损失精度。功能边界：仅支持 2D 可视化，无三维地形、动态时间轴、实时数据流等高级 GIS 特性。交互深度有限：点击查询基于预计算栅格，不支持复杂空间分析（如缓冲区、叠加分析）。样式定制受限：颜色、标题等参数可通过 CLI 调整，但深度 UI 定制需手动修改生成代码。依赖生态：后端 Python 依赖 NumPy、GeoPandas 等科学计算库，环境配置对非技术用户存在门槛。
适合的目标群体
- 数据隐私敏感型团队：政府机构、科研院所、医疗健康领域，需在本地完成敏感地理数据的可视化与初步分析。
- 快速原型开发者：产品经理、GIS 工程师需要快速验证空间数据展示方案，无需等待后端排期。
- 离线场景用户：野外考察、展会演示、内网环境等无稳定网络条件下的地图展示需求。
- 教学与培训：地理信息科学课程中用于演示 WebGIS 原理，学生可直接查看生成源码。
常规使用风险
性能风险：生成高密度栅格或大量 POI 时，浏览器渲染可能卡顿，建议控制单次生成点数在 5000 以内，栅格分辨率不超过 1024×1024。依赖版本冲突：rasterio 与系统 GDAL 绑定可能存在兼容性 issues，推荐使用 Conda 环境隔离。数据一致性：--synthetic 生成的模拟数据虽"物理一致"，但非真实世界观测值，直接用于科研结论需谨慎标注。浏览器兼容性：Leaflet 对 IE11 支持已逐步弃用，目标用户群体若存在老旧浏览器需提前验证。文件体积膨胀：内嵌栅格 JSON 会使 HTML 体积显著增大，超大区域建议分块生成或采用外部切片方案。