geopandas

geopandas 技能概览

geopandas 适合做什么

geopandas 技能用于 Python 地理空间矢量数据处理：读取 shapefile、GeoJSON、GeoPackage 和其他地理文件；分析几何对象；以及生成可直接用于制图的输出。它非常适合空间连接、缓冲区、裁剪、边界融合、坐标转换，以及需要位置因素参与的 geopandas for Data Analysis 任务。

谁应该使用它

如果你需要把原始地理空间文件转成分析结果，而不只是把点画在地图上，就应该使用这个 geopandas 技能。它尤其适合分析师、数据科学家，以及需要一份实用 geopandas guide 来在 Python 中清洗、连接和汇总地理数据的自动化代理。

它有什么不同

geopandas 在 pandas 之上扩展了几何感知操作，因此你可以用熟悉的表格思路处理空间数据集。它的核心价值在于工作流更快：加载矢量数据、检查坐标参考系、执行空间操作，然后导出结果，不必为每一步都拼接不同工具。

如何使用 geopandas 技能

正确安装 geopandas

进行基础的 geopandas install 时，请使用技能中展示的包管理方式，然后确认环境里已经具备关键的地理空间依赖。如果你计划读写文件或使用空间索引，请在开始大任务之前先确认你的 Python 环境能够处理底层原生库栈。

提供合适的输入

高质量的提示词要给 geopandas 三样东西：文件格式、分析目标和空间约束。例如：“加载一个零售门店的 GeoJSON，重投影到 EPSG:3857，每个门店缓冲 500 米，与 census tracts 求交，并按 tract 汇总数量。” 这比“分析这份地图数据”要好得多，因为它明确告诉技能期望的几何类型、投影和输出。

按这个顺序从仓库开始读

先读 SKILL.md，再看安装和快速开始部分，然后再尝试真实工作流。如果仓库里有可选依赖说明，请先确认，再去假设交互式地图、PostGIS 访问或制图底图之类的功能一定能在你的环境中运行。对于 geopandas 技能来说，这些依赖选择往往决定了一个工作流是顺利成功，还是最后才失败。

更容易产出好结果的工作流

采用一个简短计划：确认输入格式，确认 CRS，选择空间操作，定义输出表或文件。如果任务涉及连接或叠加，请明确哪个数据集是目标，以及未匹配记录应如何处理。如果需要制图，请说明结果应是静态图、交互式图，还是要导出给其他工具使用。

geopandas 技能常见问题

geopandas 只是用来做地图的吗？

不是。geopandas 的核心价值是对矢量数据做空间分析，而不仅仅是可视化。即使你从不渲染地图，也可以用它做连接、叠加、面积计算、重投影和数据增强。

什么时候不该用 geopandas？

如果是重度栅格处理、Web 地图库开发，或者工作流基本是纯 SQL 且已经运行在 PostGIS 中，就不建议用它。如果任务只是普通表格处理，而位置只是附带信息，那么标准 pandas 提示词可能比 geopandas skill 工作流更简单。

它适合新手吗？

适合——前提是你已经理解基本的 pandas 概念，并且能确定输入文件和期望输出。真正的阻碍通常不是语法，而是地理空间细节，比如 CRS 不匹配、几何无效，或者距离和面积使用了错误的单位。

它和通用提示词相比有什么区别？

通用提示词可以讲清思路，但当任务需要正确的地理空间操作和文件处理时，geopandas 更合适。这个技能最有价值的场景是：提示词必须在多个步骤中保留几何、投影和空间逻辑。

如何改进 geopandas 技能

明确说明 CRS 和单位

geopandas 工作中最常见的质量问题，是在错误的坐标系里测距离或面积。请明确写出源 CRS、目标 CRS，以及距离单位应该是米、千米还是度。如果你不知道 CRS，也要直接说明，并要求一个安全的检测与重投影流程。

提供几何和连接规则

如果任务包含空间连接或叠加，请说明什么算匹配，以及没有重叠时要保留什么。例如：“保留所有 parks，附加它们与之相交面积最大的 census tract，并将未匹配的 parks 留空。” 这种提示能给出更明确的 geopandas usage 指令，避免输出含糊不清。

给出小样本和预期输出

最好的 geopandas guide 输入会包含几个有代表性的列名、一个示例几何类型，以及最终结果的形状。例如：“输入有 id、name 和 geometry；输出应为每个 county 一行，包含 total incident count 和 average parcel area。” 这类提示比笼统请求更容易被准确执行。

在第一次结果后继续迭代

如果第一次答案已经接近但还不对，就每次只改一个变量：投影、缓冲区大小、融合键、连接谓词或导出格式。geopandas 出错时，通常是因为漏掉了某个前提；最快的修复方式不是要求更大范围的重写，而是把那个前提直接重新说清楚。