语法图

代码

st_intersection

ST_INTERSECTION函数返回两个geometry对象的交集，返回值为ST_GEOMETRY类型数据。

函数会将geometry对象投射到网格线上进行计算并返回结果。

geometry

通用表达式，其值必须为有效的ST_GEOMETRY类型的数据。

输入的geometry1和geometry2须具有相同的空间参考系标识号（SRID）。

gridsize

gridsize的数据类型为DOUBLE，表示函数计算时使用的网格线大小，省略则默认为-1。

本函数遵守如下规则：

• 当geometry1完全包含在geometry2中时，函数返回geometry1。
• 当geometry1和geometry2均为EMPTY时，函数返回geometry2。
• 当geometry1和geometry2其中一个为EMPTY时，函数返回该空对象类型的EMPTY。
• 当输入的参数存在NULL时，函数返回NULL。
• 当输入的参数中包含Nan时，函数返回错误。
• 支持输入3D坐标，但函数会忽略Z坐标进行计算。

示例（单机HEAP表）

SELECT ST_ASTEXT(ST_INTERSECTION(ST_GEOMFROMTEXT('POLYGON((2 0, 0 2, 0 0, 2 0))'), ST_GEOMFROMTEXT('POLYGON((2 2, 2 0, 0 0, 2 2))')), 0) res FROM DUAL;

RES                                                              
---------------------------------------------------------------- 
POLYGON ((2 0, 0 0, 1 1, 2 0))  

--geometry1完全包含在geometry2中时返回geometry1
SELECT ST_ASTEXT(ST_INTERSECTION(ST_GEOMFROMTEXT('POINT(1 1)'), ST_GEOMFROMTEXT('POLYGON((2 2, 2 0, 0 0, 2 2))')), 0) res FROM DUAL;

RES                                                              
---------------------------------------------------------------- 
POINT (1 1)    

--geometry1和geometry2均为EMPTY时返回geometry2
SELECT ST_ASTEXT(ST_INTERSECTION(ST_GEOMFROMTEXT('POINT EMPTY'), ST_GEOMFROMTEXT('POLYGON EMPTY')), 0) res FROM DUAL;

RES                                                              
---------------------------------------------------------------- 
POLYGON EMPTY  

--geometry1和geometry2其中一个为EMPTY时返回该空对象类型的EMPTY
SELECT ST_ASTEXT(ST_INTERSECTION(ST_GEOMFROMTEXT('POINT EMPTY'), ST_GEOMFROMTEXT('POLYGON((2 2, 2 0, 0 0, 2 2))')), 0) res FROM DUAL;

RES                                                              
---------------------------------------------------------------- 
POINT EMPTY   

--参数中存在NULL时返回NULL
SELECT ST_ASTEXT(ST_INTERSECTION(ST_GEOMFROMTEXT('POLYGON((2 0, 0 2, 0 0, 2 0))'), ST_GEOMFROMTEXT('POLYGON((2 2, 2 0, 0 0, 2 2))'),NULL), 0) res FROM DUAL;

RES                                                              
---------------------------------------------------------------- 
                                                                

SELECT ST_ASTEXT(ST_INTERSECTION(NULL, ST_GEOMFROMTEXT('POLYGON((2 2, 2 0, 0 0, 2 2))')), 0) res FROM DUAL;

RES                                                              
---------------------------------------------------------------- 
 
 
--SRID不同时返回错误
SELECT ST_ASTEXT(ST_INTERSECTION(ST_GEOMFROMTEXT('POLYGON((2 0, 0 2, 0 0, 2 0))',9), ST_GEOMFROMTEXT('POLYGON((2 2, 2 0, 0 0, 2 2))',10)), 0) res FROM DUAL;

YAS-07202 plugin execution error, Operation on mixed SRID geometries: 9 != 10

--参数中含有Nan时返回错误
SELECT ST_ASTEXT(ST_INTERSECTION(ST_GEOMFROMTEXT('POLYGON((2 0, 0 Nan, 0 0, 2 0))'), ST_GEOMFROMTEXT('POLYGON((2 2, 2 0, 0 0, 2 2))')), 0) res FROM DUAL;

YAS-07202 plugin execution error, POLYGON has invalid coordinate