用途:Shapely 是用于平面几何对象操作与分析的 Python 库,基于 GEOS,适合在 Python 中处理二维矢量几何的创建、测量、空间关系查询与集合运算。
主要能力:支持 Point、LineString、LinearRing、Polygon、MultiPoint、MultiLineString、MultiPolygon、GeometryCollection 等几何类型;提供构造性操作(buffer、centroid、convex_hull、simplify、voronoi_polygons、delaunay_triangles 等)、空间谓词(contains、intersects、within、touches、relate 等)、集合运算(intersection、union、difference、symmetric_difference 及 N 元版本)、测量(area、length、distance、hausdorff_distance、bounds 等)、STRtree 空间索引、仿射变换、线性参考、坐标变换与有效性校验。
使用方式:提供函数式(向量化、支持 NumPy 广播)与面向对象两套 API,函数式适合数组与性能场景,OOP 适合标量便捷调用;支持运算符重载(&、|、-、^)。可从坐标、WKT、WKB、GeoJSON、GeoArrow ragged 数组及 geo_interface 字典创建或序列化几何。
适用场景:点面判断、批量并集、空间连接、坐标投影(可配合 pyproj)、几何修复与简化等。
限制:所有空间分析忽略 Z 坐标,仅在 x-y 平面进行;contains 不含边界;set_coordinates 会原地修改;clip_by_rect 可能产生无效拓扑;WKB 序列化会丢失 LinearRing;to_geojson 丢弃 Z;OOP 与函数式 buffer 默认参数不同;set_precision 会改变顶点顺序;部分功能需 GEOS >= 3.11 或 3.12。要求 Python >= 3.11、GEOS >= 3.10、NumPy >= 1.23,许可证 BSD-3-Clause。