OGR处理Shapefile属性与几何操作

Dr.GIS
wowwwai GIS研习社 · 工具流程与项目排障

OGR 通过内置的 ESRI Shapefile 驱动,可以直接读写 Shapefile 的属性字段与几何对象:属性侧支持字段创建/修改、按条件筛选与 SQL 查询;几何侧在编译了 GEOS 的环境下可做缓冲区、相交、并集、差集以及面积、长度、质心等计算。命令行常用 ogrinfo、ogr2ogr,Python 则用 osgeo.ogr 打开图层后对 Feature 与 Geometry 操作。使用时务必注意字段名最长 10 字符、中文编码(.cpg / SHAPE_ENCODING)以及删除要素后需要 REPACK。若还不熟悉 Shapefile 由 .shp/.shx/.dbf/.prj 等组成的结构,可先看本站的Shapefile文件是什么格式与用什么打开。

Shapefile 属性表与几何缓冲区、相交操作的概念示意

怎么用 OGR 读写 Shapefile 属性

实战里多数需求是:打开已有图层、读字段、按条件筛要素、改属性或加字段。驱动短名为 ESRI Shapefile;目录当作数据集、单个 .shp 当作图层即可。只读用打开模式 0,可写用 1。

Python 典型流程如下(需本机已装带 Python 绑定的 GDAL/OGR,并以官网或发行版为准):

  1. 用 ogr.GetDriverByName(“ESRI Shapefile”) 取驱动,再 Open(path, 0) 或 gdal.OpenEx 打开。
  2. ds.GetLayer() 取图层;遍历 Feature,用 GetField(“字段名”) 或 items() 读属性,用 GetGeometryRef() 取几何。
  3. 需要写属性时以可写模式打开,对 Feature 调用 SetField 后 layer.SetFeature(feat)。
  4. 新增字段:先构造 ogr.FieldDefn(类型 Integer / Integer64 / Real / String / Date),再 layer.CreateField。
  5. 条件筛选可用 layer.SetAttributeFilter(“POP > 10000”),或对数据源执行 OGR SQL。

命令行快速摸底可用 ogrinfo -al -so your.shp 看图层摘要与字段;带条件导出可用 ogr2ogr 的 -where 或 -sql。属性侧支持的类型没有 DateTime、列表、二进制;默认 String 宽度约 80、Integer 约 9,过长会按 .dbf 规则截断,必要时可用 SQL RESIZE 优化宽度。详细打开选项与限制以GDAL 官方 Shapefile 驱动文档为准。

  • 字段名最长 10 个字符,超长会被截断并加序号保证唯一。
  • .dbf 至少要有一个字段,否则驱动可能自动补 FID。
  • 删除要素时 .dbf 多为标记删除;要永久清除并重编号 FID,需 REPACK 表名(关闭或 FlushCache 时也可能自动做)。
  • 改几何或删要素后范围可能不准,可用 RECOMPUTE EXTENT ON 表名。

几何操作怎么做:缓冲区、相交与量测

拿到 Feature 的 Geometry 后,常用方法都在 OGRGeometry 上:空间关系判断(Intersects、Within、Contains 等)、构造运算(Buffer、Intersection、Union、Difference、SymDifference)、量测(Area、Length、Distance、Centroid)以及坐标系变换(Transform / TransformTo)。高级运算依赖 GEOS;没有 GEOS 时往往会失败,或退化成简单的外包矩形判断,验收前先确认你的 GDAL 构建带了 GEOS(Conda、多数发行版包一般自带)。

GDAL 官方 ESRI Shapefile 驱动说明页截图
GDAL 官方 ESRI Shapefile 驱动说明页截图(截图来源:gdal.org)

可执行示例思路(Python):

  1. 读入图层 A、B 的要素几何 g1、g2。
  2. 缓冲区:buf = g1.Buffer(距离)(默认约 30 个象限分段,距离单位与图层 CRS 一致)。
  3. 相交/裁剪:inter = g1.Intersection(g2);为空则说明不相交。
  4. 面积/长度:面要素 g1.GetArea(),线要素用 Length(曲面求和等行为以当前版本 API 为准)。
  5. 写出结果:新建目标 Shapefile 图层,把结果 Geometry 设到新 Feature 上并 CreateFeature。

注意 CRS:Buffer、面积在地理坐标系(度)下数值没有工程意义,应先投影到合适的平面坐标系再算。Transform 需要 PROJ 与正确的 .prj / 空间参考。若要把处理完的 Shapefile 入库,可接着用本站整理的PostGIS 导入 Shapefile 常用命令做后续步骤。

