geojson

核心用法

geojson 是一个专注于 GeoJSON 数据只读分析的轻量级技能，无需重型 GIS 软件即可快速完成结构验证与统计摘要。

主要功能

• 结构验证：检查 JSON 是否符合 GeoJSON 规范（FeatureCollection、Feature、Geometry 层级）
• 内容摘要：统计要素数量、几何类型分布（Point/LineString/Polygon 等）
• 边界框计算：自动从坐标推算 bbox
• 坐标审查：标记经度/纬度范围异常（如 >180° 或颠倒顺序）、提示 lon,lat vs lat,lon 混淆风险
• CRS 安全提示：说明 EPSG:4326 假设的适用场景与局限

显著优点

• 零配置依赖：仅需 Python3，无需 QGIS/PostGIS 等重型环境
• 快速反馈：秒级完成大文件扫描，适合 CI/CD 数据管道前置检查
• 安全只读：明确承诺不修改源数据，降低误操作风险
• 多输入形式：支持文件路径或内联 JSON 字符串

潜在局限与风险

| 局限 | 说明 |

|------|------|

| 非确定性处理 | 明确排除重投影、裁剪、格式转换等操作，此类需求需转交 `qgis` |

| CRS 推断有限 | 现代 GeoJSON 通常无 CRS 元数据，工具仅基于坐标范围启发式提示，无法保证坐标系正确性 |

| 无空间运算 | 不支持面积、距离、拓扑关系计算 |

| 解析容错边界 | 对"能解析但结构可疑"的数据仅做标记，不强制阻断 |

适合人群

• 数据工程师：CI 流程中快速验证上游 GeoJSON 交付物
• 前端开发者：调试地图可视化前的数据预检
• 数据分析师：快速了解陌生数据集的空间范围与规模
• GIS 从业者：批量文件初步筛查，再决定是否需要专业工具深入处理

常规风险

• 坐标顺序误判：GeoJSON 规范为 [lon, lat]，但部分数据源（如某些 Web API）习惯颠倒，工具提供启发式警告但非绝对判定
• 隐式 WGS84 假设：RFC 7946 默认 CRS 为 WGS84，但历史文件或特定领域数据可能偏离，高精度场景需人工核实
• 大文件性能：极大量坐标点可能导致 Python 内存峰值，建议分块处理或转专业 GIS 工具

与相关技能的分工

| 场景 | 推荐技能 |

|------|---------|

| 结构检查、快速预览 | **geojson**（本技能） |

| 重投影、裁剪、格式转换 | `qgis` |

| 坐标转地址/逆地理编码 | `geocode` |

| WGS84 专项 CRS 论证 | `wgs84` |

| CesiumJS 渲染逻辑 | `cesium` |

核心用法

该Skill专注于GeoJSON文件的安全只读分析，提供三大核心功能：一是结构验证，检测JSON是否符合GeoJSON规范，识别FeatureCollection完整性、缺失geometry字段、坐标嵌套错误等常见问题；二是摘要统计，自动计算顶层类型、要素数量、几何类型分布及边界框（bbox）；三是坐标安全审查，标记经纬度范围异常（超出±180/±90度）、坐标顺序混淆（lat/lon vs lon/lat）等潜在风险。支持文件路径和行内JSON两种输入模式，通过统一的geojson_tool.py脚本接口调用。

显著优点

安全零依赖：完全基于Python标准库实现，无第三方包引入，从根本上杜绝供应链攻击风险。完全离线运行：无任何网络请求、API调用或数据传输，适用于敏感数据处理场景。精准边界判定：内置决策规则明确区分本Skill与qgis、geocode、wgs84等相邻技能的职责边界，避免功能滥用。CRS安全意识：主动提示GeoJSON规范中CRS元数据缺失的现状，引导用户关注坐标参考系假设的合理性。

潜在缺点与局限性

只读限制明确：无法进行任何编辑、转换、重投影或裁剪操作，复杂GIS处理需移交qgis。无空间分析能力：不支持距离、面积计算等需投影变换的测量操作。依赖人工判断：坐标异常标记基于启发式规则（如数值范围），最终CRS确认仍需结合数据来源上下文。T3来源信任度：由个人开发者维护，虽经CLS认证无恶意代码，但长期维护持续性存在不确定性。

适合的目标群体

GIS数据工程师：快速批量验证GeoJSON数据质量，排查上游数据生产问题。前端地图开发者：调试Cesium/Leaflet等库加载失败的GeoJSON源文件。数据科学家：在导入空间数据前进行轻量级预处理检查。安全敏感场景用户：需在完全隔离网络环境下处理位置数据的政府、金融机构从业者。

常规使用风险

性能风险：超大GeoJSON文件（>100MB）的完整解析可能占用较多内存，建议分块处理或改用流式工具。误报风险：非WGS84坐标系的数据可能触发"坐标范围异常"警告，需结合source_credibility上下文解读。版本兼容：遵循RFC 7946标准，但旧版GeoJSON（2008版）的CRS成员处理可能产生歧义。技能边界误用：用户可能期望本Skill执行编辑操作，需严格遵循"When Not To Use"指引切换至qgis。