官方文档
概述
geometry ST_ClipByBox2D(geometry geom, box2d box);
描述
以快速且宽松但可能无效的方式通过 2D 框剪切几何体。 拓扑上无效的输入几何图形不会导致抛出异常。 不保证输出几何图形有效（特别是，可能会引入多边形的自相交）。
这个函数是由 GEOS 模块执行的。
可用性：2.2.0
示例
-- Rely on implicit cast from geometry to box2d for the second parameter SELECT ST_ClipByBox2D(geom, ST_MakeEnvelope(0,0,10,10)) FROM mytab;
解读：
有2个参数，第1个是目标几何对象数据，第2个是裁剪框。返回裁剪内容(相交部分)。
需要注意的是，返回结果不保证输出几何图形有效。
裁剪框三种情况：
- 裁剪框是点：返回NULL数据。因为点不构成最小矩阵。
- 裁剪框是线：把线转换成最小矩阵，然后对比目标数据进行裁剪。
- 裁剪框是多边形：可直接对比目标数据进行裁剪
返回值有三种
- NULL—裁剪框是点
- 空值—没有相交部分
- 几何对象—相交的部分
我画了张图，应该就比较清晰了。
举例说明
SELECT ST_GeomFromText('POLYGON ((1 3,2 4,4 4,4 3,1 3))',4326) as "裁剪框",
'POLYGON ((1 5, 5 5, 5 1, 1 1, 1 5))'::geometry as "数据库数据",
ST_ClipByBox2D('POLYGON ((1 5, 5 5, 5 1, 1 1, 1 5))'::geometry, ST_GeomFromText('POLYGON ((1 3,2 4,4 4,4 3,1 3))',4326)) as "相交部分"
1、裁剪框
2、目标数据
3、裁剪数据(相交)
通过三张图可以发现，图1和图2是箱体里面，因为图1在图2中是个长方形，图2就是相交数据。
此功能类似arcgis的裁剪功能，比arcgis裁剪弱一些，因为看不到属性信息。