操作类型 典型方法 依赖与注意
空间关系 Intersects / Within / Contains / Touches 等 建议有 GEOS;否则结果可能不可靠
缓冲区 Buffer(distance) 单位随 CRS;距离过大或自相交需检查结果有效性
叠加分析 Intersection / Union / Difference 需 GEOS;空几何要单独判断
量测 Area / Length / Distance / Centroid 投影坐标下才有可解释的米制结果
坐标变换 Transform / TransformTo 依赖 PROJ;目标 SRS 要事先定义好

编码、字段限制和打开选项要注意什么

国内数据最容易踩坑的是中文乱码与字段名截断。驱动优先读 .cpg,否则回退 .dbf 的 LDID;读写时往往会转到 UTF-8。可用配置项 SHAPE_ENCODING(或打开选项 ENCODING)覆盖,例如设为 GBK;设为空字符串可禁用重编码,有时对“已经是目标编码”的文件更稳。路径含中文时,常配合 GDAL_FILENAME_IS_UTF8=YES。创建图层还可指定 ENCODING、SHPT 几何类型、是否建空间索引等。

  • PROMOTE_TO_MULTI 等打开选项会影响线/面是按单部件还是 Multi 报告,行为以你安装的版本说明为准;不确定时用 ogrinfo 看实际几何类型。
  • 空间索引可用 .qix(SQL CREATE SPATIAL INDEX 或 shptree);属性索引能力有限,适合加速等值查询。
  • .shp 实现上常见约 4GB 上限;需要更严兼容时可考虑 2GB_LIMIT 相关选项。压缩形态如 .shz / .shp.zip 在较新版本中支持,以当前驱动文档为准。
  • 截至 2026 年 11 月,官方稳定版可见 GDAL/OGR 3.13.3(约 2026-08 发布的 bugfix);具体能力以本机 gdalinfo –version 与驱动页为准。

批量改属性、批量裁剪时,OGR 适合脚本化;若你更熟 ArcGIS 生态,也可以对照本站用 ArcPy 批量处理多个 Shapefile的流程,把同一套验收标准迁过来。

常见报错与验收标准

动手时按“先能读、再能筛、再能写、最后能量测”验收,比一次写很长脚本更稳。

  1. 打开失败 / 找不到图层:检查同目录是否缺 .shx/.dbf;路径与权限;驱动名是否写成 ESRI Shapefile。
  2. 中文属性乱码:确认 .cpg 内容;试验 SHAPE_ENCODING=GBK 或空字符串;用 ogrinfo 打印字段值核对。
  3. CreateField 后看不见或写入被截断:字段名是否超过 10 字符;String 宽度是否不够;是否未 Flush/关闭数据源。
  4. Buffer/Intersection 报错或返回空:确认 GEOS;输入是否有效几何(自相交、空点);CRS 单位是否搞错。
  5. 删除后文件没变小 / FID 不连续:执行 REPACK;必要时 RECOMPUTE EXTENT。

验收建议:用 ogrinfo 对比处理前后要素数、字段类型与样例属性;对几何结果抽查 Intersects/面积是否合理;把输出再打开一次确认无损坏。需要官方选项全集与版本差异时,以Shapefile 驱动说明和本机版本为准,不要凭记忆硬套旧教程。

常见问题

没有 GEOS 还能做几何运算吗?

简单读取、写属性、部分基于外包矩形的判断可能仍可用,但 Buffer、Intersection、Union 等高级运算通常会失败或结果不可信。请改用带 GEOS 的 GDAL 包(如常见 Conda-forge 构建),再用一小段 Buffer 脚本验证。

字段名超过 10 个字符怎么办?

Shapefile/.dbf 硬限制就是约 10 字符,驱动会截断并可能加序号。业务上应事先规划短字段名,或把长字段映射表另存;若必须保留长名与别名,需考虑 GeoPackage 等其他格式,而不是强行挤进 Shapefile。

中文路径下 Python 打开失败怎么处理?

先设 GDAL_FILENAME_IS_UTF8=YES,并确认进程工作目录与实际路径编码一致;同时用 SHAPE_ENCODING 处理属性编码。仍失败时,把数据临时拷到纯英文短路径做对照实验,区分是路径问题还是文件本身损坏。

改完属性或删了要素,为什么别的软件里还是旧的?

确保以可写模式打开且调用了 SetFeature/DeleteFeature,并关闭数据源或 FlushCache;删除后执行 REPACK。另外检查是否看错了输出路径,或对方软件缓存了旧图层。

OGR 处理 Shapefile 时,把属性读写、编码与 10 字符字段限制先理顺,再在带 GEOS 的环境下做缓冲区与叠加,并用 ogrinfo 做前后对照,一般就能稳定落地。建议:投影坐标下再做 Buffer/面积;每次批量写盘后固定做一次打开抽查与 REPACK。需要把结果入库时,直接衔接 PostGIS 导入流程即可。